方法:GET /advertiser/listStats
描述: 您可以检索在 HilltopAds 广告账户中创建的广告活动的统计数据。
参数:
名字 | 描述 | 范例 | 评论 |
key | 您可在 HilltopAds 账户的 API 部分生成一个唯一的 API 密钥 | nXzgO3Bc | 这是请求中的必填参数。 |
Date | 需要检索统计数据的日期。 | 2023-01-01 | 默认情况下,回复将提供昨天的统计数据。 |
Date2 | 如果需要特定时期的统计数据,请指定此参数。 | 2023-01-31 | 该日期将被视为周期的最后一天,而 date 参数将是第一天。 |
GEO | 如果需要特定国家的统计数据,请指定此参数。
| 英国 | 要检索多个国家的数据,请用逗号分隔列出。
|
zoneID | 如果需要特定区段的统计数据,请指定此参数。 | 4OACSGAI8 | 要检索多个区段的数据,请用逗号分隔列出这些区段。 |
campaignID | 如果需要特定活动的统计数据,请指定此参数。 | 123456 | 要检索多个活动的数据,请用逗号分隔列出。 |
adID | 如果需要特定广告的统计数据,请指定此参数。 | 123456 | 要检索多个广告的数据,请用逗号分隔列出。 |
group | 指定该参数可对数据进行分组。 | 日期 | 您可以按日期、时间、地理位置、区域 ID、营销活动 ID、广告 ID 进行分组。 |
请求示例:
要检索活动 123456 在 2023 年 2 月 1 日至 3 月 31 日期间的统计数据,并按 日期分组,您应编写以下请求:
https://hilltopads.com/api/advertiser/listStats?key=nXzgO3Bc&date=2023-02-01&date2=2023-03-31&campaignId=123456&group=date