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

ב-Chrome 92 יחולו שינויים ב-Conversion Measurement API.

הערה: אם יש לכם שאלות או שאתם זקוקים לתמיכה במהלך ההעברה, תוכלו להצטרף לרשימת הדיוור ולשאל את השאלה.

מה משתנה?

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

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

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

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

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

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

הערה: בגרסאות עתידיות יושקו שינויים נוספים ב-API. הם ישתמשו בשם החדש שהוטמע ב-Chrome 92.

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

• אפשרות 1 (מומלצת): מומלץ להעביר את הקוד עכשיו או בשבועות הבאים, רצוי לפני אמצע יולי 2021. כך בסיס הקוד שלכם יהיה מוכן לשינויים עתידיים, וימשיך לפעול עבור לקוחות 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() ארגומנטים

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

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

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

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

קוד מדור קודם	קוד חדש
.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 ביט בהפניה האוטומטית של הטריגר ל-Attribution. ⚠️ credit הוסר.

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

מידע נוסף זמין בקטע דוחות שיוך (Attribution).