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

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

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

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

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

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

עדכונים ב-Attribution Reporting API

ההדגמה של Attribution Reporting עודכנה כדי לשקף את השינויים האחרונים ב-Attribution Reporting 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 בדוחות נצברים.

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

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

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

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

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

תמונת הכותרת היא של דיאנה פולקינה בערוץ ביטול המים.