מדריך: מדידת המרות ב-iOS Ads

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

עכשיו, כשאתם יכולים לאסוף כתובות אימייל ומספרי טלפון של משתמשים, ובאפליקציה שלכם מותקן Google Analytics 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");

שימוש בכתובת אימייל או במספר טלפון שעברו גיבוב (hash)

ה-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 הופך ל-anemalluserolzs@gmail.com
• ‫CAPSUSER0125@provider.net הופך ל-capsuser0125@provider.net

מספרי טלפון צריכים להיות כבר בפורמט E.164 (כלומר, קידומת עם סימן פלוס, 1-3 ספרות של קוד המדינה, עד 12 ספרות של מספר המנוי) לפני הגיבוב עם SHA256.

שימו לב: כתובות האימייל או מספרי הטלפון המגובבים בפורמט SHA256 צריכים להיות באורך של 32 בייט, ולא מחרוזת הקסדצימלית.

קריאה ל-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);

אימות השילוב

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

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

אם הפעלתם את מצב ניפוי הבאגים והוספתם את ארגומנט ההפעלה -DebugOnDeviceConversionMeasurement, קריאה לממשק API‏ initiateOnDeviceConversionMeasurement() תדמה התאמה.

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

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