ב-Chrome 92 מתבצע שינוי ב-Conversion Measurement API.
מה משתנה?
בעקבות השינויים בהצעה ל-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 הוסרה.
|