通过 Adjust Cordova SDK,您可以在 Cordova 应用中监测归因、事件及更多数据。请按照本指南中说明的步骤操作,在应用内设置 Adjust SDK。您还可以在 GitHub 上查看示例应用。
1. 添加 SDK 至您的项目
Adjust Cordova SDK 在 npm 中作为插件提供。要将其添加到您的项目中,
Cordova 插件
如需将 Adjust Cordova SDK 添加至您的 Cordova 插件,请运行以下命令:
Ionic
如果您使用 Ionic 构建应用,请运行以下命令从awesome-cordova-plugins
库中添加 SDK 和 TypeScript typing:
2. 设置安卓设备
添加权限
Adjust SDK 默认包含 com.google.android.gms.AD_ID
和android.permission.INTERNET
权限。如果您的应用需要符合 COPPA 的要求或不针对 Google Play 商店,则可以通过添加remove
指令将AD_ID
删除。
设置 Install Referrer
Adjust SDK 默认支持Google Play Referrer API。对于安卓端,Huawei Referrer API 和 Meta Install Referrer 可作为插件使用。请参考相关文档,为您的安卓应用设置插件。
Meta referrer 集成
要启用 Meta Install Referrer,您需要在AdjustConfig
实例中设置 Meta 应用 ID。为此请进行下列操作:
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 v5 包含 SDK 签名库。请按照iOS和安卓测试指南操作,确保集成正确运行。
签名保护功能默认处于禁用状态。要启用该功能,您需要:
- 执行签名验证。
- 在测试前提供应用的 SHA-1 指纹。
5. 初始化 Adjust SDK
请确保在 Cordova 应用中尽快初始化 Adjust SDK。为此请进行下列操作:
-
请使用以下信息实例化一个
AdjustConfig
对象:appToken
: 您的 Adjust 应用识别码。environment
: 应用运行的环境。要在本地测试应用,请设置为AdjustConfig.EnvironmentSandbox
。
-
将您的
AdjustConfig
实例传递至Adjust.initSdk
方法来初始化 SDK。
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。