Unity SDK 集成

通过 Adjust Unity SDK，您可以在 Unity 应用中记录归因、事件以及更多信息。请按照本指南中说明的步骤操作，在应用内设置 Adjust SDK。

1. 获取 Adjust SDK

要安装 Adjust SDK，请选择下列方法之一。

安装 Unity 包

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

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

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

使用 Unity Package Manager

要使用 Unity Package Manager 安装 Adjust SDK，请按照下列步骤操作：

1. 在 Unity 编辑器中选择 Package Manager 窗口。
2. 选择 Add package from git URL 。
3. 输入以下 URL：https://github.com/adjust/unity_sdk.git?path=Assets/Adjust .

2. 安装 iOS 和安卓 SDK

SDK v5 不再使用 iOS 和安卓 SDK 作为二进制依赖。要安装底层 iOS 和安卓 SDK，您需要使用External Dependency Manager for Unity (EDM4U)从 CocoaPods 和 Maven 安装包。

要确保为 iOS 正确加载隐私清单和框架，您需要禁用静态链接。为此请进行下列操作：

1. 选择 Assets -> External Dependency Manager -> iOS Resolver -> Settings 。
2. 找到 Link frameworks statically 选项并取消选中。

3. 集成 SDK

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

1. 将 Assets/Adjust/Adjust.prefab 的 prefab 添加到您的第一个场景。
2. 打开 prefab 的 Inspector Menu。
3. prefab 菜单包含可编辑的字段，通过这些字段，您可以控制 Adjust SDK 的行为。

要设置 Adjust SDK，请输入下列信息：

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

2. 您的 环境 ：

   • 如要测试应用并发送测试数据，请选择 Sandbox 。请在控制面板中启用 sandbox 模式，查看测试数据。
   • 如果您已经完成测试，准备发布应用，请选择 Production 。

3. 您的 日志等级。 这将控制您收到哪些日志。请查看这篇文章，进一步了解日志等级设置。

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

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
Adjust.InitSdk(adjustConfig);
// ...

4. 设置安卓设备

添加 Google Play 服务

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

收集 App Set Identifier

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

设置 Install Referrer

Install Referrer 是一种唯一标识符，可用来将应用安装归因至来源。Adjust SDK 需要该信息进行归因。您可以使用Google Play Referrer API收集此信息。

您可以使用两种方式为 Google Play Referrer API 添加支持：

Meta referrer 集成

Adjust SDK 支持Meta Install Referrer 。要启用该功能：

1. 在应用控制面板中找到您的 Meta app ID。更多信息，请参考 Meta 的应用控制面板文档。
2. 将 Meta 应用添加至您的AndroidManifest.xml文件。

<queries>
   <package android:name="com.facebook.katana" />
</queries>

<queries>
   <package android:name="com.instagram.android" />
</queries>

3. 将AdjustConfig实例的FbAppId属性设置为您的应用 ID。

   AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
   //...
   config.FbAppId = "{FB_APP_ID_STRING}";
   //...
   Adjust.InitSdk(config);

5. 设置 SDK 签名

SDK v5 包含 SDK 签名库。请按照iOS和安卓测试指南操作，确保集成正确运行。

签名保护功能默认处于禁用状态。要启用该功能，您需要：

1. 执行签名验证。
2. 在测试前提供应用的 SHA-1 指纹。

6. 构建您的应用

如需完成应用创建流程，Adjust Unity 包需执行自定义创建后操作，以确保 Adjust SDK 可以在应用内如常运行。 此过程由 AdjustEditor.cs 中的 OnPostprocessBuild 方法执行。

您可以配置构建后选项来自定义应用版本。

该过程的输出显示在 Unity IDE 控制台窗口中。

7. 测试集成

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

• 将您的环境设为 AdjustEnvironment.Sandbox
• 在 Adjust 控制面板结果中添加 sandbox 过滤器。
• 将日志级别设为 AdjustLogLevel.Verbose。

测试 Google Play 服务集成

要测试 Adjust SDK 能否接收设备的 Google 广告 ID，请将日志级别设为 AdjustLogLevel.Verbose，环境设为 AdjustEnvironment.Sandbox。启动应用，监测一次 session 或事件。如果 SDK 记录了 gps_adid (Google Play 服务广告主 ID) 参数，就说明已经成功读取广告 ID。

如果您在获取 Google 广告 ID 时遇到任何问题，请在 GitHub 库中提问，或联系 support@adjust.com。