基本报表API

  • 更新于

该报表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
Share this article:

这篇文章有帮助吗?

23 人中有 16 人觉得有帮助

还有其它问题?提交请求