שלב 3: מפעילים מדידת המרות במכשיר באמצעות Google Analytics
| מבוא: מדידת המרות ב-Google Ads ל-iOS |
|
שלב 1: הטמעת חוויית כניסה |
| שלב 2: הטמעה של Google Analytics |
|
שלב 3: הפעלת מדידת המרות במכשיר באמצעות Google Analytics |
| שלב 4: פתרון בעיות נפוצות |
עכשיו, כשאתם יכולים לאסוף כתובות אימייל ומספרי טלפון של משתמשים, והאפליקציה שלכם כוללת את ה-Google Analytics של Firebase SDK, תוכלו להשתמש בשניהם כדי להתחיל למדוד המרות.
שליחת קריאה ל-API
קוראים ל-Conversion Measurement API עם כתובת האימייל או מספר הטלפון שהמשתמשים הביעו הסכמה לשימוש בהם בשלב 1, ומשתמשים בהם למדידת המרות ממודעות, בלי לאפשר למידע אישי מזהה לצאת ממכשיר המשתמש.
יש שתי דרכים להתחיל את המדידה:
שימוש בכתובת אימייל או במספר טלפון
Swift
מייבאים את המודול 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")
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 ומעבירים את כתובת האימייל ל-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.
כדי להשתמש בפרטי כניסה מגובבים, צריך לנרמל כתובות ומספרים, לגבב אותם באמצעות SHA256 ואז לבצע קריאה ל-API.
נורמליזציה של כתובות אימייל ומספרי טלפון
לגבי כתובות אימייל, ה-API של Google Analytics מניח שמתבצעת נורמליזציה מסוימת לפני החלת SHA256, לכן צריך לפעול לפי השלבים הבאים כדי לנרמל את הנתונים:
ממירים את כל כתובת האימייל לאותיות קטנות.
אם כתובת האימייל מסתיימת בדומיין @googlemail.com, צריך להחליף את הדומיין @googlemail.com ב-@gmail.com.
לכתובות שמסתיימות בדומיין @gmail.com (כולל כתובות ששונו בשלב הקודם):
יש להסיר את כל הנקודות מהחלק של שם המשתמש.
בחלק של שם המשתמש, מבצעים את ההחלפות הבאות:
- באותיות 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.
קריאה ל-API באמצעות פרטי כניסה מגובבים
Swift
מייבאים את המודול 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)
Objective-C
מייבאים את המודול FirebaseAnalytics ומעבירים את כתובת האימייל ל-initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API או את מספר הטלפון ל-initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: 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 ומעבירים את כתובת האימייל ל-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 (אופציונלי)
אם הפעלתם את מצב ניפוי הבאגים, אחרי הקריאה ל-Initiate Measurement 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: פתרון בעיות נפוצות