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

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

简介： 衡量 iOS Ads 转化情况

第 1 步： <ph type="x-smartling-placeholder"></ph> 实现登录体验

第 2 步：集成 Google Analytics

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

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

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

调用 API

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

您可以通过以下两种方式启动衡量：

• 使用凭据
• 使用经过哈希处理的凭据

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

Swift Objective-C Unity

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

注意 ：initiateOnDeviceConversionMeasurement(emailAddress:) 和 可以调用 initiateOnDeviceConversionMeasurement(phoneNumber:) 方法 按顺序，但每个用户只能报告一个匹配项。如果找到了匹配项 那么后续的 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]")

导入 FirebaseAnalytics 模块，并将电子邮件地址传递给 initiateOnDeviceConversionMeasurementWithEmailAddress: API 或手机 传递给 initiateOnDeviceConversionMeasurementWithPhoneNumber: API。

注意 ：initiateOnDeviceConversionMeasurementWithEmailAddress: 和 可以调用 initiateOnDeviceConversionMeasurementWithPhoneNumber: 方法 按顺序，但每个用户只能报告一个匹配项。如果找到了匹配项 那么后续的 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 调用都会被有效忽略。

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 代替
      • 用字母 o 代替数字 0
      • 用字母 z 替换数字 2
      • 对于数字 5，将其替换为字母 s

例如，在经过标准化处理后：

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

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

使用经过哈希处理的凭据调用 API

Swift Objective-C Unity

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

注意 ：initiateOnDeviceConversionMeasurement(hashedEmailAddress:) 和 initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) 方法 按顺序调用，但每个用户只能报告一个匹配项。如果匹配 系统会有效忽略后续 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)

导入 FirebaseAnalytics 模块，并将电子邮件地址传递给 initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API 或手机 将号码发送到 initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API。

注意 ：initiateOnDeviceConversionMeasurementWithHashedEmailAddress: 和 initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: 方法 按顺序调用，但每个用户只能报告一个匹配项。如果匹配 系统会有效忽略后续 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 调用。

using Firebase.Analytics;

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

注意 ：在 因此，最好在尽可能接近用户登录时进行匹配。

重要提示： 请注意，如果预期发生的应用内操作或事件发生， 在用户电子邮件或电话注册后立即，考虑实施 从启动设备端转化衡量到在较短的延迟时间内 并记录活动数据。

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

如果您启用了调试模式，在调用启动 Measurement 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 步：排查并处理常见问题

---