通过 Google 的设备端转化衡量 (ODM),您可以在不依赖 IDFA 的情况下,将应用活动归因至 Google Ads iOS 推广活动。ODM 可以改善推广活动优化和评估准确性,同时将可识别信息保留在设备端,从而更好地保护用户隐私。
此集成需要 Adjust ODM 插件。
设置环境
请使用 ODM 子规格 (subspec) 而不是 Adjust core pod:
pod 'Adjust/AdjustGoogleOdm' # replaces 'Adjust', do not include both
如果您的应用使用 Google Analytics for Firebase SDK 11.14.0 或更高版本 ,则 GoogleAdsOnDeviceConversion 依赖项会自动包含在 FirebaseAnalytics pod 中。无需单独添加。
如果您的应用未使用 Google Analytics for Firebase SDK ,请添加 GoogleAdsOnDeviceConversion pod:
pod 'GoogleAdsOnDeviceConversion', '3.0.0'
- 在 Xcode 中选择 File > Add Package Dependencies…
- 添加 Adjust SDK 包:
https://github.com/adjust/ios_sdk
- 在版本下拉菜单中选择要使用的 Adjust SDK 版本。请查看发布页面,找到最新版本。
- 请仅为应用定向选择
AdjustGoogleOdm 产品,因为它包括 Adjust Core。请勿同时添加 AdjustSdk。
要手动向应用添加 ODM 功能,请按照下列步骤操作:
-
将 Adjust 框架添加至您的应用。
-
下载 Adjust SDK 和 ODM 插件 (发布列表)。
-
下载 Adjust Signature SDK (发布列表)。
-
在 Xcode 中将下列框架拖拽至您的项目中 (例如,根项目文件夹或 Frameworks 文件夹)
AdjustSdk.xcframework 或 AdjustSdk.framework
AdjustOdmPlugin.xcframework 或 AdjustOdmPlugin.framework
AdjustSigSdk.xcframework
-
在显示的对话框中,针对每个框架选择 Copy files to destination 并将其添加到您的应用目标。
-
在应用定向的项目编辑器中,打开 General 选项卡,然后滚动至 Frameworks, Libraries, and Embedded Content 。对于动态框架,请在 Embed 字段中选择 Embed & Sign 。对于静态框架,请选择 Do Not Embed 。
-
添加 Google 依赖框架。
如果您的应用使用 Google Analytics for Firebase SDK 11.14.0 或更高版本 ,则可以跳过此步骤,因为 Firebase 已包含必要的 Google 依赖项。
如果您的应用未使用 Google Analytics for Firebase SDK :
-
下载 Firebase iOS SDK (发布列表) 并解压缩。
-
在 Xcode 中将下列框架从 Firebase/FirebaseAnalytics 文件夹拖拽至您的项目中:
GoogleAdsOnDeviceConversion.xcframework
GoogleUtilities.xcframework
nanopb.xcframework
-
在显示的对话框中,针对每个框架选择 Copy files to destination 并将其添加到您的应用目标。
-
在应用定向的项目编辑器中,打开 General 选项卡,然后滚动至 Frameworks, Libraries, and Embedded Content 。验证这些框架是否已列出。由于这些框架为静态库,因此请在 Embed 字段中选择 Do Not Embed 。
-
在 其他链接器标记 中添加标记:
- 在目标应用的项目编辑器中,打开 Build Settings 标签页,选择 All ,然后搜索
Other Linker Flags。
- 将每个标记添加为单独的条目:
-ObjC: 确保链接器从静态库中加载所有 Objective-C 类和类别,这是 Adjust SDK 在运行时发现 ODM 插件所必需的。
-lc++: 链接 C++ 标准库,这是 GoogleAdsOnDeviceConversion 框架所必需的。
记录应用启动时间
使用“设备端转化衡量”进行准确归因时,其中一个最关键的因素是尽可能精确地记录应用启动时间。Adjust SDK 会在初始化过程中自动处理此操作。因此,务必在应用启动序列中尽早调用 initSdk 方法,理想情况下是在应用委托的 application:didFinishLaunchingWithOptions: 方法中调用。
如果应用的逻辑要求 SDK 向 Adjust 服务器发送数据时延迟,请按以下顺序操作:
- 在 Adjust SDK 配置中设置首次会话延迟。
- 像往常一样,在应用启动时尽早调用
initSdk。SDK 立即开始运行,ODM 记录此时的应用启动时间。
- 应用完成其逻辑后,请结束首次会话延迟,以便 SDK 开始向 Adjust 服务器发送数据。