教程：衡量 iOS 广告转化情况

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

简介： 衡量 iOS Ads 转化

第 1 步： 实现登录体验

第 2 步：集成 Google Analytics

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

第 4 步： 排查和处理常见问题

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

调用 API

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

您可以通过以下两种方式开始衡量：

• 使用凭据
• 使用哈希凭据

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

Swift

导入 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]"];

Unity

导入 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，并尽可能在登录时调用。

重要提示：请注意，如果用户在注册电子邮件地址或电话号码后立即执行预期的应用内操作或发生应用内事件，请考虑在启动设备端转化衡量与记录事件之间实现短暂的时间延迟。

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

该 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 位用户号码）。

请注意，经过哈希处理的 SHA256 电子邮件地址或电话号码必须为 32 字节长，而不是十六进制字符串。

使用哈希凭据调用 API

Swift

导入 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];

Unity

导入 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);

注意：最佳做法是每次安装时调用一次该 API，并尽可能在登录时调用。

重要提示：请注意，如果用户在注册电子邮件地址或电话号码后立即执行预期的应用内操作或发生应用内事件，请考虑在启动设备端转化衡量与记录事件之间实现短暂的时间延迟。

验证集成

启用调试模式。调用启动衡量 API 后，请确保 Xcode 调试控制台中显示类似于以下日志消息的消息：

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

如果您已启用调试模式并添加了 -DebugOnDeviceConversionMeasurement 启动实参，则调用 initiateOnDeviceConversionMeasurement() API 将模拟匹配。

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

---

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

---