DT 平台支持接入以下广告变现平台的收入数据：

Google Admob

Meta Audience Network

MAX

Pangle

Vungle

Unity

Bigo

以便于您分析用户以及各维度下的的广告变现收入，分析维度包括不限于国家、广告单元、广告类型、广告平台

注意：如果您接入的是广告聚合平台，例如MAX，DT仅会获取MAX自身的广告收入数据，并不会获取被聚合广告平台的收入数据

一、接入必要条件

通过 DT SDK 上报广告收入相关事件及属性，上报方法参见 DT 各 SDK 接入文档

广告收入事件

事件名	中文名	说明
#ad_show	广告展示	参与广告收益计算的重要事件；在广告展示后上报
#ad_conversion	广告收益	参与广告收益计算的重要事件；在用户获得广告奖励后上报

广告收入事件属性

属性名	采集类型	查询类型	中文名	说明
#ad_id	string	文本	广告单元 id	具体的广告平台的广告单元 id
#ad_type_code	int	数值	广告类型代码	UNKNOWN = -1 // 未知 BANNER = 0 // 横幅 INTERSTITIAL = 1 // 插屏 NATIVE = 2 // 原生 REWARDED = 3 // 激励 REWARDED_INTERSTITIAL = 4 // 插屏激励 APP_OPEN = 5 // 开屏广告 MREC=6 // 中等矩形广告
#ad_platform_code	int	数值	广告平台代码	UNDISCLOSED = -2 // 未授权 UNKNOWN = -1 // 未知 ADMOB = 0 MOPUB = 1 ADCOLONY = 2 APPLOVIN = 3 CHARTBOOST = 4 FACEBOOK = 5 INMOBI = 6 IRONSOURCE = 7 PANGLE = 8 SNAP_AUDIENCE_NETWORK = 9 TAPJOY = 10 UNITY_ADS = 11 VERIZON_MEDIA = 12 VUNGLE = 13 ADX = 14 COMBO = 15 BIGO = 16 HISAVANA = 17 APPLOVIN_EXCHANGE = 18 MINTEGRAL = 19 LIFTOFF = 20 A4G = 21 GOOGLE_AD_MANAGER = 22 FYBER = 23 MAIO = 24 CRITEO = 25 MYTARGET = 26 OGURY = 27 APPNEXT = 28 KIDOZ = 29 SMAATO = 30 START_IO = 31 VERVE = 32 LOVINJOY_ADS = 33 YANDEX = 34 REKLAMUP = 35
#ad_mediation_id	string	文本	聚合平台广告单元id	聚合平台的广告单元 id，不是具体的广告平台的id
#ad_mediation_code	int	数值	聚合广告平台代码	如果不使用聚合广告平台，请传入-1 MOPUB = 0 MAX = 1 HISAVANA = 2 COMBO = 3 TOPON = 4 TRADPLUS = 5 TOBID = 6

二、变现数据接入

2.1 授权变现平台

授权变现平台有两种方式：①自动授权②表单 token 授权，详情见下

授权方式	支持变现平台	图例
自动授权	Google Admob
token 授权	Mete Audience Network MAX Pangle Vungle Unity Bigo

各广告变现平台授权 token 获取方式见下

注意：账号名称需用户自主填写，用于区分不同账号的备注

广告变现平台	token 获取方式
Mete Audience Network	Business ID：在 Meta 后台获取 Business ID，登录 Audience Network，在网址栏的网址中有“business id=xxx”，等号后即为 Business ID
MAX	api_key：右上角点用户信息 → Keys → Report Key filter_application：应用的名称，很多地方都可以获取，没有专门的地方
Pangle	user_id role_id 和 secure_key：见下图
Vungle	api_key：在报表中点击 Reporting API Key
Unity	apikey organization_id
Bigo	developer_id：Bigo 开发者平台进入用户信息 token：Bigo 开发者平台进入 Reporting API 页面查看 token appkey：Bigo 开发者平台进入媒体管理-应用管理页面查看应用 ID

2.2 配置变现账户

授权成功后即可查看授权账号下所有的变现账户，可以根据需求进行搜索添加变现账户，然后将变现数据与 DT 平台中的项目进行关联，一个账户支持关联多个项目

2.3 校验数据转化

在「转化统计」页面可以查看每个项目的变现金额集成转化情况

数据时区：广告变现平台变现账户的时区
变现总金额（$）：广告变现平台变现账户的收入金额
DT 转化成功（$）：DT 平台转化至用户层级的收入金额，与事件分析「广告收益转化（服务端）。广告收益。总和」完全相等
DT 转化失败比例
1. 正常情况：转化失败比例≤5%，属于正常误差内
2. 异常情况：转化失败比例＞5%，原因为缺失归因合作商信息，请检查归因数据接入是否正确及归因映射关系是否配置

注意：在 DT 集成广告变现数据后，如果比对 DT 平台和广告变现平台两者的平台显示数据，两个平台的数据计算时区需要保持一致

三、变现数据使用

3.1 数据说明

变现数据集成的是每一个变现账户下的收入金额（$），其维度包括不限于国家、广告单元、广告类型、广告平台

每一次三方变现数据的转化都会对应生成一个广告收入事件“广告收益转化（服务端）”，可以在各分析模型中进行使用分析

事件

事件/用户属性名	显示名	属性说明
$ad_conversion	广告收益转化（服务端）	DataTower.ai 依赖客户授权的变现平台数据计算出的广告收益事件

事件属性

属性名

显示名

属性说明

$earnings

广告收益

DataTower.ai 依赖客户授权的变现平台数据计算出的广告收益

#ad_platform

广告平台

UNDISCLOSED
UNKNOWN
ADMOB
MOPUB
ADCOLONY
APPLOVIN
CHARTBOOST
FACEBOOK
INMOBI
IRONSOURCE
PANGLE
SNAP_AUDIENCE_NETWORK
TAPJOY
UNITY_ADS
VERIZON_MEDIA
VUNGLE
ADX
COMBO
BIGO
HISAVANA
APPLOVIN_EXCHANGE
MINTEGRAL
LIFTOFF
A4G
GOOGLE_AD_MANAGER
FYBER
MAIO
CRITEO
MYTARGET
OGURY
APPNEXT
KIDOZ
SMAATO
START_IO
VERVE
LOVINJOY_ADS
YANDEX
REKLAMUP

#ad_type

广告类型

未知
横幅
插屏
原生
激励
插屏激励
开屏广告

#ad_country

广告所属国家/地区

广告进行分发的国家/地区

3.2 使用实例

分析对象	图例
分析广告变现收入
分析广告变现收入，按广告平台查看
分析广告变现收入，按广告类型查看

四、常见 FAQ

授权异常该怎么处理

数据源	错误信息	说明
Google Admob 参考官方文档	`UNSPECIFIED`	未指定枚举。
	`UNKNOWN`	此版本中未知收到的错误代码。
	`USER_PERMISSION_DENIED`	用户无权访问客户。注意：如果您要访问客户客户，则必须在标头中设置经理的客户 ID `login-customer-id`。了解详情，请访问https://developers.google.com/google-ads/api/docs/concepts/call-struct#cid
	`DEVELOPER_TOKEN_NOT_ON_ALLOWLIST`	开发者令牌不在允许列表中。
	`DEVELOPER_TOKEN_PROHIBITED`	请求中发送的项目不允许使用开发者令牌。
	`PROJECT_DISABLED`	请求中发送的 Google Cloud 项目没有访问该 api 的权限。
	`AUTHORIZATION_ERROR`	客户端授权失败。
	`ACTION_NOT_PERMITTED`	用户无权对资源执行此操作（例如，ADD、UPDATE、REMOVE）或调用方法。
	`INCOMPLETE_SIGNUP`	注册未完成。
	`CUSTOMER_NOT_ENABLED`	无法访问客户帐户，因为该帐户尚未启用或已停用。
	`MISSING_TOS`	开发商必须签署服务条款。可以在这里找到它们：ads.google.com/aw/apicenter
	`DEVELOPER_TOKEN_NOT_APPROVED`	开发者令牌仅被批准用于测试帐户。要访问非测试帐户，请申请基本或标准访问权限。
	`INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION`	指定的登录客户无权访问指定的帐户，因此请求无效。
	`SERVICE_ACCESS_DENIED`	指定的开发人员无权访问该服务。
	`ACCESS_DENIED_FOR_ACCOUNT_TYPE`	客户（或登录客户）不在 Google Ads 中。它属于另一个广告系统。
	`METRIC_ACCESS_DENIED`	开发人员无权访问所查询的指标。
Meta Audience Network	'Unsupported get request. Object with ID \'586427753282817111\' does not exist	Business ID 找不到
Meta Audience Network	"The access token could not be decrypted"	access token 解析错误
MAX	Authentication Failed	权限校验失败
Pangle	身份验证失败	用户认证的信息错误
Vungle	401: Unauthorized	授权失败
Unity	invalid access token	access token 无效
	organization not found	organization 未找到
	"organization_id should be number"	organization_id 输入 number
Bigo	101	Sign verification failed，认证错误
	102	Invalid developerid
	Invalid access token	access token 非法

数据异常该怎么处理

数据源	错误信息	说明	处理方式
Google Admob	Invalid Argument	账户信息无效	请检查对应账号是否发生变动或被删除
	access_denied	用户授权失效	使用正确的账号重新授权
	'invalid_grant: Bad Request'	权限失效	检查账号的权限是否发生改动，重新授权
Meta Audience Network	'Unsupported get request. Object with ID \{business_id} does not exist, cannot be loaded due to missing permissions, or does not support this operation. Please read the Graph API documentation at https://developers.facebook.com/docs/graph-api'	business id 不存在	请检查这个 businessid 是否被删除使用正确的账号重新授权
Meta Audience Network	'The access token could not be decrypted'	access token 解析失败	使用正确的账号重新授权
MAX	Authentication Failed	权限校验失败	确认 api_key 是否发生变动，确认后重新进行授权
Pangle	身份验证失败	用户认证的信息错误	检查 secure_key 是否过期或失效
Vungle	401: Unauthorized	认证失败	检查 api_key 是否发生变动，使用正确的 api_key 重新授权
Unity	invalid access token	access token 无效	确认 apikey 是否填写正确
	organization not found	organization 未找到	确认 organization_id 是否填写正确
	RetryError(MaxRetryError("HTTPSConnectionPool(host	Unity的服务器存在问题	请联系Unity的官方客户获取帮助
Bigo	101	Sign verification failed，认证错误	检查 token 是否被重置
Bigo	102	Invalid developerid	检查 developerid 是否被删除

变现金额转化失败

转化失败比例小于 5%以内是正常范围

转化失败的问题是：缺失 ad_id 和 country 信息，请检查客户端是否上报原生广告平台的 ad_id，以及用户 IP 是否正常

ROI Master