第 3 步:使用 Google Analytics 启动设备上转化衡量
简介:衡量 iOS 广告转化 |
第 1 步:实现登录体验 |
第 2 步:集成 Google Analytics |
第 3 步:使用 Google Analytics 启动设备上转化衡量 |
步骤 4:排查并处理常见问题 |
现在您可以收集用户的电子邮件地址和电话号码,并且您的应用具有 Google Analytics for Firebase SDK,您可以使用这两者来开始衡量转化情况。
调用API
使用步骤 1 中同意的电子邮件地址或电话号码调用转化衡量 API,用于广告转化衡量,而不允许任何个人身份信息离开用户设备。
有两种方法可以启动测量:
使用电子邮件地址或电话号码
迅速
导入FirebaseAnalytics
模块并将电子邮件地址或电话号码传递到initiateOnDeviceConversionMeasurement()
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")
Objective-C
导入FirebaseAnalytics
模块并将电子邮件地址传递到initiateOnDeviceConversionMeasurementWithEmailAddress:
API 或将电话号码传递到initiateOnDeviceConversionMeasurementWithPhoneNumber:
API。
@import FirebaseAnalytics; // ... // If you're using an email address.... [FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"]; // If you're using a phone number.... [FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];
统一
导入Firebase.Analytics
命名空间并将电子邮件地址传递到InitiateOnDeviceConversionMeasurementWithEmailAddress()
API 或将电话号码传递到InitiateOnDeviceConversionMeasurementWithPhoneNumber()
API:
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 之前执行特定的标准化,因此请按照以下步骤标准化您的数据:
将整个电子邮件地址转换为小写。
如果电子邮件地址以域@googlemail.com结尾,请将@googlemail.com域替换为@gmail.com 。
对于以@gmail.com域结尾的地址(包括在上一步中修改的地址):
删除用户名部分中的所有句点。
在用户名部分进行以下替换:
- 对于字母 I 或 i,或数字 1,替换字母 l
- 对于数字 0,替换字母 o
- 对于数字 2,替换字母 z
- 对于数字 5,替换字母 s
例如,标准化后:
-
an.email.user0125@googlemail.com
变为anemlluserolzs@gmail.com
-
CAPSUSER0125@provider.net
变为capsuser0125@provider.net
对于电话号码,在使用 SHA256 进行哈希处理之前,号码必须已采用 E.164 格式(即前缀为 +、国家代码为 1-3 位数字、用户号码最多为 12 位数字)。
使用哈希凭据调用 API
迅速
导入FirebaseAnalytics
模块并将电子邮件地址或电话号码传递到initiateOnDeviceConversionMeasurement()
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。
@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:
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 步:排查并处理常见问题