アナリティクス

リーチと平均フリークエンシー

Postmanで実行 ❯ 

GET stats/accounts/:account_id/reach/campaigns

指定したキャンペーンのリーチと平均フリークエンシーアナリティクスを取得します。

リソースURL

https://ads-api.x.com/stats/accounts/:account_id/reach/campaigns

パラメーター

名前 説明
account_id
必須

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

タイプ: 文字列

例: 18ce54d4x5t
campaign_ids
必須

カンマ区切りのIDリストを指定して、応答の範囲を目的のキャンペーンのみに設定します。最大20件のIDを指定できます。

注: 最大20件のキャンペーンIDを指定できます。

タイプ: 文字列

例: 8fgzf
end_time
必須

取得するデータの範囲を、ISO 8601で表される、指定の終了時間に設定します。

注: 時間の単位（0分0秒）で表す必要があります。

タイプ: 文字列

例: 2017-05-26T07:00:00Z
start_time
必須

取得するデータの範囲を、ISO 8601で表される、指定の開始時間に設定します。

注: 時間の単位（0分0秒）で表す必要があります。

タイプ: 文字列

例: 2017-05-19T07:00:00Z

リクエストの例

GET https://ads-api.x.com/10/stats/accounts/18ce54d4x5t/reach/campaigns?campaign_ids=8fgzf&start_time=2017-05-19&end_time=2017-05-26

応答の例

{
  "request": {
    "params": {
      "campaign_ids": [
        "8fgzf"
      ],
      "start_time": "2017-05-19T00:00:00Z",
      "end_time": "2017-05-26T00:00:00Z",
      "account_id": "18ce54d4x5t"
    }
  },
  "data_type": "reach",
  "data": [
    {
      "id": "8fgzf",
      "total_audience_reach": 1217,
      "average_frequency": 1.01
    }
  ]
}

GET stats/accounts/:account_id/reach/funding_instruments

指定したお支払い方法のリーチと平均フリークエンシーアナリティクスを取得します。

リソースURL

https://ads-api.x.com/stats/accounts/:account_id/reach/funding_instruments

パラメーター

名前 説明
account_id
必須

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

タイプ: 文字列

例: 18ce54d4x5t
funding_instrument_ids
必須

カンマ区切りのIDリストを指定して、応答の範囲を目的のお支払い方法のみに設定します。最大20件のIDを指定できます。

注: 最大20件のお支払い方法IDを指定できます。

タイプ: 文字列

例: lygyi
end_time
必須

取得するデータの範囲を、ISO 8601で表される、指定の終了時間に設定します。

注: 時間の単位（0分0秒）で表す必要があります。

タイプ: 文字列

例: 2017-05-26T07:00:00Z
start_time
必須

取得するデータの範囲を、ISO 8601で表される、指定の開始時間に設定します。

注: 時間の単位（0分0秒）で表す必要があります。

タイプ: 文字列

例: 2017-05-19T07:00:00Z

リクエストの例

GET https://ads-api.x.com/10/stats/accounts/18ce54d4x5t/reach/funding_instruments?funding_instrument_ids=lygyi&start_time=2017-05-19&end_time=2017-05-26

応答の例

{
  "request": {
    "params": {
      "funding_instrument_ids": [
        "lygyi"
      ],
      "start_time": "2017-05-19T00:00:00Z",
      "end_time": "2017-05-26T00:00:00Z",
      "account_id": "18ce54d4x5t"
    }
  },
  "data_type": "reach",
  "data": [
    {
      "id": "lygyi",
      "total_audience_reach": 1217,
      "average_frequency": 1.01
    }
  ]
}