返回AppLovin.com
投放帮助变现帮助

基本报表API

Avatar
AppLovin Partners Support
更新于

该报表API（应用程序编程接口）可用于获得JSON或CSV格式的广告活动数据汇总。

请求格式

应通过HTTP GET的方式将报表请求发送至以下基本URL。

https://r.applovin.com/report
必选参数
  • api_key 即广告主用于报表的API密钥（即Report Key）。报表密钥（Report Key）用于验证报表API，如需获取，可查阅账户页面中“Keys（密钥）”获得。若密钥值为空，请发送邮件至support@applovin.com，请注明您的投放账户的关联邮箱。
  • start 即报表起始日期。日期格式可采用“年-月-日”或Unix时间戳。如，2012-10-05或1336608000。该日期不得早于过去90天。
  • end 即报表截止日期。日期格式可采用“年-月-日”或Unix时间戳。如，2012-10-05，或1336608000或当前。
  • format 即报表格式。可用JSON或CSV格式。详情见下方所示请求格式。
  • columns 即报表列。参考下方可用列。如, ad_id,date,idfa,campaign_name
  • report_type 此参数命令API以“publisher（媒体）”或“advertiser（广告主）”数据进行响应。若省略该参数，则API默认report_type=publisher 。

可选参数

  • limit 此参数可设置返回行数的限制。如，500
  • offset 该参数可设置抓取数据的起始行。如, 100 
  • having 该参数允许对数值进行复合过滤。该参数可使用数组、比较运算符以及逻辑运算符的URL编码值，例如，impressions%20%3E%200%20AND%20revenue%20%3E%200 ("impressions > 0 AND revenue > 0")。注意：该参数将导致响应延迟，并增加超时可能性。

媒体可用列

  • day - 报表数据日期
  • hour - 报表数据时间（仅在过去30天内有效）
  • impressions - 浏览量
  • clicks - 点击量
  • ctr - 点击量或浏览量
  • revenue - 营收金额
  • ecpm - 每1000浏览量的营收金额
  • country - 国家代号
  • ad_type - 包括图片广告, 可试玩广告, 视频广告, 奖励视频广告, 或MRAID
  • size - 广告尺寸（插屏, 横幅, MREC, LEADER, 或原生）
  • device_type - 设备类型，包括手机、平板或其他
  • platform - 平台，包括安卓、iOS、或FireOS
  • application - 应用名
  • package_name - 应用包名或Bundle Id
  • placement - 广告位
  • application_is_hidden - 应用是否在后台隐藏
  • zone - Zone名称，若对您的账户可用。
  • zone_id - Zone ID，若对您的账户可用。若您有意使用区域，请联系您的账户管理员。

广告主可用列

  • day - 报表数据日期
  • impressions - 浏览量
  • clicks - 点击量
  • ctr - 点击量或浏览量
  • conversions - 转化量（安装量）
  • conversion_rate - 转化量或点击量
  • average_cpa - 每次转化的平均成本
  • average_cpc - 每次点击的平均成本
  • ad - 广告名
  • country - 国家代号
  • campaign - 广告活动名
  • app_id_external - 散列式应用ID（通常指‘site id’）
  • traffic_source - 'AppLovin'或交易名
  • ad_type - 广告类型包括图片, 视频, 或PLAY（演示）
  • cost - 广告主费用
  • sales - 销售性事件计数（需要设置营收回发）
  • size - 广告尺寸（插屏, 横幅, MREC, LEADER, 或原生）
  • device_type - 设备类型，包括手机、平板或其他
  • platform - 平台，包括安卓、iOS、Fire OS或tvOS
  • campaign_package_name - 所宣传的应用程序包名或包ID
  • campaign_id_external - 专指某一广告活动，当对活动重命名时，该参数不因此改变。 与{CAMPAIGN_ID}点击宏同值。
  • campaign_ad_type - 若用户获取则返回‘ua’，若重新定向则返回‘rt’

过滤列

通过AppLovin的报表API，任一列皆可对报表进行过滤。通过so搜索直接匹配任一过滤器

通过列进行过滤时，增加以下URL参数: filter_columnname=onefilter,anotherfilter,thirdfilter

例如，若广告主仅想看到安卓平台数据，则应设置以下URL参数: filter_platform=Android

任意列皆可对报表进行过滤。参见上述所有列。

排序列

排序报表与过滤器原理相似。

如，若通过campaign_name参数对某一报表进行排序，则增加以下URL参数：sort_campaign_name=ASC

可用值为‘ASC’或‘DESC’。所有排序按字典序。

报表格式

报表返回格式为JSON 和CSV.

时区

所有报表API数据应基于UTC（协调世界时）。

请求范例

广告主请求范例：

https://r.applovin.com/report?api_key=YOUR_API_KEY&start=2015-04-20&end=now&columns=day,campaign,impressions,clicks,ctr,conversions,conversion_rate,app_id_external,cost,sales&format=json&report_type=advertiser

开发者请求范例：

https://r.applovin.com/report?api_key=YOUR_API_KEY&start=2016-07-01&end=2016-07-07&columns=day%2Cplatform%2Ccountry%2Capplication%2Cpackage_name%2Csize%2Cad_type%2Cimpressions%2Cclicks%2Crevenue,device_type&having=impressions%20%3E%200%20AND%20revenue%20%3E%200&format=csv