# Get Mini Program Ad Summary Data

Interface should be called on the server side, seeHattori API。

# Interface Dxplaination

# Interface name

GetAdposGenenral

# Functional description

this API Used to obtain aggregate data for Mini Program ads. If you encounter problems during use, you canOpen Platform Service Provider Zone Exchange Zone | WeChat Open CommunityPosting exchanges.

# Note

Where access_Token forauthorizer_access_Token

# Calling mode

# HTTPS call


POST https://api.weixin.qq.com/wxa/operationams?action=agency_get_adpos_genenral&access_token=xxxxxxxxxxxxxxx

# Request parameters

attribute	type	Required	Introductions
page	number	yes	Return to Page Number of Data
page_size	number	yes	When the page returns the number of data bars
start_date	string	yes	Start time to get data yyyy-mm-dd
end_date	string	yes	End time to get data yyyy-mm-dd
ad_slot	string	no	Ad Space Type Name

# Return parameters

attribute

type

Introductions

ret

number

Error code

err_msg

string

Return error message

list

array

list

attribute	type	Introductions
slot_id	number	Type id
ad_slot	string	Ad Space Type Name
date	string	date
req_Stn_count	number	Pull number
exposure_count	number	Exposure
exposure_rate	number	Exposure
click_count	number	Number of clicks
click_rate	number	click-through rate
publisher_初始值	number	Split Revenue for Small Programs(Cent)
ecpm	number	Advertising revenue per thousand exposures(Cent)

summary

array

summary

attribute	type	Introductions
req_Stn_count	number	Total drawback
exposure_count	number	Total exposure
exposure_rate	number	Total exposure
click_count	number	Total Hits
click_rate	number	Total click rate
publisher_income	number	Small Program Total Revenue(Cent)
ecpm	number	Advertising revenue per thousand exposures(Cent)

total_num

number

List returns the total number of bars

# Other Notes

1, return the list of records in descending order according to date, slot_Id in ascending order, the user should obtain it in the form of pagination. If you do not pass the ad space type name, data for all types of ad space will be returned by default.

2, request parameters, page_There is no upper limit to the size, but it is recommended that the service provider estimates the size of the data after paging.

# Call Example

Example Dxplaination: HTTPS requests

# Sample Request Data


{
    "page": 1,
    "page_size": 8,
    "start_date": "2020-04-13",
    "end_date":"2020-04-13"
    "ad_slot": "SLOT_ID_WEAPP_INTERSTITIAL"
}

# Return Data Example


{
    "base_Responsive:
        "err_msg":"OK"
        "right": 0
    },
    "list":[
        {
            "slot_id":3030046789020061,
            "ad_slot":"SLOT_ID_WEAPP_INTERSTITIAL",
            "date":"2020-04-13",
            "req_Stn_count":443610,
            "exposure_count":181814,
            "exposure_rate":0.409850995,
            "click_count":10095,
            "click_rate":0.055523777,
            "publisher_income":52175,
            "ecpm":286.969100289
        }
    ],
    "summary":{
        "req_Stn_count":4406394,
        "exposure_count":1797225,
        "exposure_rate":0.407867522,
        "click_count":100167,
        "click_rate":0.055734257,
        "publisher_income":578003,
        "ecpm":321.608591022
    },
    "total_number: 1
}

# Error code

Error code	Error code	Solutions
0	ok	ok
-202	Internal error	Can be retried after some time
1700	Parameter error	Verify that the input parameters conform to the documentation
1701	Parameter error	Verify that the input parameters conform to the documentation
1735	The merchant has not completed the agreement signing process	Complete the signing operation
1737	Operating too fast	Wait a minute and reoperate
1807	Invalid Flow Master	Turn on the traffic master for this appid through the turn on traffic master interface
2009	Invalid Flow Master	Turn on the traffic master for this appid through the turn on traffic master interface
2056	The service provider does not open an account in the cash area	Launch services in the monetization area of the third-party platform page