开始使用

通过 Adjust Unity SDK,您可以在 Unity 应用中监测归因、事件以及更多信息。请按照本指南中说明的步骤对应用进行设置,以便使用 Adjust SDK。

重要提示:
Adjust SDK 支持 iOS 9 或更新版本,以及安卓 API 级别 9 (Gingerbread) 或更新版本。

1. 获取 Adjust SDK

要在您的 Unity 应用中使用 Adjust SDK,请先将 SDK 加入项目。您可以从我们的GitHub 发布页面下载最新版本的 SDK。

要向 Unity 项目中导入 Adjust SDK,请按照下列步骤操作:

  1. 打开 Unity Editor。
  2. 选择 Assets​ -> Import Package​ -> Custom Package​ 。
  3. 选择已下载的 SDK 包。

2. 集成 SDK

Adjust SDK 包含一个 Unity prefab ,其中含有模板游戏对象和 Adjust 脚本。您可以使用该脚本配置 SDK。要在 Unity editor 中打开 prefab,请按照下列步骤操作:

  1. Assets/Adjust/Adjust.prefab 的 prefab 添加到您的第一个场景。
  2. 打开 prefab 的 Inspector Menu​ 。

prefab 菜单包含可编辑的字段,通过这些字段,您可以控制 Adjust SDK 的行为。

要设置 Adjust SDK,请输入下列信息:

  1. 您的 应用识别码​ 。请查看应用设置,了解查找识别码的办法。

  2. 您的 环境​ :

    • 如要测试应用并发送测试数据,请选择 Sandbox​ 。请在控制面板中启用 sandbox 模式,查看测试数据。
    • 如果您已经完成测试,准备发布应用,请选择 Production​ 。
  3. 您的 日志等级。​ 这将控制您收到哪些日志。请查看这篇文章,进一步了解日志等级设置。

默认情况下,应用的 Awake 事件触发时,Adjust SDK 就会初始化。要改变该行为,请勾选 手动启动 SDK​ 。这样您就能使用 config 实例作为参数,调用 Adjust.start() 以初始化 Adjust SDK。

C#
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
…
Adjust.start(adjustConfig);

3. 设置安卓设备

添加 Google Play 服务

定向到 Google Play 商店的应用必须使用 Google 广告 ID (gps_adid) 来识别设备。要访问 gps_adid,请向项目中添加 play-services-ads-identifier AAR。

Google External Dependency Manager

手动安装

收集 App Set Identifier

请注意:
Adjust SDK v4.33.1 及更新版本中可使用 App Set ID。

App Set Identifier 是一个唯一标识符,用户在设备上安装您的应用后,您可以通过此标识符监测这些应用的信息。同一位开发者开发的所有应用共享同一个 App Set ID,也就是说您可以从所有应用中收集有用的洞见。

Google External Dependency Manager

手动安装

设置 Proguard

如果您使用的是 Proguard,请将这些规则添加至您的自定义 Proguard 文件

-keep public class com.adjust.sdk.**{ *; }
-keep class com.google.android.gms.common.ConnectionResult {
    int SUCCESS;
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
    com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
    java.lang.String getId();
    boolean isLimitAdTrackingEnabled();
}
-keep public class com.android.installreferrer.**{ *; }

设置 Install Referrer

Install Referrer 是一种唯一标识符,可用来将应用安装归因至来源。Adjust SDK 需要该信息进行归因。您可以用下列 2 种方法收集 install referrer,具体选择哪一种视定向到的应用商店而定:

Google Play Referrer API

华为 Referrer API

Meta referrer 集成

4. 添加 iOS 隐私清单

iOS 17 引入了隐私清单功能。该机制要求您向 App Store 说明应用的隐私要求。Adjust Unity SDK 不包含此隐私清单文件,因此,如果您的应用定向 iOS 17 或更新操作系统设备,则需要确保将 Adjust iOS SDK 隐私清单文件包含在您的应用隐私清单中。

要添加 Adjust 隐私清单:

  1. 确保您正在使用 Adjust Unity SDK v4.38.0 或更新版本。
  2. 如果您还未创建隐私清单,请进行创建
  3. GitHub下载PrivacyInfo.xcprivacy文件或复制其内容。
  4. 确保将 Adjust 的PrivacyInfo.xcprivacy文件内容包含在您自己的隐私清单文件中。

当您向 App Store 提交应用时,Adjust 的隐私声明会被包含在您的应用内。

5. 创建您的应用

如需完成应用创建流程,Adjust Unity 包需执行自定义创建后操作,以确保 Adjust SDK 可以在应用内正常运行。

此过程由 AdjustEditor.cs中的 OnPostprocessBuild 方法执行。导出日志会显示在 Unity IDE 控制台输出窗口中。

iOS

安卓

6. 添加 Adjust SDK 签名

Adjust SDK 签名可以用来签署 Adjust SDK 发送的所有通讯。这样,Adjust 的服务器就能轻松甄别、拒绝任何非法安装活动。

要开始使用 Adjust SDK 签名,请联系您的技术客户经理,或发送邮件至 support@adjust.com

7. 测试集成

采用 Adjust SDK 提供的工具,您可以测试并排除集成出现的问题。要测试集成,请按照下列步骤操作:

提示:
如果遇到任何问题,请发送邮件至 support@adjust.com ,并在邮件中说明所有详情和日志。

测试 Google Play 服务集成