教學課程：評估 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 變成 anemalluserolzs@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