# Get Mini Program Ad Segmentation Data

Interface should be called on the server side, seeHattori API

# Interface Dxplaination

# Interface name

GetAdposDetail

# Functional description

this API Used to obtain the Mini Program ad segmentation data. 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_adunit_general&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
ad_unit_id string no Ad Unit ID

# Return parameters

attribute typeIntroductions
ret number Error code
err_msg string Error message
list array list
attribute type Introductions
ad_unit_id string Ad Unit ID
ad_unit_name string Name of advertisement
stat_item array stat_item
attribute type Introductions
ad_slot string Ad Space Type Name
date string Date of data
req_Stn_count number Drawback
exposure_count number Exposure
exposure_rate number Exposure
click_count number Number of clicks
click_rate number click-through rate
publisher_income number Split Revenue for Small Programs(Cent)
ecpm number Advertising revenue per thousand exposures(Cent)
total_num number Request Return Total

# Other Notes

1, return the items in the list in descending order by date, the user please get in the form of pagination. When it is necessary to obtain the segmentation data of all advertising bits, it is not necessary to pass the type name of advertising bits and the ad unit IDWhen you need to get segmentation data for a certain type of ad space, just pass the ad space type nameWhen you need an advertisement. id Only the ad unit ID needs to be passed when segmenting data for the.

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-10",
    "end_date": "2020-04-10",
    "ad_unit_id": "adnit-9cedd8514XXXX"
} 

# Return Data Example


{
    "base_Responsive:
        "err_msg":"OK"
        "right": 0
    },
    "list":[
        {
            "ad_unit_id":"adnit-9cedd8514XXXX"
            "ad_unit_Name ":" Incentive Video Long Ad, "
            "stat_item:{
                "ad_slot":"SLOT_ID_WEAPP_REWARD_初始值
                "date":"2020-04-10",
                "req_Stn_count":138250,
                "exposure_count":74771,
                "exposure_rate":0.54083906,
                "click_count":2242,
                "click_rate":0.029984887,
                "publisher_income":93883,
                "ecpm":6.790813743
            }
        }
    ],
    "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