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

שלב 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");

שימוש בכתובת אימייל או במספר טלפון שעברו גיבוב (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