配置 Adjust 上报

本文旨在介绍如何设置 Adjust 分析平台，让您的游戏可以直接将分析数据上报至 Adjust。

前提条件

注意

Adjust 支持多商店渠道包，同一开发者账号下可以创建多个 app ID。在 Adjust 网站上创建额外的游戏应用，并通过重复以下步骤完成额外游戏应用的配置。

创建一个 Adjust 账号，并在 Adjust dashboard 中设置与配置您的应用。

2. 获取 app token（ID）

进入 Adjust dashboard。
点击对应应用的选项图标（▲）。
查看应用的 APP TOKEN 信息。

说明

App token 一般为一串字符串，iOS 与 Android 有各自不同的 app token。

3. 创建跟踪链接

警告

创建跟踪链接后，需3小时以上才能在 Adjust 控制面板中查看相关数据。

进入 Adjust dashboard，点击对应应用的选项图标（▲）。
点击 Tracker URLs。
在 Manage Network Trackers 界面，填写跟踪链接名称并点击 QUICK CREATE。
在新创建的跟踪链接右侧，点击设置图标。
保存跟踪令牌，即 Adjust 接口后的 6 个或更多位字母和数字字符。

通过创建 tracker 链接获取 tracker token，添加到 APK 包，并打开应用查看相关数据。

接入 Player Network SDK。

步骤1：权限和工程配置

Android

用户权限

Adjust 需要访问网络和 WiFi 状态的权限。

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

Receiver 配置用于追踪安装来源。Player Network SDK 已经集成了配置，业务可以在 SDK 包中检查。

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

警告

Adjust 不提供接口手动控制 Mac 地址的采集，只依赖于 ACCESS_WIFI_STATE 权限采集 Mac 地址。
由于合规要求不能采集 Mac 地址，Player Network SDK 默认不为 Adjust 申请 WiFi 状态权限。同时 Player Network SDK 内所有插件都默认不申请该权限。

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

工程配置

在 INTLConfig.ini 文件中添加以下配置：

[Adjust Debug Mode]
DEBUG_CHANNEL = Adjust
[Android LifeCycle]
LIFECYCLE = Adjust
[Adjust Configurations]
ADJUST_OPEN_DEEPLINK_ENABLE = 0
ADJUST_APP_TOKEN_ANDROID = {ADJUST_APP_TOKEN_ANDROID}
ADJUST_REGISTER_EVENT_TOKEN_ANDROID = {REGISTER_TOKEN}
ADJUST_LOGIN_EVENT_TOKEN_ANDROID = {LOGIN_TOKEN}
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}
ADJUST_SUB_DOMAIN = {ADJUST_SUBDOMAIN}
ADJUST_URL_STRATEGY_ANDROID = {ADJUST_URL_STRATEGY_ANDROID}
ADJUST_SIGNATURE_VERSION_ANDROID = {ADJUST_SIGNATURE_VERSION_ANDROID}
ADJUST_CHANNEL_START_EVENT_TOKEN_ANDROID = {ADJUST_CHANNEL_START_EVENT_TOKEN_ANDROID}

DEBUG_CHANNEL 设置 Adjust 渠道，表示开启 Adjust 调试模式。
在 LIFECYCLE 中添加 Adjust。有关更多信息，请参见 SDK 环境。
ADJUST_OPEN_DEEPLINK_ENABLE 设置是否开启 deep linking 功能，默认 0 不开启。
{ADJUST_APP_TOKEN_ANDROID} 填写从管理端获取的 Android App Token 值。
[可选] 如果要有注册事件可以创建一个注册事件，并使用 event token 设置 {REGISTER_TOKEN}。
[可选] 如果要有登录事件可以创建登录事件，并使用对应的 event token 设置 {LOGIN_TOKEN}。
{ADJUST_SECRET_ID} 配置用于反作弊，为数值，Adjust SDK 4.12.0 或以后版本的开始支持。
{INFO_01}、{INFO_02}、{INFO_03}、{INFO_04} 配置仅在 {ADJUST_SECRET_ID} 设置后有效。
按照 SDK Signature 中的说明配置。
{ADJUST_SUBDOMAIN} 可以配置 Adjust 上报中转服务器，如果不需要，等号后面为空即可。
{ADJUST_URL_STRATEGY_ANDROID} 可以配置 Adjust 数据驻留的地区，如果不需要，等号后面为空即可。更多信息，请参见 Adjust 渠道配置。
{ADJUST_SIGNATURE_VERSION_ANDROID} 可以配置 Adjust 的签名版本，1 为 v1 签名，2 为 v2 签名。
将 {ADJUST_CHANNEL_START_EVENT_TOKEN_ANDROID} 替换为 Adjust 自定启动事件令牌。

iOS

工程配置

在 INTLConfig.ini 文件中添加配置：

[Adjust Debug Mode]
DEBUG_CHANNEL = Adjust
[Adjust Configurations]
ADJUST_OPEN_DEEPLINK_ENABLE = 0
ADJUST_APP_TOKEN_IOS = {ADJUST_APP_TOKEN_IOS}
ADJUST_REGISTER_EVENT_TOKEN_IOS = {REGISTER_TOKEN}
ADJUST_LOGIN_EVENT_TOKEN_IOS = {LOGIN_TOKEN}
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}
ADJUST_SUB_DOMAIN = {ADJUST_SUBDOMAIN}
ADJUST_URL_STRATEGY_IOS = {ADJUST_URL_STRATEGY_IOS}
ADJUST_SIGNATURE_VERSION_IOS = {ADJUST_SIGNATURE_VERSION_IOS}
ADJUST_CHANNEL_START_EVENT_TOKEN_IOS = {ADJUST_CHANNEL_START_EVENT_TOKEN_IOS}

DEBUG_CHANNEL 设置 Adjust 渠道，表示开启 Adjust 调试模式。
ADJUST_OPEN_DEEPLINK_ENABLE 设置是否开启 deep linking 功能，默认 0 不开启。
{ADJUST_APP_TOKEN_IOS} 填写从管理端获取的 iOS App Token 值。
[可选] 如果要有注册事件可以创建一个注册事件，并使用 event token 设置 {REGISTER_TOKEN}。
[可选] 如果要有登录事件可以创建登录事件，并使用对应的 event token 设置 {LOGIN_TOKEN}。
{ADJUST_SECRET_ID} 配置用于反作弊，为数值。
{INFO_01}、{INFO_02}、{INFO_03}、{INFO_04} 配置仅在 {ADJUST_SECRET_ID} 设置后有效。INFO 值请联系腾讯内部 Adjust 账号管理员获取，联系人：[kchuang] 黄嘉琪。
{ADJUST_SUBDOMAIN} 可以配置 Adjust 上报中转服务器，如果不需要，等号后面为空即可。
{ADJUST_URL_STRATEGY_IOS} 可以配置 Adjust 数据驻留的地区，如果不需要，等号后面为空即可。更多信息，请参见 Adjust 渠道配置。
{ADJUST_SIGNATURE_VERSION_IOS} 可以配置 Adjust 的签名版本，1 为 v1 签名，2 为 v2 签名。
将 {ADJUST_CHANNEL_START_EVENT_TOKEN_IOS} 替换为 Adjust 自定启动事件令牌。

[可选] Unity 引擎导出 Xcode

Unity 导出 Xcode 工程时，需要配置 .projmods 文件。

注意

游戏需要检查 INTLCoreKit.projmods 所写的配置。

{
    "group": "INTL",
    "libs": ["libz.tbd", "libsqlite3.tbd"],
    "frameworks": ["AdSupport.framework", "iAd.framework", "CoreTelephony.framework", "SystemConfiguration.framework"],
    "files": [],
    "folders": [],
    "excludes": [],
    "headerpaths":[],
    "build_settings":{},
    "system_capabilities": {},
    "Info.plist":{}
}

[可选] Deep Linking

配置 iOS 8 之前, iOS 9 之后, 并在 AppDelegate.m 中添加如下代码：

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

说明

如需支持 deferred deep linking 应用跳转功能，则需要 app.plist 中 Adjust 项下开启开关。

步骤2：配置 Adjust V2

联系 Adjust 提供签名插件 AdjustSigSdk.aar， AdjustSigSdk.framework 和验证签名的工具 adjust_sig_doctor。

Android

Unity
Unreal Engine

将申请到的 AdjustSigSdk.aar 放入 Player Network SDK Android 的插件目录 \Assets\Plugins\Android\AdjustSigSdk.aar。

将申请到的 AdjustSigSdk.aar 放入 Player Network SDK Android 的插件目录 Plugins\INTLSDK\Source\INTLAdjust\Libs\Android\libs\AdjustSigSdk.aar。

修改 Plugins\INTLSDK\Source\INTLAdjust\Libs\Android\INTLAdjust_APL.xml
并将 AdjustSigSdk.aar 拷贝到目标目录。

INTLAdjust_APL.xml
<!-- 拷贝文件或目录到Intermediate/Android/APK  -->
<resourceCopies>
<!--INTLAdjust_Start-->
<copyFile src="$S(PluginDir)/AdjustSigSdk.aar" dst="$S(BuildDir)/libs/AdjustSigSdk.aar"/>
<!--INTLAdjust_End-->
</resourceCopies>

iOS

Unity
Unreal Engine

在 Unity5/Asses/INTLSDK/Editor/XUPorter/Mods 游戏目录下创建一个名为 INTLAdjustSigKit.projmods 的文件，包含以下内容：

图片: enter app token

INTLAdjustSigKit.projmods
{
  "group":"INTL",
  "libs": [],
  "frameworks": [],
  "files": [],
  "folders": [],
  "excludes": [],
  "headerpaths": [],
  "build_settings": 
  {
    "OTHER_LDFLAGS": ["-force_load ${PROJECT_DIR}/Frameworks/Plugins/iOS/INTLSDK/INTLAdjust/ThirdSDK/AdjustSigSdk.framework/AdjustSigSdk"],
  },
  "system_capabilities": {
  },
  "Info.plist": {    
  },
}

将 AdjustSigSdk.framework 签名库放入 .../Plugins/iOS/INTLSDK/INTLAdjust/ThirdSDK 目录。

在 {game project directory}/Config/DefaultEngine.ini 的 [/Script/IOSRuntimeSettings.IOSRuntimeSettings] 配置中添加 AdditionalLinkerFlags=。

按照以下内容在 INTLPlugin.uplugin 中添加 PreBuildSteps：

INTLPlugin.uplugin
  "PreBuildSteps": {
      "Win64": [],
      "Mac": [
          "echo 'PreBuildSteps start!'",
          "pwd",
          "echo EngineDir = $(EngineDir)",
          "echo ProjectDir = $(ProjectDir)",
          "echo TargetName = $(TargetName)",
          "echo TargetPlatform = $(TargetPlatform)",
          "echo TargetConfiguration = $(TargetConfiguration)",
          "echo TargetType = $(TargetType)",
          "echo ProjectFile = $(ProjectFile)",
          "echo PluginDir = $(PluginDir)",
          "[ -d $(PluginDir)/Source/INTLAdjust/Libs/iOS/INTLAdjust ] && sed -i '' 's#AdditionalLinkerFlags=.*#AdditionalLinkerFlags=-force_load $(PluginDir)/Source/INTLAdjust/Libs/iOS/INTLAdjust/AdjustSigSdk.framework/AdjustSigSdk#g' $(ProjectDir)/Config/DefaultEngine.ini",
          "echo 'PreBuildSteps end!'"
      ]
  }

将 AdjustSigSdk.framework 签名库放入 $(PluginDir)/Source/INTLSDKPlugin/INTLSDK/iOS/INTLAdjust 目录。

集成 Sig

以 Windows 平台为例介绍 Sig 验证的步骤：

打开 adjust_sig_doctor 文件夹。
打开 windows_386。
执行 adjust_sig_doctor.exe。
输入 app token。
选择对应的 APK 并确认。
CLI 显示 APK INTEGRATION SUCCESSFUL，表示集成成功。

配置 INTLConfig.ini

在 INTLConfig.ini 中将 ADJUST_SIGNATURE_VERSION_ANDROID 和 ADJUST_SIGNATURE_VERSION_IOS 配置为 2。

INTLConfig.ini

ADJUST_SIGNATURE_VERSION_ANDROID = 2
ADJUST_SIGNATURE_VERSION_IOS = 2

步骤3：将跟踪令牌添加至 APK 包

Adjust tracker 的用户行为属性调整到源营地。Adjust 会为每个 tracker 会自动调整一个唯一的 tracker token。更多信息，请参见 Adjust 链接。

警告

必须支持 Adjust V2 签名。

自定义 Gradle 插件并创建一个任务。

project.afterEvaluate {
    ChannelMaker channelMaker = project.tasks.create("assemble${variantName}Channels", ChannelMaker);
    channelMaker.targetProject = project;
    channelMaker.variant = variant;
    channelMaker.setup();

    // task add dependencies
    if (variant.hasProperty('assembleProvider')) {
        channelMaker.dependsOn variant.assembleProvider.get()
    } else {
        channelMaker.dependsOn variant.assemble
    }
}   

在创建的任务中处理跟踪令牌逻辑。

警告

数据为大端模式.
协议头为固定的 new byte[]{-6, -106}.

获取传入数据

// get the input data
byte[] encode() throws IOException {
    ByteArrayOutputStream out = new ByteArrayOutputStream();
    // write protocol header
    out.write(new byte[]{-6, -106});
    String s = "adjustTrackerToken=${tracek_token}";
    byte[] bytes = s.getBytes("UTF-8");
    out.write(new ZipShort(bytes.length).getBytes());
    out.write(bytes);
    return out.toByteArray();
}

public final class ZipShort implements Cloneable {
    private int value;

    public ZipShort(byte[] bytes) {
        this(bytes, 0);
    }

    public ZipShort(byte[] bytes, int offset) {
        this.value = bytes[offset + 1] << 8 & '\uff00';
        this.value += bytes[offset] & 255;
    }

    public ZipShort(int value) {
        this.value = value;
    }

    public boolean equals(Object o) {
        if (o != null && o instanceof ZipShort) {
            return this.value == ((ZipShort)o).getValue();
        } else {
            return false;
        }
    }

    public byte[] getBytes() {
        byte[] result = new byte[]{(byte)(this.value & 255), (byte)((this.value & '\uff00') >> 8)};
        return result;
    }

    public int getValue() {
        return this.value;
    }

    public int hashCode() {
        return this.value;
    }
}

使用 blockid 0x717874 将数据写入 APKSigningBlock。

使用 ./gradlew assemble${variantName}Channels 构建 Gradle 包。
在日志视图中，输入 set default tracker : ${tracker_token} 查看 gradle 构建是否成功。

步骤4：配置事件上报

自动报告事件

如果在 INTLConfig.ini 文件中启用了 ANALYTICS_AUTH_REPORT_ENABLE 并且设置了 Adjust 的注册和登录令牌，Player Network SDK 将自动报告以下事件：

completed_registration：当用户第一次登录游戏的时候
login：当用户后续登录游戏的时候

手动报告事件

1. 创建新事件

进入 Adjust dashboard。
点击对应应用的选项图标（▲）。
点击 All Settings。
点击 Events。
在事件页面下方，输入事件名称并点击 CREATE 创建新的事件。

2. 获取事件 token（ID）

进入 Adjust dashboard。
点击对应应用的选项图标（▲）。
点击 All Settings。
点击 Events。
在对应事件的右侧查看事件 token。
在事件列表，根据业务的需求新增，删除和修改事件。

注意

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

3. 设置事件唯一性

注册事件时可以勾选事件唯一性，勾选后该事件上报一个设备只统计一次。

进入 Adjust dashboard。
点击对应应用的选项图标（▲）。
点击 All Settings。
点击 Events。
点击对应事件右侧的编辑按钮（铅笔图标）。
在事件编辑页面，勾选 Unique 并点击 UPDATE 完成设置事件的唯一性。

更多信息，请参见添加事件。

若使用 Adjust partner parameter，需要在 extraJson 中添加参数：
"{\"isPartnerParameters\":true}"
如果 extraJson 字段为空，或者设置 isPartnerParameters 为 false，则上报参数则会被设置到 Adjust 的 callback_params 中。
EventName 必须填写 event token 来追踪事件。详细信息，请参见 Adjust 事件跟踪。

更多信息，请参见 Analytics。

漏斗事件

注意

从 Player Network SDK V1.20 开始支持。

在 INTLConfig.ini 的 ADJUST_REPORT_FUNNEL_EVENTS_TOKEN_IOS（iOS 平台）和 ADJUST_REPORT_FUNNEL_EVENTS_TOKEN_ANDROID（Android 平台）配置中增加 Adjust 渠道中的需要上报的漏斗事件和事件对应 token，格式为 event1:token1,event2:token...。

[Adjust]
ADJUST_REPORT_FUNNEL_EVENTS_TOKEN_IOS = app_launch:your_token,confirm_login_channel:your_token,channel_auth_success:your_token,login_auth_success:your_token,query_complicance:your_token,select_region_and_age:your_token,agree_privacy_policy:your_token,privacy_auth_sucess:your_token,show_server_list:your_token,submit_area:your_token,confirm_area:your_token,connect_svr_success:your_token,show_user_agreement:your_token,finish_user_agreement:your_token,check_for_updates:your_token,download_updates:your_token,unzip_files:your_token,complete_updates:your_token,show_enter_game:your_token,click_into_game:your_token,enter_lobby_success:your_token,authentication:your_token,pull_up_the_list_of_goods:your_token,pull_up_price_list:your_token,start_order:your_token,successful_order:your_token,start_payment:your_token,successful_payment:your_token,start_delivery:your_token,successful_delivery:your_token,register_success:your_token
ADJUST_REPORT_FUNNEL_EVENTS_TOKEN_ANDROID = app_launch:your_token,confirm_login_channel:your_token,channel_auth_success:your_token,login_auth_success:your_token,query_complicance:your_token,select_region_and_age:your_token,agree_privacy_policy:your_token,privacy_auth_sucess:your_token,show_server_list:your_token,submit_area:your_token,confirm_area:your_token,connect_svr_success:your_token,show_user_agreement:your_token,finish_user_agreement:your_token,check_for_updates:your_token,download_updates:your_token,unzip_files:your_token,complete_updates:your_token,show_enter_game:your_token,click_into_game:your_token,enter_lobby_success:your_token,authentication:your_token,pull_up_the_list_of_goods:your_token,pull_up_price_list:your_token,start_order:your_token,successful_order:your_token,start_payment:your_token,successful_payment:your_token,start_delivery:your_token,successful_delivery:your_token,register_success:your_token

在 INTLConfig.ini 的 ANALYTICS_REPORT_FUNNEL_CHANNEL 配置中增加 Adjust 渠道，Player Network SDK 会将漏斗事件同步上报至 Adjust 渠道。

[ANALYTICS]
ANALYTICS_REPORT_FUNNEL_CHANNEL = Adjust

可以参考查询数据查看上报事件。

步骤5：初始化分析模块

Unity
Unreal Engine

初始化分析模块，再调用 ReportEvent 开始 Adjust 上报数据。

数据上报验收

文档参考

数据维度

Adjust 事件分为：

InstallEvent (UnInstallEvent/ReInstallEvent)
InAppEvent

更多关于事件的数据属性信息，请参见 Adjust 事件属性。

管理端查看上报事件

警告

事件非实时上报，延迟为1小时以上。

进入 Adjust dashboard，点击对应应用的选项图标（▲）。
点击 Statistics。
查看跟踪数据。

开启 Sandbox Mode 查看上报事件

注意

Sandbox Mode 下延迟为10分钟左右。

将数据报告到 Adjust Sandbox Mode：

在 INTLConfig.ini 的 DEBUG_CHANNEL 配置中添加 Adjust。
在 INTLConfig.ini 中设置 LOG_LEVEL = 1 或 LOG_LEVEL = 0。

在发布游戏并上报数据至 Adjust 正式环境时，设置 LOG_LEVEL = 3。

上报数据至 Adjust 正式环境，从配置的 INTLConfig.ini 的 DEBUG_CHANNEL 中删除 Adjust。

成功将数据上报至 Sandbox Mode 时，日志文件如下：

图片：Adjust Sandbox

进入 Adjust dashboard，点击对应应用的选项图标（▲）。
选择 所有设置 > 测试控制台。
输入广告 ID。
点击 查看设备数据 查看控制台上的测试数据。
[可选] 在同一台设备上多次测试安装事件或唯一事件的跟踪，选择 忘记设备 删除测试设备上的应用。
注意
Adjust 会在首次从未经识别的设备上打开应用时记录一次安装。这意味着每台设备上只能发生一次安装。
因此，在同一台设备上多次测试安装事件或唯一事件的跟踪，需要在测试控制台中使用 忘记设备 从 Adjust 抹除该设备，从而移除此设备的广告 ID 和活动历史。遗忘设备功能基于单个应用抹除设备。换言之，设备上先前跟踪的所有此应用的活动都会被移除。

查询数据

配置 INTLConfig.ini 启用客户端沙箱模式数据上报。
Adjust 管理端，开启 Sandbox Mode 查询数据。

图片：Adjust 沙箱数据

查看广告 ID

Android
iOS

在设备中选择 设置 > Google > 广告 即可查看本设备的广告 ID。

查看 Apple IDFA 需要使用第三方工具，App Store 上有大量具有此功能的应用程序可供选择。下文列出了一些可以向用户显示设备 IDFA 的常用 iOS 应用程序：

AppsFlyer 的 My Device ID
Adjust 的 Adjust Insights
在设备上打开应用并初始化 Player Network SDK，然后上传事件即可在控制面板获取 gps_adid 对应的字符串。

验收用例 1

子功能模块：Reporting
特性点：Event Reporting
测试点：游客登录，第一次登录，检查 Adjust 登录上报
前提条件：初始化分析模块
操作步骤/输入
1. 首次进行游客登录
2. 退出登录
3. 使用同一账号再次登录
4. 管理端，导出数据查看上报事件
预期输出信息上报成功，检查如下：
1. 管理端查看：
  1. 首次进行游客登录上报注册事件（adjust_complete_registration）：上报数量 +1
  2. 使用同一账号再次登录上报登录事件（adjust_login）：上报数量 +1
2. 导出数据验证：联系 [killuachen]，拉群导出日志来最终确认。
  1. 首次进行游客登录上报注册事件（adjust_complete_registration）：上报数量 +1
  2. 使用同一账号再次登录上报登录事件（adjust_login）：上报数量 +1
  3. 事件参数中里携带 Player Network SDK OpenID

验收用例 2

子功能模块：Reporting
特性点：Event Reporting
测试点: Facebook 登录，非第一次登录，检查 Adjust 登录上报
前提条件：初始化分析模块
操作步骤/输入
1. 使用 Facebook 首次登录
2. 退出登录
3. 使用同一账号再次登录
4. 管理端，导出数据查看上报事件
预期输出信息上报成功，检查如下：
1. 管理端查看：
  1. 首次进行游客登录上报注册事件（adjust_complete_registration）：上报数量 +1
  2. 使用同一账号再次登录上报登录事件（adjust_login）：上报数量 +1
2. 导出数据验证：联系 [killuachen]，拉群导出日志来最终确认。
  1. 首次进行游客登录上报注册事件（adjust_complete_registration）：上报数量 +1
  2. 使用同一账号再次登录上报登录事件（adjust_login）：上报数量 +1
  3. 事件参数中里携带 Player Network SDK OpenID

验收用例 3

子功能模块：Reporting
特性点：Event Reporting
测试点：Facebook 登录，第一次登录及非第一次登，检查 Adjust 登录上报
前提条件：初始化分析模块
操作步骤/输入
1. 首次进行 Facebook 登录
2. 退出登录
3. 使用同一账号再次登录
4. 管理端，导出数据查看上报事件
预期输出信息上报成功，检查如下：
1. 管理端查看：
  1. 首次进行游客登录上报注册事件（adjust_complete_registration）：上报数量 +1
  2. 使用同一账号再次登录上报登录事件（adjust_login）：上报数量 +1
2. 导出数据验证：
  1. 首次进行游客登录上报注册事件（adjust_complete_registration）：上报数量 +1
  2. 使用同一账号再次登录上报登录事件（adjust_login）：上报数量 +1
  3. Customer User ID 与 Player Network SDK OpenID 一致

验收用例 4

子功能模块：Reporting
特性点：Event Reporting
测试点：Adjust 事件信息上报成功
前提条件：初始化分析模块
操作步骤/输入
1. 请求 Report Event
2. eventName = Report_Event, paramsDic-key1=k1, paramsDic-value1=v1, paramsDic-key2=k2, paramsDic-value2=v2, spChannels=Adjust
3. 卸载安装 SDK 并启动游戏
4. 管理端查看上报数据并导出 INSTALL 数据表
预期输出信息上报成功，检查如下：
1. 管理端查看：
  1. 自定义事件：Adjust 可以查到上报自定义 Report_Event 事件数量加 1
  2. 安装事件：查看卸载安装 INSTALL 事件上报数量 +1（不清除设备只会上报一次）
2. 导出数据验证：联系 [killuachen] 拉群导出日志来最终确认。
  1. 自定义事件：对应上报数据正确（管理端和导出数据可以对应上）install_time={installed_at} 比对，是不是安装时间。event_name={event_name} 自定义的事件。
  2. 安装事件：卸载安装 INSTALL 数据表安装 Installs 上报数量 +1（不清除设备只会上报一次） activity_kind={activity_kind} 会新增一个安装。

验收用例 5

子功能模块：ReportRevenue
特性点：Adjust 支付事件上报
测试点：请求 ReportRevenue 后查询上报（Adjust）
前提条件：网络连接正常
操作步骤/输入
1. 请求 ReportRevenue
2. eventName = （可自定义）, spChannels = Adjust, Currency = USD, Revenue = 100
3. Adjust 查询上报事件
4. DD平台查询 AnalyticsReportRevenue 事件
预期输出信息上报成功，检查如下：
1. Adjust 交付数据中查看 ReportRevenue 事件 +1。 ReportRevenue（revenue）事件金额增加 100。
2. 导出数据验证（2-4 小时）：导出数据包含收入事件，金额数据
3. DD平台成功查询 methodName 为 AnalyticsReportRevenue 与 method_id=715 事件上报。

验收用例 6

子功能模块：ReportRevenue
特性点：Adjust 支付事件上报
测试点：断网状态下请求 ReportRevenue 后查询上报（Adjust）
前提条件：断开网络状态
操作步骤/输入
1. 请求 ReportRevenue
2. eventName = （可自定义）, spChannels = Adjust, Currency = USD, Revenue = 1000
3. 重新连接网络
4. Adjust 查询上报事件
5. DD平台查询 AnalyticsReportRevenue 事件
预期输出信息上报成功，检查如下：
1. 重新连接网络后
2. Adjust 交付数据中查看 ReportRevenue 事件 +1。 ReportRevenue（revenue）事件金额增加 1000。
3. 导出数据验证（2-4 小时）：导出数据包含收入事件，金额数据
4. DD平台成功查询 methodName 为 AnalyticsReportRevenue 与 method_id=715 事件上报。

常见问题

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

错误码

更多信息，请参见 Adjust 帮助中心。

前提条件​

步骤1：权限和工程配置​

Android​

iOS​

[可选] Unity 引擎导出 Xcode​

步骤2：配置 Adjust V2​

Android​

iOS​

集成 Sig​

配置 INTLConfig.ini​

步骤3：将跟踪令牌添加至 APK 包​

步骤4：配置事件上报​

自动报告事件​

手动报告事件​

漏斗事件​

步骤5：初始化分析模块​

数据上报验收​

文档参考​

数据维度​

管理端查看上报事件​

开启 Sandbox Mode 查看上报事件​

查询数据​

查看广告 ID​

验收用例 1​

验收用例 2​

验收用例 3​

验收用例 4​

验收用例 5​

验收用例 6​

常见问题​

错误码​

前提条件

步骤1：权限和工程配置

Android

iOS

[可选] Unity 引擎导出 Xcode

步骤2：配置 Adjust V2

Android

iOS

集成 Sig

配置 INTLConfig.ini

步骤3：将跟踪令牌添加至 APK 包

步骤4：配置事件上报

自动报告事件

手动报告事件

漏斗事件

步骤5：初始化分析模块

数据上报验收

文档参考

数据维度

管理端查看上报事件

开启 Sandbox Mode 查看上报事件

查询数据

查看广告 ID

验收用例 1

验收用例 2

验收用例 3

验收用例 4

验收用例 5

验收用例 6

常见问题

错误码