מדריך: מדידת המרות של מודעות iOS

שלב 3: התחל מדידת המרות במכשיר באמצעות Google Analytics

כעת, כשאתה יכול לאסוף כתובות דוא"ל ומספרי טלפון של משתמשים ולאפליקציה שלך יש את Google Analytics for Firebase SDK, אתה יכול להשתמש בשניהם כדי להתחיל למדוד המרות.

התקשר ל-API

התקשר ל-API למדידת המרות עם כתובת הדוא"ל או מספר הטלפון שהסכים משלב 1, המשמש למדידת המרות של מודעות, מבלי לאפשר למידע מזהה אישי לעזוב את מכשיר המשתמש.

ישנן שתי דרכים להתחיל מדידה:

• שימוש באישורים
• שימוש באישורים מגובבים

השתמש בכתובת דוא"ל או מספר טלפון

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.

נרמל כתובות דוא"ל ומספרי טלפון

עבור כתובות דוא"ל , ה-API של Google Analytics מניח שנורמליזציה מסוימת מבוצעת לפני החלת 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

עבור מספרי טלפון , מספרים כבר חייבים להיות בפורמט 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 (אופציונלי)

אם הפעלת את מצב ניפוי באגים, לאחר קריאה לממשק ה-API של initiate measurement, ודא שהודעה כמו הודעת היומן הבאה מופיעה במסוף הבאגים של Xcode:

9.0.0 - [FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

ב-Firebase 9.6.0 ואילך, אם הפעלת את מצב ניפוי באגים וכללת את ארגומנט ההשקה -DebugOnDeviceConversionMeasurement , אז קריאה לממשק ה-API initiateOnDeviceConversionMeasurement() תדמה התאמה.

9.6.0 - [FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match

arrow_back_ios שלב 2 : שילוב של Google Analytics שלב 4 : פתרון בעיות וטפל בבעיות נפוצות arrow_forward_ios