广告预览
本节将为您介绍如何通过 Marketing API 进行广告预览。
广告投放完后,Marketing API提供广告预览接口,支持在广告投放期间预览真实的投放效果,广告预览为真实的广告曝光,但不收取费用,目前仅支持朋友圈广告预览。
广告预览接口为adcreative_previews/add,您可以通过该接口对朋友圈推广计划发起预览,并指定预览受众的微信号。
请求示例
curl 'https://api.e.qq.com/v1.1/adcreative_previews/add?access_token=<ACCESS_TOKEN>×tamp=<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>×tamp=<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
}
]
}
}