Asset Reporting API
使用此 Reporting API 以 JSON 或 CSV 格式获取聚合的素材层级广告活动数据。
昨日的数据在世界标准时间 (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_id | 广告活动的唯一引用。与 Reporting API 中的 campaign_id_external 匹配。 |
clicks | 点击数 |
cost | 广告主花费 |
creative_set | 创意组名称 |
creative_set_id | 创意组 ID。即使创意组名称发生变化，该 ID 也保持不变。 |
ctr | 点击数 ÷ impressions 数 |
impressions | impressions 数 |
过滤列
您可以按 asset_id、asset_name、campaign、campaign_id、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/assetAnalyticsReport?api_key=«your-report-key»&start=2026-03-04&end=2026-03-30&columns=asset_id%2Cimpressions%2Cclicks%2Ccost&format=json&limit=100&sort_impressions=DESC
