עדכונים בדיווח על שיוך (Attribution) ביוני 2022

ההצעה לדוחות שיוך (Attribution) משתנה בגרסת Chrome גרסה 104, עם מנגנונים חדשים של ממשקי API, פונקציונליות ועדכונים לשירות הצבירה.

למי העדכונים האלה מיועדים?

העדכונים האלה מיועדים אם:

  • אתם כבר מכירים את ה-API. לדוגמה, אם צפיתם או להשתתף בדיונים במאגר של WICG ורוצים להבין את השינויים שבוצעו ב-API.
  • אתם משתמשים ב-Attribution Reporting API בהדגמה (דמו) או שאתם מתכננים לבדוק גרסת מקור לניסיון.

אם רק התחלתם להשתמש ב-API הזה ו/או עדיין לא ניסיתם אותו עדיין, עברו ישירות אל API במקום זאת.

עדכונים לגבי Attribution Reporting API

ההדגמה של דוחות שיוך (Attribution) עודכנו כדי לשקף את השינויים האחרונים בדוחות השיוך API בצד הלקוח.

רוב השינויים לא מצריכים פעולה. אפליקציות שדורשות עדכונים הודגשו בהמשך.

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

הכותרות אוחדו. יש עכשיו רק כותרת אחת למקורות וכותרת אחת לטריגרים בפורמט JSON.

  • כדי לרשום מקורות שיוך, אפשר להגיב לבקשות רישום עם הכותרת Attribution-Reporting-Register-Source.
  • כדי להשלים את תהליך הרישום של הטריגר, הגדירו את הכותרת Attribution-Reporting-Register-Trigger.

נדרשת פעולה לגבי השינוי הזה. עיינו ב המדריך למפתחים של API אפשר לקבל מידע נוסף.

(נדרשת פעולה) מפתחות הצבירה הם עכשיו מילון

כדי לרשום מקורות שיוך: ממשיכים להשתמש ב-aggregation_keys, אבל עכשיו מאוחסנים כמילון JSON במקום זאת של רשימה.

לדוגמה:

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

נדרשת פעולה לגבי השינוי הזה. עיינו ב מדריך API אפשר לקבל מידע נוסף.

יצירת דוחות

אפשר ליצור רק דוחות נצברים שאפשר לצבור לדוחות סיכום. אם המסננים לא תואמים לטריגרים של אירועים, לא המערכת תיצור דוחות ברמת האירוע.

הגדרה מאוחדת של מפתח ניפוי באגים

המפתח לניפוי באגים צריך להיות מוגדר עכשיו בכותרות ובטריגרים של המקור במקום עם כותרות נפרדות. מידע נוסף על ניפוי באגים .

רישום מקורות שיוך (Attribution)

עכשיו אפשר להשתמש בתגי סקריפטים כדי לרשום מקורות שיוך, בדומה לתמיכה עבור התג <img>.

עדכונים נוספים ב-API

שינויים נוספים שבוצעו וצוטטו במדריך ה-API כוללים:

  • אפשר לרשום מקורות באמצעות ממשקי API של בקשות JavaScript.
  • השדה window.registerSource הוסר.
  • עכשיו אפשר לכלול ערך בשביל attributionsrc בזמן ההרשמה מקורות.
  • כותרת אחת (Attribution-Reporting-Eligible) נוספה למקור הנכנס בקשות רישום.
  • היה שינוי קל ב-encodeURIComponent.
  • המפתח לתקציב הפרטיות הוסר מהשדה shared_info בדוחות נצברים.

תמיכה בשירות הצבירה

ב-Chrome 104, אנחנו מתכוונים לעדכן את הפורמט של חלק מהמידע שב- בדוחות נצברים. אנחנו מגבשים כרגע תמיכה לשינוי הזה שירות צבירת נתונים. המסמך הזה יעודכן, וגם Changelog, לאחר שהשינויים נשלחו.

אספנו מסמך של טיפים מעשיים ואסטרטגיות ליצירת סיכום . יש כמה תובנות, כולל:

  • סקירה כללית על רעשי רקע ביצירת דוח סיכום
  • הסבר מפורט על מאפיינים, מפתחות וערכים
  • מפתחות צבירה בפועל, כולל מפת מבנה של מפתחות
  • ערכים נצברים בפועל וההשלכות של התקציב לתרומות
  • מדריך להתנסות באפסילון

מידע נוסף על העדכונים

תמונת הכותרת היא מ-Diana Polekhina ב-Unbounce.