开始使用 React Native SDK
通过 Adjust React Native SDK,您可以在自己的 React Native 应用中跟踪归因、事件及更多数据。请按照本指南中说明的步骤操作,在应用内设置 Adjust SDK。您还可以在GitHub上查看我们的示例应用。
1. 添加 SDK 至您的项目
要在您的 React Native 应用中使用 Adjust SDK,请先将 SDK 加入项目。请按以下步骤添加:
- 使用以下方法之一下载 React Native 库。
- 在您的终端运行以下指令来为您的 iOS 应用安装 CocoaPods 依赖:
$ cd ios && pod install
2. 集成 SDK
要将 SDK 集成进项目,您必须先将 Adjust 的 SDK 配置导入主要应用 Javascript 文件。
在应用的.js
文件开始处加入以下行:
import { Adjust, AdjustEvent, AdjustConfig } from 'react-native-adjust';
3. 初始化 Adjust SDK
请确保在 React Native 应用中尽快初始化 Adjust SDK。要进行 SDK 初始化,请使用应用识别码及您希望应用程序运行的环境来初始化 config 对象。
向应用的.js
文件中加入以下代码行:
传递AdjustConfig
参数:
- 用您的识别码替换
{YourAppToken}
。请查看应用设置,了解查找识别码的办法。 - 选择您的 环境 :
- 如要测试应用并发送测试数据,请使用
AdjustConfig.EnvironmentSandbox
。请在 Datascape 中启用 sandbox 模式,查看测试数据。 - 如果您已经完成测试,准备发布应用,请使用
AdjustConfig.EnvironmentProduction
。
- 如要测试应用并发送测试数据,请使用
AdjustEnvironment.sandbox
。请在向 App Store 提交应用程序前将此设为 AdjustEnvironment.production
。
4. 设置安卓设备
添加权限
Adjust SDK 需要下列权限。(如尚未添加) 请将其添加至您的 AndroidManifest.xml
文件中:
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
ACCESS_WIFI_STATE
权限。如果您在应用其他地方也不需要,则可以将其移除。
从 Adjust SDK 4.32.0 及以上版本默认包含 com.google.android.gms.AD_ID
权限。如果您的应用需要符合 COPPA 的要求或不针对 Google Play 商店,则可以通过添加 remove
指令将其删除。
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
请查看 Google 的 AdvertisingIdClient.info 文档,了解更多与该许可相关的信息。
添加 Google Play 服务
针对 Google Play 商店的应用必须使用 Google 广告 ID (gps_adid
) 来识别设备。为此,请将以下 dependency 加入build.gradle
文件的 dependencies
部分。
implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
play-services-ads-identifier
dependency 绑定。您可以使用任意版本的 Google Play 服务库。
设置 Proguard
如果您使用的是 Proguard,请将以下规则添加至您的 Proguard 文件。
-keep 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 是一种归因机制,可用来将应用安装归因至来源。包含两部分:
- 来自这些应用商店的一系列 API,开发者借此可在应用中调取 referral 内容。
- Google Play 和 Huawei App Gallery 等应用商店在其商店网站应用页面 URL 中接受的 referrer 参数。referrer 参数按以下方式填充:
- 用户点击 Adjust 跟踪链接时,Adjust 服务器发送一个独一无二的识别码,即
reftag
。该识别码被指配给此点击,并被添加至 referrer 参数。要进一步了解reftag
,请访问reftag页面。 - 您在开展Google Ads推广活动时,Google 会传递一个叫做
gclid
的唯一识别码至 referrer 参数。您必须在 Google Ads 账户中开启 auto-tagging 。
- 用户点击 Adjust 跟踪链接时,Adjust 服务器发送一个独一无二的识别码,即
5. 添加 iOS 框架
在应用中添加特定 iOS 框架后,Adjust SDK 就能获取额外信息。这些框架可以支持特定 SDK 功能,但即便没有这些框架,SDK 也能正常工作。您可以添加这些框架,然后在 Project Settings > Build Phases > Link Binary With Libraries 下将其设置为可选。
框架 | 描述 | 注意事项 |
---|---|---|
AdSupport.framework | 如果您希望 SDK 能访问 IDFA 值和 (iOS 14 以前的) LAT 信息,请添加该框架。 | 如果您的应用属于 "儿童" (Kids) 类别,请不要安装该框架。 |
AdServices.framework | 该框架对于处理 Apple Search Ads 是必要的。 | |
StoreKit.framework | 如果您希望访问 SKAdNetwork 框架,同时让 Adjust SDK 在 iOS 14 或未来版本的 iOS 中自动处理与该框架的通讯,请添加该框架。 | |
AppTrackingTransparency.framework | 如果您希望 SDK 能在 iOS 14 或未来版本的 iOS 中包装用户的跟踪许可对话框,并访问用户的许可响应,请添加该框架。 | 如果您的应用属于 "儿童" (Kids) 类别,请不要安装该框架。 |
6. 添加 Adjust SDK 签名
Adjust SDK 签名可以用来签署 Adjust SDK 发送的所有通讯。这样,Adjust 的服务器就能轻松甄别、拒绝任何非法安装活动。
要开始使用 Adjust SDK 签名,请联系您的技术客户经理,或发送邮件至 support@adjust.com。
7. 测试集成
采用 Adjust SDK 提供的工具,您可以测试并排除集成出现的问题。要测试集成,请按照下列步骤操作:
- 将环境设为 Sandbox 。
- 在 Datascape 中添加一个sandbox 过滤器。
- 将日志级别设为 verbose 。