接口文档SDK业务专题开发者工具

广告预览

本节将为您介绍如何通过 Marketing API 进行广告预览。

广告投放完后,Marketing API提供广告预览接口,支持在广告投放期间预览真实的投放效果,广告预览为真实的广告曝光,但不收取费用,目前仅支持朋友圈广告预览。

广告预览接口为adcreative_previews/add,您可以通过该接口对朋友圈推广计划发起预览,并指定预览受众的微信号。

请求示例


curl 'https://api.e.qq.com/v1.1/adcreative_previews/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'adgroup_id=<ADGROUP_ID>' \
-d 'campaign_id=<CAMPAIGN_ID>' \
-d 'user_id_type=USER_ID_TYPE_WECHAT_ID' \
-d 'user_id_list=[1324657]' 
					

特别说明,朋友圈的广告预览有如下条件:

    • 预览受众需已关注绑定的微信公众号;
    • 1个推广计划最多允许输入50个微信ID(1个微信ID重复输入也只算是一次),如对同一个推广计划多次操作表示追加;
    • 预览推广计划的投放时间段还未结束(考虑end_date以及time_series,比如一条广告投放日期为2/1-2/7,且投放时间段为每天的10:00~17:00,则在2/7 17:00后无法再提交预览申请);
    • 广告上线之后,配置的受众才能收到广告,如配置了多条,则是随机拉取,广告预览后即失效。

同时,还为您提供了获取预览受众信息接口,可以通过推广计划查询之前提交的受众信息。

请求示例


curl -G 'https://api.e.qq.com/v1.1/adcreative_previews/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"campaign_id ","operator":"EQUALS","values":["<CAMPAIGN_ID>"]}]' 
					

应答示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "list": [
            {
                "user_id": "<USER_ID>",
                "duration": 5
            }
        ]
    }
}