该报表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,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