覆盖范围和平均频率

GET stats/accounts/:account_id/reach/campaigns

检索指定广告活动的覆盖范围和平均频率分析。

资源 URL

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

参数

名称 说明
account_id
必需

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

类型:string

示例:18ce54d4x5t

campaign_ids
必需

通过指定逗号分隔的标识符列表,将响应范围限定为所需的广告活动。可最多提供 20 个 ID。

注意:可最多提供 20 个广告活动 ID。

类型:string

示例:8fgzf

end_time
必需

使用以 ISO 8601 表示的指定结束时间限定检索数据的范围。

注意:必须以整小时数(0 分 0 秒)表示。

类型:string

示例:2017-05-26T07:00:00Z

start_time
必需

使用以 ISO 8601 表示的指定开始时间限定检索数据的范围。

注意:必须以整小时数(0 分 0 秒)表示。

类型:string

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

请求示例

GET https://ads-api.twitter.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.twitter.com/stats/accounts/:account_id/reach/funding_instruments

参数

名称 说明
account_id
必需

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

类型:string

示例:18ce54d4x5t

funding_instrument_ids
必需

通过指定以逗号分隔的标识符列表,将响应范围限定为所需的支付手段。可最多提供 20 个 ID。

注意:可最多提供 20 个支付手段 ID。

类型:string

示例:lygyi

end_time
必需

使用以 ISO 8601 表示的指定结束时间限定检索数据的范围。

注意:必须以整小时数(0 分 0 秒)表示。

类型:string

示例:2017-05-26T07:00:00Z

start_time
必需

使用以 ISO 8601 表示的指定开始时间限定检索数据的范围。

注意:必须以整小时数(0 分 0 秒)表示。

类型:string

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

请求示例

GET https://ads-api.twitter.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
    }
  ]
}