[הוצא משימוש] מדריך להעברה (Chrome 92): מ-API למדידת המרות אל Attribution Reporting API

Conversion Measurement API משתנה ב-Chrome 92.

מה משתנה?

מעקב אחר השינויים של הצעת ה-API בחודשים הראשונים של 2021, הטמעת ה-API ב-Chrome מתפתחת. אלה השינויים שיחולו:

  • שם ה-API ושם מדיניות ההרשאות.
  • שמות מאפייני ה-HTML וכתובות ה-URL .well-known.
  • הפורמט של הדוחות. עכשיו דוחות נשלחים כ-JSON בגוף הבקשה.
  • התוכן של הדוחות: credit הוסר, יחד עם דוחות שהיה להם 0 קרדיט.

מה שלא השתנה ב-Chrome 92 הוא קבוצת התכונות הנתמכות: דוחות ברמת האירוע, לקליקים בלבד. עדכונים בנושא. לאחר השינוי הזה, תכונות ועדכונים נוספים יושקו בגרסאות עתידיות של Chrome.

מתי השינויים האלה ייכנסו לתוקף?

השינויים האלה ייכנסו לתוקף החל מ-Chrome 92, יציב ב-20 ביולי 2021. גרסת הבטא של Chrome 92 הושקה ב-3 ביוני 2021.

מה עליך לעשות?

אם הפעלת גרסת מקור לניסיון או הטמעת הדגמה ל-API הזה, יש לך אפשרויות:

  • אפשרות 1 (מומלצת): תעביר את הקוד עכשיו או בשבועות הקרובים, עדיף לפני באמצע יולי 2021. כך ה-codebase שלכם יהיה מוכן לשינויים עתידיים להמשיך לעבוד עבור לקוחות חדשים יותר של Chrome.
  • אפשרות 2: להמתין שיושקו תכונות ועדכונים נוספים בגרסאות עתידיות של Chrome, ולבצע את כל השינויים הנחוצים בקוד בו-זמנית.

העברה

העברה לדוגמה

אפשר לראות דוגמה להעברה של אפליקציית הדגמה קטנה בבקשת המשיכה (טיוטה) הזו.

עדכון הקוד של מדיניות ההרשאות

קוד מדור קודם קוד חדש
allow='conversion-measurement' allow='attribution-reporting'

עדכון הקוד לזיהוי תכונות

קוד מדור קודם קוד חדש
document.featurePolicy.features()
.includes('conversion-measurement')		 document.featurePolicy.features()
.includes('attribution-reporting')

עדכון מאפייני ה-HTML

קוד מדור קודם קוד חדש
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

עדכון window.open() ארגומנטים

אפשר לרשום מקור שיוך עבור ניווטים שמתבצעים על ידי window.open(). כדאי לעדכן את הקריאות האלה אם משתמשים ב-window.open() כדי לרשום מקורות שיוך.

הקוד החדש אמור להיראות כך (שינוי השם מתבצע בהתאם למאפייני ה-HTML) שינוי שם):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

עדכון הפרמטר והכתובת של שיחת הרישום

קוד מדור קודם קוד חדש
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

עדכון הקוד של נקודת הקצה לדיווח

קוד מדור קודם קוד חדש
הבקשות הצפויות מהדפדפן .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
דוחות נכנסים נשלחים כפרמטרים של כתובת אתר. נשלח כ-JSON בגוף הבקשה.

נתוני הדוח נכללים בגוף הבקשה כאובייקט JSON עם התג המפתחות הבאים:
source_event_id: בעבר impression-data, מזהה האירוע של 64 ביט שהוגדר במקור השיוך.
trigger_data: בעבר conversion-data, קבוצת הנתונים של 3 ביט בטריגר השיוך להפניה אוטומטית.

⚠️ credit הוסר.

דוחות שיוך (Attribution): כל המשאבים

פרטים נוספים זמינים בקטע דוחות שיוך (Attribution).