教學：衡量 iOS 廣告轉化

步驟 3： 使用 Google Analytics 啟動裝置上轉換衡量

現在您可以收集使用者的電子郵件地址和電話號碼，而您的應用程式具有 Google Analytics for Firebase 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變成anemlluserolzs@gmail.com
• CAPSUSER0125@provider.net變成capsuser0125@provider.net

對於電話號碼，在使用 SHA256 進行雜湊處理之前，號碼必須已採用 E.164 格式（即前綴為 +，國家代碼為 1-3 位數字，用戶號碼最多為 12 位數字）。

使用哈希憑證呼叫 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 調試日誌進行驗證（可選）

如果您啟用了偵錯模式，則在呼叫啟動測量 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