如果您无法将设备端转化衡量解决方案直接与 Google Analytics for Firebase (GA4F) SDK 集成,则可以使用独立 SDK 来实现此集成。
在本文中,您将了解如何集成和使用设备端转化衡量 SDK 以及排查相关问题。
详情请参阅 iOS 应用广告系列的设备端转化衡量简介一文。
本页内容
集成独立 SDK
您可以通过 CocoaPods 和 Swift Package Manager 获取设备端转化衡量独立 SDK。
Swift Package Manager
- 在 Xcode 中,依次选择 File(文件)和 Add Packages(添加软件包)。
- 在提示中选择 GoogleAdsOnDeviceConversion GitHub repository(GoogleAdsOnDeviceConversion GitHub 代码库)。
完成之后,Xcode 将开始解析您的软件包依赖项,并在后台下载它们。
CocoaPods
- 将 GoogleAdsOnDeviceConversion pod 添加到您的 Podfile 中。
pod 'GoogleAdsOnDeviceConversion'
- 运行
pod install --repo-update。
使用 GoogleAdsOnDeviceConversion SDK
获取设备端转化衡量 SDK 后,请在应用首次启动后立即提取转化信息,包括 first_open 和 reinstall_open 转化。
Swift
- 安装 GoogleAdsOnDeviceConversion SDK,为 iOS 应用广告系列启用可保护隐私的设备端转化衡量。
import GoogleAdsOnDeviceConversion
- 将时间设置为应用首次启动的时间。
ConversionManager.sharedInstance.setFirstLaunchTime(Date())
- 提取转化信息。
ConversionManager.sharedInstance.fetchAggregateConversionInfo(for: .installation)
{ aggregateConversionInfo, error in
guard error == nil else { return }
guard let info = aggregateConversionInfo else { return }
guard info.count > 0 else { return }
print("Conversion info \(info)")
}
Objective C
- 安装 GoogleAdsOnDeviceConversion SDK,为 iOS 应用广告系列启用可保护隐私的设备端转化衡量。
import GoogleAdsOnDeviceConversion
- 将时间设置为应用首次启动的时间。
[[ODCConversionManager sharedInstance] setFirstLaunchTime:[NSDate date]];
- 提取转化信息。
[[ODCConversionManager sharedInstance]
fetchAggregateConversionInfoForInteraction:ODCInteractionTypeInstallation
completion:^(NSString * _Nullable aggregateConversionInfo,
NSError * _Nullable error) {
if (error) return;
if (aggregateConversionInfo.length == 0) return;
NSLog(@"Conversion info %@", aggregateConversionInfo);
// 将 aggregateConversionInfo 用作 App Conversion API 中 odm_info 查询
// 参数的值。// 例如,若 aggregateConversionInfo 为“abcdEfadGdaf”,
// 则 odm_info=abcdEfadGdaf。
}];
问题排查步骤
-
检查传递给
setFirstLaunchTime()的日期是否为应用首次启动的时间。 -
检查您的应用是否在欧洲经济区 (EEA)、英国和瑞士运行。
确保将 info 用作 App Conversion API 中 odm_info 查询参数的值。
// 例如,若 info 为“abcdEfadGdaf”,则 odm_info=abcdEfadGdaf