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

广告人群

使用广告人群(AD AUDIENCE)可以提取和您的广告有过互动的人群。

       支持提取广告曝光行为、广告点击行为或广告转化行为(应用开始下载、应用完成下载、激活应用、安装应用)人群,您可以选择想要提取的广告计划、广告或标的物,至多只能填写一个,若您不填写具体的广告计划、广告或标的物,我们将提取该广告主 ID下的所有的广告行为数据,时间窗用来圈定您希望提取特定时间范围内与您广告有过互动的人群,最多可支持提取最近1年数据。

 

人群创建成功后,我们会依据用于创建人群的广告计划、广告、标的物是否有相应的曝光、点击、转化数据,来判定广告人群是否更新,人群更新的最小时间单位为天。请求示例:

curl 'https://api.e.qq.com/v1.1/custom_audiences/add?
access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -H 'Content-Type: application/json' \
    -d '{
        "account_id": "",
        "name": "广告点击人群",
        "description": "测试广告点击人群",
        "type": "AD",
        "audience_spec" : {
          "ad_rule_spec": {
            "rule_type" : "CONVERSION",
            "conversion_type": ["ACTION_TYPE_APP_START_DOWNLOAD","ACTION_TYPE_APP_INSTALL"],
            "time_window": 30,
            "product_list" : [
              {
                "product_type" : "PRODUCT_TYPE_APP_IOS",
                "product_refs_id" : 123
              },
              {
                "product_type" : "PRODUCT_TYPE_ECOMMERCE",
                "product_refs_id" : 456
              }
            ]
          }
        }
      }'

返回示例:

{
    "code": 0,
    "message": "ok",
    "data": {
        "audience_id": 2837395
    }
}

收到接口返回的广告人群id后,您就可以将它用于广告定向中了,关于如何使用人群定向,详见【广告-定向】页面介绍。

有关广告人群读写接口的更详细说明,可以参考 接口清单-Audience