开始使用 通过 Adjust Unity SDK,您可以在 Unity 应用中监测归因、事件以及更多信息。请按照本指南中说明的步骤对应用进行设置,以便使用 Adjust SDK。
Adjust SDK 支持 iOS 9 或更新版本,以及安卓 API 级别 9 (Gingerbread) 或更新版本。
要在您的 Unity 应用中使用 Adjust SDK,请先将 SDK 加入项目。您可以从我们的GitHub 发布页面 下载最新版本的 SDK。
要向 Unity 项目中导入 Adjust SDK,请按照下列步骤操作:
打开 Unity Editor。 选择 Assets -> Import Package -> Custom Package 。 选择已下载的 SDK 包。 Adjust SDK 包含一个 Unity prefab ,其中含有模板游戏对象和 Adjust
脚本。您可以使用该脚本配置 SDK。要在 Unity editor 中打开 prefab,请按照下列步骤操作:
将 Assets/Adjust/Adjust.prefab
的 prefab 添加到您的第一个场景。 打开 prefab 的 Inspector Menu 。 prefab 菜单包含可编辑的字段,通过这些字段,您可以控制 Adjust SDK 的行为。
Adjust SDK 在 Unity editor 中的 prefab 配置脚本截图。
要设置 Adjust SDK,请输入下列信息:
您的 应用识别码 。请查看应用设置 ,了解查找识别码的办法。
您的 环境 :
如要测试应用 并发送测试数据,请选择 Sandbox 。请在控制面板中启用 sandbox 模式 ,查看测试数据。 如果您已经完成测试,准备发布应用,请选择 Production 。 您的 日志等级。 这将控制您收到哪些日志。请查看这篇文章 ,进一步了解日志等级设置。
默认情况下,应用的 Awake
事件触发时,Adjust SDK 就会初始化。要改变该行为,请勾选 手动启动 SDK 。这样您就能使用 config 实例作为参数,调用 Adjust.start()
以初始化 Adjust SDK。
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
…
Adjust.start(adjustConfig);
定向到 Google Play 商店的应用必须使用 Google 广告 ID (gps_adid
) 来识别设备。要访问 gps_adid
,请向项目中添加 play-services-ads-identifier
AAR。
全部展开
Google External Dependency Manager 如果您使用的是 Google External Dependency Manager 插件 ,请将下列行添加至您的 Dependencies.xml
文件:
<androidpackages>
<androidpackage spec="com.google.android.gms:play-services-ads-identifier:18.0.1" />
</androidPackages>
要手动安装 ARR,请 从 Maven 下载 并添加至 Assets/Plugins/Android
目录。
Adjust SDK v4.33.1 及更新版本中可使用 App Set ID。
App Set Identifier 是一个唯一标识符,用户在设备上安装您的应用后,您可以通过此标识符监测这些应用的信息。同一位开发者开发的所有应用共享同一个 App Set ID,也就是说您可以从所有应用中收集有用的洞见。
全部展开
Google External Dependency Manager 要记录设备的 App Set ID,您需要将以下依赖添加至您的 Dependencies.xml
文件:
<androidpackages>
<androidpackage spec="com.google.android.gms:play-services-appset:16.0.2" />
</androidPackages>
要手动安装 ARR (Android Archive),请 从 Maven 下载 并添加至 Assets/Plugins/Android
目录。
如果您使用的是 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 是一种唯一标识符,可用来将应用安装归因至来源。Adjust SDK 需要该信息进行归因。您可以用下列 2 种方法收集 install referrer,具体选择哪一种视定向到的应用商店而定:
全部展开
您可以使用两种方式为 Google Play Referrer API 添加支持:
在 自定义 build.gradle
文件 中将 Install Referrer 库添加为 dependency
dependencies {
implementation 'com.android.installreferrer:installreferrer:2.2'
}
从 Maven 下载 Install Referrer 库并将 AAR
文件放入您的 Plugins/Android
文件夹中。 从版本 v4.21.1 开始,Adjust SDK 将支持对装有华为 App Gallery 10.4 或更新版本的设备进行安装跟踪。您无需其他调整和变更,就可以开始使用华为 Referrer API。
Adjust SDK v4.36.0 及更高版本支持Meta Install Referrer 。要启用该功能:
在应用控制面板 中找到您的 Meta app ID。更多信息,请参考 Meta 的应用控制面板文档 。
将 Meta 应用添加至您的AndroidManifest.xml
文件 。
<queries>
<package android:name="com.facebook.katana" />
</queries>
<queries>
<package android:name="com.instagram.android" />
</queries>
将应用 ID 作为 字符串 参数传递至AdjustConfig.setFbAppId
方法。
AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
//...
config.setFbAppId("{FB_APP_ID_STRING}");
//...
Adjust.start(config);
如需完成应用创建流程,Adjust Unity 包需执行自定义创建后操作,以确保 Adjust SDK 可以在应用内正常运行。
此过程由 AdjustEditor.cs
中的 OnPostprocessBuild
方法执行。导出日志会显示在 Unity IDE 控制台输出窗口中。
Adjust SDK 在 Unity editor 中的创建后配置脚本截图。
全部展开
要执行 iOS 创建后流程,请确保已在 Unity editor 中安装
iOS 创建支持 。
iOS 创建后流程会对生成的 Xcode 项目作出以下更改:
添加其他链接器标记 (other linker flag) -ObjC
– 在创建时识别 Adjust Objective-C 类别所需。 启用 Objective-C 例外情况 框架 您可以启用下列框架,访问 iOS 功能:
AdServices.framework – 用于 Apple Search Ads 跟踪。AdSupport.framework – 用来读取设备 IDFA。AppTrackingTransparency.framework – 用来请求用户授予跟踪许可,并获知用户许可状态。StoreKit.framework – 用来与 SKAdNetwork 框架通讯。ATT 许可对话 如果您使用了 ATT 包装器 ,请输入一条 用户跟踪描述 消息。该消息会在用户收到跟踪请求许可对话弹窗时展示。
深度链接 要启用深度链接 ,请添加下列信息:
安卓创建后流程会在 Assets/Plugins/Android/
中查找 AndroidManifest.xml
文件。如果不存在该文件,则从 AdjustAndroidManifest.xml
中创建副本。
权限 您可以启用下列许可,访问安卓功能:
android.permission.INTERNET – 连接到网络所需。android.permission.ACCESS_NETWORK_STATE – 读取设备所连接到的网络类型所需com.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE (deprecated) – 通过 Google Play 商店 intent 获取 Install Referrer 信息时所需com.google.android.gms.permission.AD_ID – 读取安卓 12 (API 等级 31) 及以上系统设备的广告 ID 所需。请查看 Google 的 AdvertisingIdClient.info
文档 ,了解更多信息。深度链接 要启用深度链接 ,请添加下列信息:
Adjust SDK 签名可以用来签署 Adjust SDK 发送的所有通讯。这样,Adjust 的服务器就能轻松甄别、拒绝任何非法安装活动。
要开始使用 Adjust SDK 签名,请联系您的技术客户经理,或发送邮件至 support@adjust.com 。
采用 Adjust SDK 提供的工具,您可以测试并排除集成出现的问题。要测试集成,请按照下列步骤操作:
要测试 Adjust SDK 能否接收设备的 Google 广告 ID,请将日志级别 设为 verbose ,环境 设为 Sandbox 。启动应用,监测一次会话或事件。如果 SDK 读取了广告 ID,就会记录 gps_adid
参数。
如果您在获取 Google 广告 ID 时遇到任何问题,请在我们的 GitHub 库 中提问,或联系 support@adjust.com 。