11/08/2024 16:35:54

Adjust 渠道说明

一、概述

一、概述

Adjust 平台提供了广告跟踪与事件上报功能，能够帮助业务提供必要的数据上报和分析，帮助业务的进一步发展。

二、开发者平台配置

二、开发者平台配置

2.1 注册账号

Adjust 平台为收费平台，业务需自行去申请 App 并配置好基础信息。

腾讯内部联系人：MSDK助手对接

2.2 获取 App Token (ID)

在 Adjust DashBoard 中可以找到对应的 App，并在配置中找到对应的 App Token 信息。

App Token 一般为一串字符串，并且 iOS 与 Android 不相同。

2.3 获取事件 Token (ID)

同样在 DashBoard 中，App 设置页面的 Events 页面，可以找到事件列表管理界面。可以根据需要新增、删除和修改事件。

[info] 注意
事件上报过程中，需要先在控制台配置好要上报的字段，然后在代码中上报控制台分配的对应 Token 字段。

2.4 eventName 唯一性

在管理端注册事件时可以勾选事件唯一性，勾选后该事件上报一个设备只统计一次。详情请参阅官网文档说明：Unique events

三、 Android工程配置

三、 Android工程配置

3.1 权限配置

网络访问权限（必选）

<uses-permission android:name="android.permission.INTERNET" />

WIFI 状态权限，非敏感权限，建议添加（可选）

<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

3.2 MSDKConfig.ini 配置

在工程文件 assets/MSDKConfig.ini 中添加配置。

[Adjust 调试模式]
MSDK_DEBUG = 1
MSDK_DEBUG_CHANNEL = Adjust
[Adjust 配置]
ADJUST_OPEN_DEEPLINK_ENABLE = 0
ADJUST_COPPA_COMPLIANT_ENABLE = 0
ADJUST_PLAYSTORE_KIDS_APP_ENABLE = 0
ADJUST_APP_TOKEN_ANDROID = {ADJUST_APP_TOKEN_ANDROID}
ADJUST_APPSECRET_ANDROID = {ADJUST_SECRET_ID}
ADJUST_INFO1_ANDROID = {INFO_01}
ADJUST_INFO2_ANDROID = {INFO_02}
ADJUST_INFO3_ANDROID = {INFO_03}
ADJUST_INFO4_ANDROID = {INFO_04}

[info] 注意
MSDK_DEBUG 是否开启调试模式，1 开启；0 关闭。
MSDK_DEBUG_CHANNEL 设置 Adjust 渠道，表示开启 Adjust 调试模式，仅当 MSDK_DEBUG 为 1 时，此开关才生效。
ADJUST_DATA_RESIDENCY 设置 Adjust 数据驻留地区，当有特定数据驻留地要求时配置此参数，默认不用配置。
url_strategy_india 印度；url_strategy_china 中国；data_residency_eu 欧洲； data_residency_tr 土耳其； data_residency_us 美国
ADJUST_OPEN_DEEPLINK_ENABLE 是否开启 deeplink 功能，默认 0 不开启。
ADJUST_COPPA_COMPLIANT_ENABLE 是否开启 CoppaCompliant 功能，默认 0 不开启。(MSDK 5.28 及以上版本支持)
ADJUST_PLAYSTORE_KIDS_APP_ENABLE 是否开启 PlayStoreKidsApp 功能，默认 0 不开启。(MSDK 5.28 及以上版本支持)
{ADJUST_APP_TOKEN_ANDROID} 填写从管理端获取的 Android App Token 值。
{ADJUST_SECRET_ID} 配置用于反作弊，为数值，需要 Adjust SDK 版本大于 4.12.0。当反作弊开启时，{INFO_01}、{INFO_02}、{INFO_03}、{INFO_04} 配置才生效，INFO 值请联系腾讯内部 Adjust 账号管理员获取，联系 MSDK助手对接。

3.3 GMS 依赖版本配置

<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />

一般情况下不需要修改，有特殊要求时，可以根据 GMS 插件包中的版本进行修改。

3.4 Receiver 配置，用于追踪安装来源（可选）

<receiver android:name="com.adjust.sdk.AdjustReferrerReceiver" android:exported="true" >
  <intent-filter>
      <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

四、 iOS工程配置

四、 iOS工程配置

4.1 MSDKConfig 配置文件

在工程中找到 MSDKAppSetting.bundle/MSDKConfig.ini 文件，增加如下配置。

[Adjust 调试模式]
MSDK_DEBUG = 1
MSDK_DEBUG_CHANNEL = Adjust
[Adjust 配置]
ADJUST_OPEN_DEEPLINK_ENABLE = 0
ADJUST_COPPA_COMPLIANT_ENABLE = 0
ADJUST_APP_TOKEN_IOS = {ADJUST_APP_TOKEN_IOS}
ADJUST_APPSECRET_IOS = {ADJUST_SECRET_ID}
ADJUST_INFO1_IOS = {INFO_01}
ADJUST_INFO2_IOS = {INFO_02}
ADJUST_INFO3_IOS = {INFO_03}
ADJUST_INFO4_IOS = {INFO_04}

[info] 注意
MSDK_DEBUG 是否开启调试模式，1 开启；0 关闭。
MSDK_DEBUG_CHANNEL 设置 Adjust 渠道，表示开启 Adjust 调试模式，仅当 MSDK_DEBUG 为 1 时，此开关才生效。
ADJUST_OPEN_DEEPLINK_ENABLE 是否开启 deeplink 功能，默认 0 不开启。
ADJUST_COPPA_COMPLIANT_ENABLE 是否开启 CoppaCompliant 功能，默认 0 不开启。(MSDK 5.28 及以上版本支持)
{ADJUST_APP_TOKEN_IOS} 填写从管理端获取的 iOS App Token 值。
{ADJUST_SECRET_ID} 配置用于反作弊，为数值。当反作弊开启时，{INFO_01}、{INFO_02}、{INFO_03}、{INFO_04} 配置才生效，INFO 值请联系腾讯内部 Adjust 账号管理员获取，联系 MSDK助手对接。

4.2 Adjust DeepLink功能（可选）

配置iOS 8 and Earlier、iOS 9 and Later，并在 AppDelegate.m 中添加如下代码。

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler

如需支持延滞（Deferred）应用跳转功能，则需要 app.plist 中 Adjust 项下开启开关。

4.3 添加系统库依赖

libz.tbd
libsqlite3.tbd
SystemConfiguration.framework
CoreTelephony.framework
AdSupport.framework
iAd.framework

五、功能说明

五、功能说明

5.1 事件上报

参考文档：上报事件

5.2 数据查询

开启 sandbox 模式查询数据

客户端开启 sandbox 模式上报数据
在 MSDKConfig.ini 配置文件中设置 MSDK_DEBUG_CHANNEL = Adjust（仅当 MSDK_DEBUG = 1 时，此配置才生效），设置成功本地日志如下：
Adjust 管理端开启 sandbox 模式查询数据

5.3 Ajust 渠道打包

Adjust 在 Android 中支持自定义设置预安装跟踪码（Adjust TrackerToken）功能。如果有自定义设置预安装跟踪码的需求，可以到飞鹰系统中进行打包设置。

如果进行了 Adjust 渠道打包，MSDK 会自动读取打入的预安装跟踪码并做设置。具体打包流程如下。

生成游戏 apk 包；
到 Adjust 管理端设置并获取预安装跟踪码；
到飞鹰管理端的 【常用工具】 - 【Adjust 渠道打包】页面；
上传 apk 包，配置 Adjust 预安装跟踪码以及渠道号，点击立即打包；
到 【Adjust 打包列表】 获取打好的 apk 包；

5.4 常见问题

上报的事件要用 Adjust 控制台的 token 字段，需要实现定义。
若提示初始化失败，一般都是配置的 Adjust 项目 MSDK_STAT_ADJUST_APP_TOKEN 和 MSDK_ADJUST_INFO1 信息不完整等。
Adjust 支持 callback parameter 和 partner parameter 两种方式，请参考 ReportEvent 上报事件接口获取详细信息。接入示例详见数据上报模块。
Adjust 渠道事件上报建议开启 Sandbox 模式。管理端数据更新依赖后台计算实时性，一般情况下，几分钟到十几分钟，但是也有隔天更新的情况。如果半个小时内看不到数据，可以隔天再查看下。

Adjust