资源报告 API
使用此 Reporting API 来获取 JSON 或 CSV 格式的聚合资源层级 campaign 数据。
昨天的数据在 UTC 时间上午 6:00 之后保持稳定。
请求格式
向以下基础 URL 之一发送 HTTP GET 请求，以生成报告请求：
https://r.applovin.com/assetReport(时间范围)https://r.applovin.com/assetAnalyticsReport(基于日期)
必要时间参数
/assetReport
| 参数 | 用途 |
|---|---|
range | 本报告的时间范围。有效值：yesterday、last_7d、last_month。 |
/assetAnalyticsReport
| 参数 | 用途 |
|---|---|
start1 | 报告的开始日期。接受 YYYY-MM-DD 格式的日期。例如，2012-10-05。 |
end1 | 报告的结束日期。接受 YYYY-MM-DD 格式的日期。例如，2012-10-05。 |
1此 API 的请求窗口为 45 天。请确保日期参数在过去 45 天内。
必要参数
| 参数 | 用途 |
|---|---|
api_key | 您的 Report Key 您可以在 AppLovin dashboard 中找到自己的 Report Key，方法是在 dashboard 右上方点击您的账户，然后选择 Keys。 |
columns | 报告列（通过逗号分隔的列表） 请参阅下方可用列。例如， asset_id,impressions。 |
可选参数
| 参数 | 用途 |
|---|---|
format | 报告格式 接受 json 或 csv。默认为 json。 |
limit | 您要返回的行数限制；例如，500（使用 limit 和 offset 对结果进行分页） |
offset | 开始调取行的偏移位置；例如，100（使用 limit 和 offset 对结果进行分页） |
可用列
| 列名称 | 包含信息 |
|---|---|
asset_id | 资源 ID |
asset_name | 资源名称 |
asset_url | 处理前原始资源的 URL |
campaign | campaign 名称 |
campaign_id | campaign 的唯一引用。与 Reporting API 中的 campaign_id_external 相匹配。 |
campaign_package_name | campaign 包名 |
clicks | 点击次数 |
cost | 广告主支出 |
creative_set | creative set 名称 |
creative_set_id | creative set ID。即使 creative set 名称发生更改，此 ID 也保持不变。 |
ctr | 点击次数 ÷ impressions 数 |
impressions | impressions 数 |
过滤列
您可以按 asset_id、asset_name、campaign、campaign_id、campaign_package_name、creative_set 和 creative_set_id 过滤报告。
进行过滤时，您将搜索与任何过滤器的直接匹配项。
例如，如果您只想查看 ID 为 12345 的特定资源的数据，请设置以下 URL 参数：asset_id=12345
当您按 asset_name 进行过滤时，必须对名称进行双重 URL 编码（但在发送多个值时不要对逗号进行编码）。
例如，如果您想过滤资源名称 html+3 和 video(25)，请设置 filter_asset_name=html%252B3,video%252825%2529。
- 原始过滤器：
html+3,video(25) - 进行一次 URL 编码：
html%2B3,video%2825%29（对+、(和)字符进行 URL 编码，但不编码,字符） - 双重编码：
html%252B3,video%252825%2529（进一步对第一次 URL 编码中的%字符进行编码）
要按列进行过滤，请添加以下 URL 参数：filter_columnname=onefilter,anotherfilter,thirdfilter
您还可以通过 filter_not_columnname=onefilter,anotherfilter 使用排除过滤器。
过滤指标
您还可以通过 greater_than 或 less_than 过滤器来过滤数值指标，例如 impressions 和 cost。
要过滤指标使其大于特定数字，请添加以下 URL 参数：filter_greater_than_columnname=number
要过滤指标使其小于特定数字，请添加以下 URL 参数：filter_less_than_columnname=number
例如，如果您只想查看 impressions 大于 100 的资源数据，请设置以下 URL 参数：filter_greater_than_impressions=100
您还可以通过添加查询参数 not_zero=1 来过滤掉所有 0 值。
列的排序
您对报告进行排序的方法与过滤报告的方法类似。
例如，若要按 impressions 对报告进行排序，请添加以下 URL 参数：sort_impressions=ASC
可接受的值为 ASC（升序）或 DESC（降序）。
所有排序均为字典顺序。
请求示例
https://r.applovin.com/assetReport?api_key=«your-report-key»&range=yesterday&columns=asset_id%2Cimpressions%2Cclicks%2Ccost&format=json&limit=100&sort_impressions=DESC
