オーディエンス推定

POST accounts/:account_id/audience_estimate

キャンペーンのおおよそのオーディエンスサイズを決定します。

このエンドポイントはターゲティング条件オブジェクトのパラメータを含むJSONオブジェクトの配列を受け入れます。必須および任意のターゲティング条件パラメータの一覧については、POST accounts/:account_id/targeting_criteriaエンドポイントを参照してください。リクエストはJSONでコンテンツ本体を記述したHTTP POSTで、ヘッダーがContent-Type: application/jsonである必要があります。

: 少なくとも1つの主要ターゲティング条件を指定する必要があります。すべての主要ターゲティング条件のリストは、キャンペーンターゲティングのページでご覧いただけます。

リソースURL

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

パラメータ

名前 説明
account_id
必須

利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメータです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。

タイプ: 文字列

例: 18ce54d4x5t

targeting_criteria
必須

ターゲティング条件オブジェクトのすべてのパラメータを含むJSONオブジェクト。必須および任意のターゲティング条件パラメータの一覧については、POST accounts/:account_id/targeting_criteriaエンドポイントを参照してください。

注: このエンドポイントはoperator_typeパラメータをサポートしていません

リクエストの例

POST https://ads-api.x.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
    }
  }
}