🔥$200/月畅享Tenjin完整访问权限 - 解锁全部功能，无隐藏费用，随时可取消 查看定价和功能

注册
查看类别

展示级收入数据 API (S2S)

阅读时间 6 分钟

仅当需要通过 S2S 直接向尚未与 Tenjin 正式集成的广告聚合平台发送展示级收入数据（ILRD）时，才应使用此接口。

身份验证 #

我们通过基本身份验证中作为用户名的API密钥，或作为参数的api_key来对发送到Tenjin服务器的每个请求进行身份验证。 

通用端点 #

路径： https://track.tenjin.com/v0/ad_impressions/

方法：POST

Content-Type: application/x-www-form-urlencoded

设备信息参数 #

标有 * 的参数为必填项

参数例子说明
bundle_id*com.tenjin.wordfinder应用包名
advertising_id*be277924-d076-456d-9a20-3c8dee5663d3设备的原始广告标识符。请注意，请求只有在携带有效设备 ID（advertising_id、developer_device_id、analytics_installation_id 三者之一）时才会被接受。发送设备 ID 类型时需保持一致。iOS 上应使用 IDFA；在用户未授权同意的情况下，advertising_id 可以为空或全零，此时需在 developer_device_id 中提供 IDFV，并同时提供 analytics_installation_id。Android 上，advertising_id 或 analytics_installation_id 至少提供一个。
developer_device_id*5f4dcc3b-5aa5-40e1-8914-7a9c5d5ebf31设备唯一标识符的备用字段，在没有广告标识符时使用。对于 iOS，该字段应为 IDFV。
analytics_installation_id*91d1c313-dd94-4bd3-bbbb-16c8b7afa054Tenjin 生成了应用程序安装专属标识符。可通过 客户回调 或 SDK 获取。Android SDKiOS SDKUnity SDK
platform*ios该应用的平台。 ios,android （附带 Google Play 商店）， android_other （未预装 Google Play 商店，例如搭载中国应用商店的设备）， amazon （搭配 Amazon App Store）
app_version*1.5App 版本号。Android 示例：String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + "." + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode)；iOS 示例：[[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"]。
app_version_code2仅限Android
Android 应用版本： https://developer.android.com/studio/publish/versioning
build_idRQ3A.211001.001Android用户 
String build = String.valueOf(Build.ID)
iOS用户： 
@import Darwin.sys.sysctl;
NSString *build(void) { size_t bufferSize = 64;  NSMutableData *buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname(“kern.osversion”, buffer.mutableBytes, &bufferSize, NULL, 0);  if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding];}
carrierT-2移动运营商（互联网服务提供商）
connection_typewifimobile/wifi
countryUSISO地区国家代码标准（示例请参见Apple文档）。
devicebluelineAndroid：android.os.Build.DEVICE (参考)iOS: systemInfo.machine (参考)
device_brandgoogle
device_manufacturer谷歌
device_modelPixel 3Android用户
String device = Build.MODEL;
iOS用户：
@import Darwin.sys.sysctl;
NSString *device(void) { size_t bufferSize = 64;  NSMutableData *buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname(“hw.machine”, buffer.mutableBytes, &bufferSize, NULL, 0);  if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding];}
device_productblueline仅限 Android：build.PRODUCT
languageenISO 639‑1 两字母代码
limit_ad_trackingFALSE设备是否限制广告追踪？（true,false）
opt_inTRUE为符合《通用数据保护条例》（GDPR）要求而获取的设备主动同意： Tenjin SDK 的实现
localeen_USAndroid用户String locale = Locale.getDefault().toString()
iOS用户：[[NSLocale currentLocale] localeIdentifier]
os_version14Android用户 String.valueOf(Build.VERSION.SDK_INT)
iOS用户： [[UIDevice currentDevice] systemVersion]
os_version_release14.3.1仅限 Android：完整操作系统发布版本
timezone欧洲/卢布尔雅那
user_agentLinux；U；Android 11；SM-A505FN Build/RP1A.200720.012用户设备的用户代理
screen_height2028
screen_width1080
sent_at1693581566830纪元时间（以毫秒为单位）
session_idf4239af1-cd6f-49e8-8b97-f61a9e81a7e0
source_app_storeGoogle Play仅限Android： unspecified, googleplay, amazon, other
ip_address*（用于确定设备所在国家/地区）87.123.246.9用户的 IP 地址。该信息用于根据 Google DMA 用户同意参数查询国家/地区。
ad_user_data （Google 要求）1Google用户同意信号参数：用于表示是否同意将用户级数据传输给第三方用于广告。1表示同意，0表示拒绝。当没有用户同意数据时，应从请求中完全移除此参数（不要将其设置为空）。
ad_personalization （Google 要求）1Google用户同意信号参数：用于表示是否同意个性化广告。1表示同意，0表示拒绝。当没有用户同意数据时，应从请求中完全移除此参数（不要将其设置为空）。

收入信息参数 #

标有 * 的参数为必填项

参数例子说明
ad_revenue_mediation*max聚合平台名称，请使用以下选项：
max,ironsource,admob,topon,cas,tradplus
对于其他聚合，请使用 custom.
network_name*mintegral展示广告的广告网络名称，通常由聚合平台传递。
currency*USDISO货币代码，例如 USD、JPY
revenue_decimal*0.001以小数形式表示的单次展示收入只需填写 revenue_decimal 或 revenue_cpm 其中之一；若同时收到这两个字段，则优先采用 revenue_decimal
revenue_cpm1.0CPM 形式的收入，等于 revenue_decimal * 1,000
mediation_countryUS聚合服务提供商的国家，采用 ISO 两字母国家代码，例如 US
ad_unit_id09807a44b2f855cc由判定归因渠道上报的Ad unit ID
ad_format横幅广告单元格式： banner, mrec, xpromo, native, leaderboard/leader, interstitial/inter, rewarded/reward, rewarded_inter/rewarded_interstitial
precisionBID通过聚合传递的值，表示收入来源，例如 BID、CPM、RATE
creative_id9299584通过聚合平台传递的值
placement横幅123通过聚合传递的、由发布商定义的广告位名称的值
network_placement横幅名称外部广告网络的广告位名称
auction_id27d38ef0-847c-11ec-8b8d-3fe5d30476ca_765960010通过聚合传递的值

请求示例 #

JSON
curl -X POST https://track.tenjin.com/v0/ad_impressions/ -H "Content-Type: application/x-www-form-urlencoded" -d 'api_key=api_key&advertising_id=123&ad_revenue_mediation=max&network_name=google&mediation_country=US&currency=USD&ad_unit_id=1&ad_format=banner&revenue_decimal=0.01&precision=BID&creative_id=2&placement=banner_1&auction_id=3&bundle_id=com.tenjin.test&platform=ios&ad_user_data=1&ad_personalization=1'
您的感觉是什么
阿努拉格
展示级收入数据 API (S2S) | Tenjin
了解如何通过服务器对服务器集成方式部署 Tenjin 的展示量级收入数据 API，以实现精准的广告收入追踪。.
首页
文件
展示级收入数据 API (S2S)
Tenjin
让增长变简单