入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

广告预览

本节将为您介绍如何通过 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_ch": "",
    "data": {
        "list": [
            {
                "user_id": "<USER_ID>",
                "duration": 5
            }
        ]
    }
}