# Dxplaination of the ad data analysis interface

Open data interfaces to all Service Account, Weixin Mini Program, MiniGame developers who become traffic masters.Through the data interface, developers can access data similar to, but more flexible, statistical modules on the public platform's official website, and can perform advanced processing as needed.

Please note:

1. The interface-side database only stores data after January 1, 2016, and previous data will not be retrieved, and even if it is found, it will be untrusted and dirty;

2. It is recommended that developers save the data in their own databases after calling the interface to obtain the data, to maximize the efficiency of access and also to reduce unnecessary losses from the WeChat side interface calls.

3. Due to the large amount of data, all interfaces take a page-by-page approach, with a maximum page acquisition of 90.(eg: total_num is 100, then when page = 1, page_size = 10, the first 10 entries are returned;)Page = 1, page_size = 20, then the first 20 entries are returned;Page = 2, page_size = 10, then return articles 11 to 20)

4. Instructions for changing the ad space enumeration value

   • Since multiple interfaces use ad space parameters, to ensure consistency of the experience and readability of the parameters,We made some changes so that all the interfaces support the ad-slot type name (ad_slot) and passing parameters, adding this name to represent the relevant meaning when repackaging.The previous parameter slot_id can also be used and passed back. Specifically:

# Interface Overview

The ad data analysis interface is currently available to obtain some of the ad data shown on the Public Platform → Traffic Owners → Data Statistics page and some of the revenue data shown in the Public Platform > Traffic owners → Financial Management page. The list of interfaces associated with Service Account is as follows:

# Dxplaination of Interface Call Request

# 1. Get Service Account Subdivision advertising data (publisher_adpos_general)

You need to add the following GET request parameters to the appropriate interface call address:

Note: If you do not pass the advertising type name, the default will return data for all types of advertising (except for rebate commercial advertising).

Returns parameter explaination (publisher_adpos_general)

Return packet example (publisher_adpos_general)

{
    "base_resp":{
        "err_msg":"ok",
        "ret":0
    },
    "list":[
        {
            "slot_id":3030046789020061,
            "ad_slot":"SLOT_ID_WEAPP_INTERSTITIAL",
            "date":"2020-04-13",
            "req_succ_count":443610,
            "exposure_count":181814,
            "exposure_rate":0.409850995,
            "click_count":10095,
            "click_rate":0.055523777,
            "income":52175,
            "ecpm":286.969100289
        }
    ],
    "summary":{
        "req_succ_count":4406394,
        "exposure_count":1797225,
        "exposure_rate":0.407867522,
        "click_count":100167,
        "click_rate":0.055734257,
        "income":578003,
        "ecpm":321.608591022
    },
    "total_num":1
}

# II. Get Service Account Rebate Product Data (publisher_cps_general)

You need to add the following GET request parameters to the appropriate interface call address:

Please note: Rebate commercial advertising does not need to pass advertising parameters.

Returns a parameter explaination (publisher_cps_general)

Return packet example (publisher_cps_general)

{
    "base_resp":{
        "err_msg":"ok",
        "ret":0
    },
    "list":[
        {
            "date":"20XX-XX-XX",
            "exposure_count":15153,
            "click_count":396,
            "click_rate":38.265151515,
            "order_count":3,
            "order_rate":0.007575758,
            "total_fee":162900,
            "total_commission":25021
        }
    ],
    "summary":{
        "exposure_count":117143,
        "click_count":3442,
        "click_rate":34.033410808,
        "order_count":18,
        "order_rate":0.005229518,
        "total_fee":924082,
        "total_commission":133030
    },
    "total_num":7
}

# III. Obtaining Service Account settlement income data and settlement entity information (publisher_settlement)

You need to add the following GET request parameters to the appropriate interface call address:

Please note: As long as it coincides with the start and end of the data obtained, the data corresponding to the settlement interval will be returned.For example, a request for data from 11 February to 26 March would return data from the four clearing areas for the first half of February, the second half of January, and the first half and second half of March.

Returns parameter explaination (publisher_settlement)

Return packet example (publisher_settlement)

{
    "base_resp":{
        "err_msg":"ok",
        "ret":0
    },
    "body":"深圳市腾讯计算机系统有限公司",
    "penalty_all":0,
    "revenue_all":5178368698,
    "settled_revenue_all":2613696765,
    "settlement_list":[
        {
            "date":"2020-03-25",
            "zone":"2020年3月1日至15日"
            "month":"202003",
            "order":1,
            "sett_status":1,
            "settled_revenue":718926045,
            "sett_no":"XXX",
            "mail_send_cnt":"0",
            "slot_revenue":[
                {
                    "slot_id":"SLOT_ID_WEAPP_BANNER",
                    "slot_settled_revenue":34139443
                },
                {
                    "slot_id":"SLOT_ID_WEAPP_REWARD_VIDEO",
                    "slot_settled_revenue":684786602
                }
            ]
        }
    ],
    "total_num":1
}

# Error code explaination