受众预估

POST accounts/:account_id/audience_estimate

确定广告活动受众的大致受众规模。

此端点接受一系列包含定位标准对象参数的 JSON 对象。可在 POST accounts/:account_id/targeting_criteria 端点查看必需和可选的定位标准参数的列表。请求必须是带有 JSON 内容正文和 Content-Type: application/json 标头的 HTTP POST。

注意:你至少需要指定一个主要定位标准;你可以在广告活动定位页面中查看所有主要定位标准的列表。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/audience_estimate

参数

名称 说明
account_id
必需

所使用账号的标识符。出现在资源路径中,通常是所有广告商 API 请求的必要参数,不包含 GET accounts。指定账号必须与已验证的用户关联。

类型:string

示例:18ce54d4x5t

targeting_criteria
必需

包含定位标准对象的所有参数的 JSON 对象。可在 POST accounts/:account_id/targeting_criteria 端点查看必需和可选的定位标准参数的列表。

注意:此端点不支持 operator_type 参数

请求示例

POST https://ads-api.twitter.com/10/accounts/18ce54d4x5t/audience_estimate

{
  "targeting_criteria": [
    {
      "targeting_type":"LOCATION",
      "targeting_value":"96683cc9126741d1"
    },
    {
      "targeting_type":"BROAD_KEYWORD",
      "targeting_value":"cats"
    },
    {
      "targeting_type":"SIMILAR_TO_FOLLOWERS_OF_USER",
      "targeting_value": "14230524"
    },
    {
      "targeting_type":"SIMILAR_TO_FOLLOWERS_OF_USER",
      "targeting_value": "90420314"
    }
  ]
}

响应示例

{
  "request": {
    "params": {
      "targeting_criteria": null,
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "audience_size": {
      "min": 41133600,
      "max": 50274400
    }
  }
}