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

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

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

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

שליחת קריאה ל-API

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

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

באמצעות פרטי הכניסה
שימוש בפרטי כניסה מגובבים

שימוש בכתובת אימייל או במספר טלפון

Swift Objective-C Unity

אפשר לייבא את המודול FirebaseAnalytics ולהעביר אותו בכתובת האימייל או בטלפון ל-API של initiateOnDeviceConversionMeasurement().

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")

מייבאים את המודול 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"];

מייבאים את מרחב השמות של Firebase.Analytics ומעבירים את כתובת האימייל אל API של InitiateOnDeviceConversionMeasurementWithEmailAddress() או הטלפון מספר ל-API של InitiateOnDeviceConversionMeasurementWithPhoneNumber():

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 יקבל כתובות אימייל ומספרי טלפון שעברו גיבוב (hash) באמצעות SHA256. שלך יכול לשמור על שליטה בנתוני המשתמש על ידי ביצוע הגיבוב (hashing) בקוד לפני ביצוע קריאות ל-SDK.

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

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

לגבי כתובות אימייל, ה-API של Google Analytics מניח מתבצע נירמול ספציפי לפני שמחילים SHA256, לכן צריך לפעול לפי השלבים לנרמול הנתונים:

צריך להמיר את כל כתובת האימייל לאותיות קטנות.
אם כתובת האימייל מסתיימת בדומיין @googlemail.com, מחליפים את דומיין @googlemail.com עם @gmail.com.
לכתובות שמסתיימות בדומיין @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 ספרות למספר המנוי) לפני לבצע גיבוב (hashing) באמצעות SHA256.

קריאה ל-API עם פרטי כניסה מגובבים

Swift Objective-C Unity

מייבאים את המודול FirebaseAnalytics ומעבירים אותו בכתובת האימייל או בטלפון ל-API של initiateOnDeviceConversionMeasurement().

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

מייבאים את המודול FirebaseAnalytics ומעבירים את כתובת האימייל אל API של initiateOnDeviceConversionMeasurementWithHashedEmailAddress: או הטלפון מספר ל-initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API.

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

מייבאים את מרחב השמות של Firebase.Analytics ומעבירים את כתובת האימייל אל API של InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() או מספר טלפון ל-API של InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber():

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, ואז קריאה ל- API של initiateOnDeviceConversionMeasurement() ידמה התאמה.

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

שלב 2: משלבים את Google Analytics שלב 4: פותרים בעיות נפוצות ומטפלים בהן