用户级收益数据API

您可以使用此API获取OpenMediation以及中介广告网络的用户级广告收入报告。 获取的数据具体信息有:用户设备 ID、用户设备类型、广告网络、点击次数、展示次数、收入。

前言

  • 每个应用程序每天都有一个API调用,数据被存储并可用14天。
  • 昨天的数据从今天16:00 UTC开始。
  • 数据更新前三天(T-3, T-2, T-1)。
  • 当没有检索到设备ID时,用户广告展现等于0。
  • 每个应用程序每天最多有28个请求。

如何获得身份验证

  • TOKEN - Token对于您的OpenMediation账户是唯一的,导航到 Account-> Preport API. 点击 'COPY API '.

01_Reporting_API_Key___Eng.jpeg

02_Reporting_API_Key___Eng.jpeg

  • APP KEY - 获取您的APP KEY,请导航到 'APPS' -> 'Apps'. 点击 'APP KEY'.

WechatIMG339.png

 

下载报告

Method

GET  http://[API domain]/publisher/user/ad/revenue?token=[token]&appKey=[appkey]&date=[YYYYMMDD]&zone=[zone]

(For example: http://sdk.adtimingapi.com/publisher/user/ad/revenue?token=vmZlWg5pHf2ATYm123aag3475xOvByQX&appKey=jII0DMD53mIDzO123VFXIF6iRrWK8bBQ&date=20200220&zone=E08)

Parameters

Name Type Description Mandatory
API domain string sdk.adtimingapi.com

yes

token string The token obtained from AdTiming UI. yes
appKey string The appkey obtained from AdTiming UI. yes
date string YYYYMMDD, as 20190821 yes
zone string Default: UTC; Contact your AM if you need E08 enabled no

E08: UTC+0800

 

CODE Description
200 Success
400 Bad Request Parameters
403 Wrong token or appKey used
406 Empty data
HTTP  Status CODE


报告详解

成功的数据响应返回一个包含多个CSV文件的zip文件,每个CSV文件的大小可达256MB。zip文件的格式为[AppID]-[date]-[zone].zip(例如:1372837999-20200220-UTC.zip)。

 

列标题和顺序如下:

  • device_id
  • device_type
  • ad_network
  • impression
  • click
  • revenue
  • user_id

Fields Definition

Name Type Description Example
device_id string The Device ID being set by the developer ffaa1e86-d7d5-4a34-955a-2cab7025b879
device_type string iOS is 'IDFA', Android is 'GAID' IDFA
ad_network string The network which displayed the ad to the user Admob
impression long Number of impressions 123456
click long Number of clicks 123456
revenue decimal(16,6) Ad revenue 0.03000
user_id string Publisher defined user id 23356861
这篇文章有帮助吗?
8 人中有 7 人觉得有帮助

评论

0 条评论

文章评论已关闭。