报表 API
使用此报表 API 获取 JSON 或 CSV 格式的汇总广告活动数据。
请求格式
通过向以下基础 URL 发送 HTTP GET 请求来发起报表请求：
https://r.applovin.com/report
必填参数
| 参数 | 用途 |
|---|---|
api_key | 您的报表密钥 您可以在 AppLovin dashboard 中找到您的报表密钥，方法是点击 dashboard 右上角的账户并选择 Keys。 |
start1 | 报表的开始日期 接受 «YYYY-MM-DD» 格式的日期或 Unix 时间戳。例如，2012-10-05 或 1336608000。 |
end1 | 报表的结束日期 接受 «YYYY-MM-DD» 格式的日期或 Unix 时间戳。例如，2012-10-05、1336608000 或 now。 |
format | 报表格式 接受 json 或 csv。请参阅下方关于请求格式的详细信息。 |
columns | 报表列的逗号分隔列表 请参阅下方允许的列。例如， day,campaign。 |
report_type | advertiser（必填） |
1 此 API 的请求时间窗口为 90 天。请确保日期参数在过去 90 天内。
可选参数
| 参数 | 用途 |
|---|---|
day_column | 默认情况下，指标是实时的；当您想要拉取 cohort（指标将归因回展示时间）下的指标时，请将其设置为 day。 |
limit | 返回的行数限制；例如，500 |
offset | 开始获取行数据的偏移量；例如，100 |
having | 允许对数值进行复杂的过滤。 此参数接受 URL 编码的数值列、比较运算符和逻辑运算符，例如： impressions%20%3E%200%20AND%20cost%20%3E%200（“impressions > 0 AND cost > 0”）。注意：这会减慢响应速度并增加超时的可能性。 |
not_zero | 将此项设置为 1 以过滤掉所有数值指标均为 0 的结果。 |
推荐列
| 列名 | 包含内容 |
|---|---|
campaign | 广告活动名称 |
campaign_id_external | 广告活动的唯一引用 重命名广告活动时，此值不会改变。它与 {CAMPAIGN_ID} 点击宏的值相同。 |
cost | 广告主消耗 |
country | 两位字母国家代码 |
creative_set | 创意组名称 |
creative_set_id | 创意组 ID。即使创意组名称发生变化，此 ID 也不会改变。 |
day | 报表数据日期 |
hour | 报表数据小时（仅适用于过去 30 天） |
可选列
| 列名 | 包含内容 |
|---|---|
average_cpc | 平均每次点击成本 (CPC) |
campaign_bid_goal | CPP 和 CPE 广告活动的广告活动 bid 目标，以美元值 ($) 表示。请求此列时，您还必须请求 campaign 列。 |
campaign_type | 广告活动优化类型（CPP、CPE 或 ROAS） |
audience_strategy | 广告活动受众优化策略（universal、prospecting 或 discovery） |
sales_«x»1 | 特定时间段内的销售额（«x» 为 0d、1d、2d、3d、7d、14d、28d 之一） |
chka_usd_«x»1 | 在特定时间段内发生的归因总结账金额（«x» 为 0d、1d、2d、3d、7d、14d、28d 之一） |
clicks | 点击次数 |
cpp_«x»1 | 特定时间段内的每次购买成本（«x» 为 0d、1d、2d、3d、7d、14d、28d 之一） |
ctr | 点击次数 ÷ impression 次数 |
custom_page_id | 特定的落地页 |
impressions | impression 次数 |
optimization_day_target | 您为广告活动选择的目标优化天数（例如第 0 天或第 7 天） |
placement_type | INTER 或 REWARDED_INTER |
platform | android、ios、fireos 或 tvos |
roas_«x»1 | 特定时间段内的总 ROAS（«x» 为 0d、1d、2d、3d、7d、14d、28d 之一） |
sales | 归因销售事件的数量 |
1时间段指定为自 impression 时间起的滚动窗口。0d 表示自 impression 时间起 24 小时内的事件，1d 表示 48 小时，2d 表示 72 小时，依此类推。
新客数据列
| 列名 | 包含内容 |
|---|---|
nc_d0_checkouts | 新客在 impression 后 24 小时内进行的结账次数。 |
nc_d0_checkout_rev | 新客在 impression 后 24 小时内产生的总收入。 |
nc_d0_cpp | 消耗除以新客 D0 结账次数。 |
nc_d0_roas | 新客 D0 结账收入除以消耗。 |
nc_percent_d0_checkouts | 新客产生的 D0 结账百分比。 |
nc_percent_d0_checkout_rev | 新客产生的 D0 结账收入百分比。 |
nc_d7_checkouts | 新客在 impression 后 192 小时内进行的结账次数。 |
nc_d7_checkout_rev | 新客在 impression 后 192 小时内产生的总收入。 |
nc_d7_cpp | 消耗除以新客 D7 结账次数。 |
nc_d7_roas | 新客 D7 结账收入除以消耗。 |
nc_percent_d7_checkouts | 新客产生的 D7 结账百分比。 |
nc_percent_d7_checkout_rev | 新客产生的 D7 结账收入百分比。 |
new_visitor_rate | 访问您网站的新访客百分比。 |
CPE 列
| 列名 | 包含内容 |
|---|---|
cost_per_target_event_0d | 消耗除以 impression 后 24 小时内的目标事件数量。 |
target_event | 广告活动优化所针对的事件名称。 |
target_event_count_0d | 客户在 impression 后 24 小时内触发的目标事件数量。 |
过滤列
您可以按任何列过滤报表。 执行此操作时，您将搜索与任何过滤器直接匹配的内容。
要按列进行过滤，请添加以下 URL 参数：filter_columnname=«onefilter,anotherfilter,thirdfilter»
例如，如果您只想查看 Android 平台的数据，请设置以下 URL 参数：filter_platform=Android
有关所有列的列表，请参阅上表。
某些列支持通过 filter_not_columnname=«onefilter,anotherfilter» 进行排除过滤。
custom_page_id 列还支持 filter_null_custom_page_id、filter_blank_custom_page_id、filter_not_null_custom_page_id 和 filter_not_blank_custom_page_id 选项。
这些选项不需要值，即 …&filter_not_null_custom_page_id=&filter_not_blank_custom_page_id=&…
排序列
您对报表进行排序的方式与过滤报表的方式类似。
例如，要按 campaign 对报表进行排序，请添加以下 URL 参数：sort_campaign=ASC
接受的值为 ASC（升序）或 DESC（降序）。
所有排序均为按字典顺序排序。
报表格式
您可以请求两种格式的报表：JSON 或 CSV。
时区
报表 API 中的所有数据均采用 UTC（协调世界时）。
请求示例
https://r.applovin.com/report?api_key=«your-report-key»&start=2024-04-20&end=now&columns=day,campaign,impressions,clicks,ctr,cost,sales&format=json&report_type=advertiser
