adjust-icon

Flutter SDK 集成指南

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

1. 添加 SDK 至您的项目

要在您的 Flutter 应用中使用 Adjust Flutter SDK,请先将 SDK 加入项目。

如需将 Adjust SDK 集成到您的 Flutter 项目中,请按照以下步骤操作:

  1. 添加下列行至您的 pubspec.yaml 文件:
pubspec.yaml
dependencies:
adjust_sdk: ^$FLUTTER_VERSION
  1. 找到您的项目并运行以下指令。编辑 pubspec.yaml 文件后,Visual Studio 会自动运行该命令。
Terminal window
$ flutter packages get

2. 设置安卓设备

添加 Google Play 服务

定向 Google Play 商店的应用必须使用 Google 广告 ID (gps_adid) 来识别设备。为此,请将以下 dependency 加入build.gradle 文件的 dependencies 部分。

build.gradle
implementation 'com.google.android.gms:play-services-ads-identifier:18.1.0'

添加权限

Adjust SDK 需要下列权限。(如尚未添加) 请将其添加至您的 AndroidManifest.xml 文件中:

AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET"/>

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

AndroidManifest.xml
<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>

设置 Install Referrer

Install Referrer 是一种唯一标识符,可用来将应用安装归因至来源。Adjust SDK 需要该信息进行归因。

Google Play Referrer API

要支持 Google Play Referrer API,请将下列行添加进您的 build.gradle 文件

build.gradle
implementation 'com.android.installreferrer:installreferrer:2.2'

Meta referrer 集成

通过 Adjust Meta Install Referrer 插件,Adjust SDK 可以支持 Meta Install Referrer要了解集成细节,请参考 Flutter Meta 安装 Referrer 插件。

3. 添加 iOS 框架

在应用中添加特定 iOS 框架后,Adjust SDK 就能获取额外信息。这些框架可以支持特定 SDK 功能,但即便没有这些框架,SDK 也能正常工作。您可以添加这些框架,然后在 Project Settings —> Build Phases —> Link Binary With Libraries 下将其设置为 可选

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

4. 设置 SDK 签名

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

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

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

5. 初始化 Adjust SDK

请确保在 Flutter 应用中尽快初始化 Adjust SDK。要进行 SDK 初始化,请使用应用识别码及您希望应用程序运行的环境来初始化 config 对象。

AdjustConfig config = new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
Adjust.initSdk(config);

6. 构建您的应用

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

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

7. 测试集成

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

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

测试 Google Play 服务集成

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

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