步驟 3：使用Google Analytics啟動裝置端轉換評估
| 簡介： 評估 iOS Ads 轉換 |
|
步驟 1： 實作登入體驗 |
| 步驟 2：整合 Google Analytics |
|
步驟 3：使用 Google Analytics 啟動裝置端轉換評估 |
| 步驟 4： 疑難排解及處理常見問題 |
您現在可以收集使用者電子郵件地址和電話號碼，而且您的應用程式 Google Analytics for Firebase SDK，則提供這兩個函式可啟動 Firebase SDK 評估轉換
呼叫 API
透過同意分享的電子郵件地址或電話號碼呼叫轉換評估 API 步驟 1 的數字，這會用於評估廣告轉換， 允許任何個人識別資訊離開使用者裝置。
開始評估的方式有兩種：
使用電子郵件地址或電話號碼
Swift
匯入 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"];
Unity
匯入 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 替代英文字母 l
- 如為數字 0，請以替代字母 o
- 以數字 2 替代字母 z
- 請以替代字母 s 指定數字 5
舉例來說，在正規化之後：
an.email.user0125@googlemail.com變成anemalluserolzs@gmail.comCAPSUSER0125@provider.net變成capsuser0125@provider.net
如果是電話號碼，號碼必須已採用 E.164 格式 (即 前置字串為 +，國家/地區代碼為 1 至 3 位數，訂閱者號碼最多 12 位數)。 使用 SHA256 進行雜湊處理。
使用雜湊憑證呼叫 API
Swift
匯入 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:中的數字
也能使用 Google Cloud CLI 或
Compute Engine API
@import FirebaseAnalytics; // ... // If you're using an email address.... [FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress]; // If you're using a phone number.... [FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];
Unity
匯入 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：疑難排解及處理常見問題