Adjust对接

概述#

您可选择S2S (server to server) 或C2S (client to server)方式，回传广告变现数据至Adjust。两种方式各有优势：

对接方式	数据准确度	数据实时性
S2S	使用广告平台报表API返回收益，数据精准	每天北京时间10点同步前天数据，数据时区请在TradPlus后台->我的账号查看
C2S	使用TradPlus预估收益，存在误差	实时上传

一、S2S对接方式#

TradPlus已与Adjust打通用户层级变现数据的对接，TradPlus可每天自动同步广告变现数据到Adjust。开发者需要在客户端和TradPlus后台都完成配置，才能正常使用此功能。

注意（建议）：通过`initCustomMap (Android/Unity)的上报需要在 TradPlus SDK 初始化之前完成；否则，部分 `userId`可能会无法回传。

1、客户端配置#

需要开发者把Adjust生成的adid作为user_id传给我们

Android 原生代码示例：

    HashMap<String, String> customMap = new HashMap<>();
    customMap.put("user_id",  "adid");
    //设置APP维度的规则，对全部placement有效
    SegmentUtils.initCustomMap(customMap);

Unity SDK 代码示例：

    Dictionary<string, string> map = new Dictionary<string, string>();
    map.Add("user_id", "adid");
    //设置APP维度的规则，对全部placement有效
    TradPlus.initCustomMap(map);

2、TradPlus后台配置#

第一步：在TradPlus后台配置添加或编辑应用界面，填入Adjust的安全识别码和应用识别码。

官方文档：https://help.adjust.com/zh/article/server-to-server-s2s-security#s2s-authentication

（1）获取Adjust后台的应用识别码

（2）获取Adjust后台的安全识别码（如果在Adjust后台未设置s2s安全认证，则不需要填入此信息。）

（3）在TradPlus后台填入Adjust的安全识别码和应用识别码。

第二步：在TradPlus后台的报表API key 界面生成key值，如果已生成过，则跳过此步骤。

第三步：TradPlus每天会在北京时间上午10点，自动发送数据给Adjust。开发者可在adjust后台查看数据。

3、API错误码&FAQ#

错误码	说明	解决方案
400 Invalid app token	应用识别码设置错误	请检查在TradPlus 开发者后台填写的app token是否正确
400 Ignoring event, earlier unique event tracked	在控制面板上已设定成唯一事件，重覆触发事件不再作记录。	请联系 adjust 官方客服人员或者
400 Invalid event token	事件识别码不存在、设置错误或与应用识别码不匹配。	请检查在TradPlus 开发者后台填写的app token是否正确
401 Failed to authorize request	授权识别码缺失或不匹配	请检查在TradPlus 开发者后台填写的authorize 是否正确
403 App is inactive	应用已在控制面板中设为非活跃状态	请联系adjust 官方客服，协助您解决问题。
403 Tracking disabled	未启用对该平台的跟踪	请联系adjust 官方客服，协助您解决问题。
403 Event token blacklisted	事件识别码已被列入黑名单	请联系adjust 官方客服，协助您解决问题。
404 App token not found	未找到应用识别码	请检查在TradPlus 开发者后台填写的app token是否正确
451 Device is opted out	设备已退出跟踪	请联系adjust 官方客服，协助您解决问题。

二、C2S对接方式#

1、在 Adjust 控制面板中生成收入事件识别码, 以进行收入事件的跟踪#

查找应用并选择应用选项插入符号 (^)
选择 所有设置>事件
前往模块底部的 创建新事件字段，然后输入事件名称 (如 adv_show_success )
选择创建

2、广告展示成功，TradPlus SDK 返回 eCPM#

String ecpm = tpAdInfo.ecpm;

因为native和banner的view是开发者自己控制的，所以没法精确的统计展示，所以native和banner的show数据和真实数据之间会有误差。
激励视频和插屏不存在此问题。

3、把 eCPM 换算成 Revenue#

double revenue = Double.parseDouble(ecpm) / 1000;

4、通过 Adjust 数据追踪方法 (trackEvent),上报Revenue: 方法说明 #

示例代码：

try {
    String ecpm = tradPlusInterstitial.getAdSourceEcpm();
    double revenue = Double.parseDouble(ecpm) / 1000;
    AdjustEvent adjustEvent = new AdjustEvent("adv_show_success");
    adjustEvent.setRevenue(revenue, "USD");
    Adjust.trackEvent(adjustEvent);
} catch (Exception e) {
    // 理论上getAdSourceEcpm()方法返回的String转double不会出现异常，保险起见还是加上try catch
    // 一些报错日志或处理
}

参考文档：https://help.adjust.com/zh/article/revenue-events

概述#