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

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

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

调用 API

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

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

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

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

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "example@gmail.com")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "+15555555555")

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("example@gmail.com");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("+15555555555");

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

该 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

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

• “an.email.user0125@googlemail.com”变为“anemalluserolzs@gmail.com”
• “CAPSUSER0125@provider.net”变为“capsuser0125@provider.net”

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

使用经过哈希处理的凭据调用 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)

@import FirebaseAnalytics;

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

using Firebase.Analytics;

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

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

如果您启用了调试模式，请在调用 Initial 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

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