教程：衡量 iOS 广告转化

第 3 步：使用 Google Analytics 启动设备上转化衡量

简介：衡量 iOS 广告转化

第 1 步：实现登录体验

第 2 步：集成 Google Analytics

第 3 步：使用 Google Analytics 启动设备上转化衡量

步骤 4：排查并处理常见问题

现在您可以收集用户的电子邮件地址和电话号码，并且您的应用具有 Google Analytics for Firebase SDK，您可以使用这两者来开始衡量转化情况。

调用API

使用步骤 1 中同意的电子邮件地址或电话号码调用转化衡量 API，用于广告转化衡量，而不允许任何个人身份信息离开用户设备。

有两种方法可以启动测量：

• 使用凭据
• 使用散列凭据

使用电子邮件地址或电话号码

迅速

导入FirebaseAnalytics模块并将电子邮件地址或电话号码传递到initiateOnDeviceConversionMeasurement() API。

注意：可以按顺序调用initiateOnDeviceConversionMeasurement(emailAddress:)和initiateOnDeviceConversionMeasurement(phoneNumber:)方法，但每个用户只能报告一个匹配项。如果找到任一 API 的匹配项，则后续 API 调用将被有效忽略。

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "[e-mail]")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "[phone]")

Objective-C

导入FirebaseAnalytics模块并将电子邮件地址传递到initiateOnDeviceConversionMeasurementWithEmailAddress: API 或将电话号码传递到initiateOnDeviceConversionMeasurementWithPhoneNumber: API。

注意：可以按顺序调用initiateOnDeviceConversionMeasurementWithEmailAddress:和initiateOnDeviceConversionMeasurementWithPhoneNumber:方法，但每个用户只能报告一个匹配项。如果找到任一 API 的匹配项，则后续 API 调用将被有效忽略。

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"[e-mail]"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"[phone]"];

统一

导入Firebase.Analytics命名空间并将电子邮件地址传递到InitiateOnDeviceConversionMeasurementWithEmailAddress() API 或将电话号码传递到InitiateOnDeviceConversionMeasurementWithPhoneNumber() API：

注意： InitiateOnDeviceConversionMeasurementWithEmailAddress()和InitiateOnDeviceConversionMeasurementWithPhoneNumber()方法可以按顺序调用，但每个用户只能报告一个匹配项。如果找到任一 API 的匹配项，则后续 API 调用将被有效忽略。

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("[e-mail]");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("[phone]");

注意：电子邮件和电话号码匹配只需在设备上每次安装时进行一次，并且理想情况下匹配应尽可能在登录时进行。

使用经过哈希处理的电子邮件地址或电话号码

该 API 将接受使用 SHA256 哈希处理的电子邮件地址和电话号码。您可以通过在调用 SDK 之前在代码中执行哈希来保持对用户数据的控制。

要使用哈希凭证，请规范化地址和数字，使用 SHA256 对其进行哈希处理，然后调用 API。

标准化电子邮件地址和电话号码

对于电子邮件地址，Google Analytics API 假定在应用 SHA256 之前执行特定的标准化，因此请按照以下步骤标准化您的数据：

1. 将整个电子邮件地址转换为小写。

2. 如果电子邮件地址以域@googlemail.com结尾，请将@googlemail.com域替换为@gmail.com 。

3. 对于以@gmail.com域结尾的地址（包括在上一步中修改的地址）：

   1. 删除用户名部分中的所有句点。

   2. 在用户名部分进行以下替换：

      • 对于字母 I 或 i，或数字 1，替换字母 l
      • 对于数字 0，替换字母 o
      • 对于数字 2，替换字母 z
      • 对于数字 5，替换字母 s

例如，标准化后：

• [e-mail]变为[e-mail]
• [e-mail]变为[e-mail]

对于电话号码，在使用 SHA256 进行哈希处理之前，号码必须已采用 E.164 格式（即前缀为 +、国家代码为 1-3 位数字、用户号码最多为 12 位数字）。

使用哈希凭据调用 API

迅速

导入FirebaseAnalytics模块并将电子邮件地址或电话号码传递到initiateOnDeviceConversionMeasurement() API。

注意：可以按顺序调用initiateOnDeviceConversionMeasurement(hashedEmailAddress:)和initiateOnDeviceConversionMeasurement(hashedPhoneNumber:)方法，但每个用户只能报告一个匹配项。如果找到任一 API 的匹配项，则后续 API 调用将被有效忽略。

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

Objective-C

导入FirebaseAnalytics模块并将电子邮件地址传递到initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API 或将电话号码传递到initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API。

注意： initiateOnDeviceConversionMeasurementWithHashedEmailAddress:和initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:方法可以按顺序调用，但每个用户只能报告一个匹配项。如果找到任一 API 的匹配项，则后续 API 调用将被有效忽略。

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

统一

导入Firebase.Analytics命名空间并将电子邮件地址传递到InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API 或将电话号码传递到InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API：

注意： InitiateOnDeviceConversionMeasurementWithHashedEmailAddress()和InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber()方法可以按顺序调用，但每个用户只能报告一个匹配项。如果找到任一 API 的匹配项，则后续 API 调用将被有效忽略。

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

注意：电子邮件和电话号码匹配只需在设备上每次安装时进行一次，并且理想情况下匹配应尽可能在登录时进行。

使用 Xcode 调试日志进行验证（可选）

如果您启用了调试模式，则在调用启动测量 API 后，请确保 Xcode 调试控制台中出现类似以下日志消息的消息：

9.0.0 - [FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

在 Firebase 9.6.0 或更高版本中，如果您启用了调试模式并包含-DebugOnDeviceConversionMeasurement启动参数，则调用initiateOnDeviceConversionMeasurement() API 将模拟匹配。

9.6.0 - [FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match

---

第 2 步：集成 Google Analytics第 4 步：排查并处理常见问题

---