Cordova SDK 集成指南

通过 Adjust Cordova SDK，您可以在 Cordova 应用中监测归因、事件及更多数据。请按照本指南中说明的步骤操作，在应用内设置 Adjust SDK。您还可以在 GitHub 上查看示例应用。

1. 添加 SDK 至您的项目

Adjust Cordova SDK 在 npm 中作为插件提供。要将其添加到您的项目中，

Cordova 插件

如需将 Adjust Cordova SDK 添加至您的 Cordova 插件，请运行以下命令：

1
> cordova plugin add com.adjust.sdk
2
Fetching plugin "com.adjust.sdk" via npm
3
Installing "com.adjust.sdk" for android
4
Installing "com.adjust.sdk" for ios

Ionic

如果您使用 Ionic 构建应用，请运行以下命令从awesome-cordova-plugins库中添加 SDK 和 TypeScript typing：

1
> npm install @awesome-cordova-plugins/adjust --save
2
> ionic cordova plugin add com.adjust.sdk

2. 设置安卓设备

添加权限

Adjust SDK 默认包含 com.google.android.gms.AD_ID和android.permission.INTERNET权限。如果您的应用需要符合 COPPA 的要求或不针对 Google Play 商店，则可以通过添加remove指令将AD_ID删除。

1
<config-file target="AndroidManifest.xml" parent="/manifest">
2
  <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove" />
3
</config-file>

设置 Install Referrer

Adjust SDK 默认支持Google Play Referrer API。Meta Install Referrer 可作为安卓插件使用。要了解集成细节，请参考 Cordova Meta Install Referrer 插件。

3. 添加 iOS 框架

Adjust SDK 会自动在 iOS 设备上关联下列框架。

框架	描述	注意事项
`AdSupport.framework`	允许读取设备 IDFA。对于操作系统为 iOS 14 及更早版本的设备，添加该框架也会允许读取 LAT 信息。	如果您的应用属于 "儿童" 类别，那么请勿添加该框架
`AdServices.framework`	处理 Apple Search Ads 归因
`StoreKit.framework`	允许访问 SKAdNetwork 框架	若要允许 Adjust 处理 iOS 14 或更新操作版本设备上与 SKAdNetwork 的通讯，那么必须添加该框架。
`AppTrackingTransparency.framework`	若要允许 Adjust SDK 包装用户跟踪许可对话，并读取 iOS 14 或更新操作版本设备的许可响应，那么必须添加该框架。	如果您的应用属于 "儿童" 类别，那么请勿添加该框架

4. 设置 SDK 签名

如果您想使用 SDK 签名库来保护 Adjust SDK 与 Adjust 服务器之间的通信，请按照Adjust 帮助中心 SDK 签名指南中的说明进行操作。

5. 初始化 Adjust SDK

请确保在 Cordova 应用中尽快初始化 Adjust SDK。为此请进行下列操作：

请使用以下信息实例化一个AdjustConfig对象：
- appToken: 您的 Adjust 应用识别码。
- environment: 应用运行的环境。要在本地测试应用，请设置为AdjustConfig.EnvironmentSandbox。
将您的AdjustConfig实例传递至Adjust.initSdk方法来初始化 SDK。

1
var adjustConfig = new AdjustConfig(
2
   "{YourAppToken}",
3
   AdjustConfig.EnvironmentSandbox,
4
);
5
Adjust.initSdk(adjustConfig);

6. 构建您的应用

完成了！您现在可以创建并运行 Cordova 应用了。请启用日志，检查可能存在的问题。请查看日志中的 Install tracked 信息。

您现在已经准备就绪，可以使用 Adjust SDK 进行用户归因了。

7. 测试集成

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

将您的环境设为 AdjustConfig.EnvironmentSandbox
在 Adjust 控制面板结果中添加 sandbox 过滤器。
将日志级别设为 AdjustConfig.LogLevelVerbose。

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

测试 Google Play 服务集成

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

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