מתבצע שינוי ב-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. כך בסיס הקוד יהיה מוכן לשינויים עתידיים וימשיך לפעול בלקוחות חדשים יותר של Chrome.
- אפשרות 2: לחכות לעדכונים נוספים ולתכונות חדשות שיפורסמו בגרסאות עתידיות של Chrome, ולבצע את כל שינויי הקוד הנדרשים בבת אחת.
העברה
דוגמה להעברה
בבקשת המיזוג הזו (טיוטה) אפשר לראות דוגמה להעברה של אפליקציית הדגמה קטנה.
עדכון הקוד של מדיניות ההרשאות
| קוד מדור קודם | קוד חדש |
|---|---|
allow='conversion-measurement' |
allow='attribution-reporting' |
עדכון קוד זיהוי התכונות
| קוד מדור קודם | קוד חדש |
|---|---|
document.featurePolicy.features() |
document.featurePolicy.features() |
עדכון מאפייני ה-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'
);
עדכון כתובת ה-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 |
| דוחות נכנסים | הנתונים נשלחים כפרמטרים של כתובת URL. | הנתונים נשלחים כ-JSON בגוף הבקשה. נתוני הדוח כלולים בגוף הבקשה כאובייקט JSON עם המפתחות הבאים: source_event_id: בעבר impression-data, מזהה האירוע בן 64 הביטים שהוגדר במקור השיוך.trigger_data: בעבר conversion-data, מערך הנתונים בן 3 הביטים בהפניה האוטומטית של טריגר השיוך.⚠️ credit הוסר.
|