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

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

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

קריאה ל-API

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

כדי להשתמש בפרטי כניסה מגובבים, צריך לנרמל כתובות ומספרים, לגבב אותם באמצעות SHA-256 ואז לבצע קריאה ל-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);

אימות באמצעות יומני ניפוי הבאגים של Xcode (אופציונלי)

אם הפעלתם את מצב ניפוי הבאגים, אחרי הקריאה ל-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