תחילת העבודה עם דוחות שיוך (Attribution)

כאן מתחילים, כולל ההגדרה וסקירה כללית קצרה.

בחירת סוג דוח

ב-Attribution Reporting API אפשר ליצור שני סוגים של דוחות: דוחות ברמת האירוע ודוחות סיכום. כדי להפיק דוחות ברמת האירוע נדרשת פחות הגדרה מאשר בדוחות נצברים או מדוחות סיכום, לכן מומלץ להתחיל בהם. דוחות סיכום דורשים שילוב עם שירות הצבירה. לא ניתן להשתמש בדוחות ברמת האירוע.

אפשר להגדיר דיווח לדוח סיכום וגם ברמת האירוע. הן משלימים את התהליך.

דוחות ברמת האירוע

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

דוחות סיכום

דוח סיכום הוא סוג הדוחות Attribution Reporting API ו-Private Aggregation API. דוח סיכום כולל נתוני משתמשים נצברים והוא יכול לכלול נתוני המרות מפורטים, בתוספת רעש. דוחות סיכום מורכבים מדוחות מצטברים.

הטמעה

כדי להתחיל, אפשר לנסות את השלבים הבאים.

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

יצירת דוח ברמת האירוע

אלה השלבים המינימליים שצריך לבצע כדי ליצור דוחות ברמת האירוע:

  1. רישום מקור ההוראות מפורטות במאמר רישום מקורות שיוך (Attribution). הערה: השלבים לקליקים ולצפיות שונים.

  2. רישום טריגר. ההוראות מפורטות במאמר רישום טריגרים של שיוך (Attribution).

  3. מגדירים נקודת קצה עם כתובת ה-URL הבאה:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    אפשר להיעזר בקוד לדוגמה ב-adtech.js כדי לראות את השיטה post. ניתן למצוא כאן מידע נוסף על .well-known.

כאן אפשר לקרוא מידע נוסף על דוחות ברמת האירוע.

יצירת דוח סיכום

כדי ליצור דוחות סיכום, צריך לבצע את השלבים הכלליים הבאים:

  1. רישום מקור ההוראות מפורטות במאמר רישום מקורות שיוך (Attribution). הערה: השלבים לקליקים ולצפיות שונים. פרטים נוספים זמינים במאמר בנושא רישום של מקור שיוך (Attribution).

  2. רישום טריגר. ההוראות מפורטות במאמר רישום טריגרים של שיוך (Attribution).

  3. מגדירים נקודת קצה לדוחות נצברים עם כתובת ה-URL הבאה:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    בקוד לדוגמה ב-adtech.js מוסבר איך להשתמש בשיטה post. ניתן למצוא כאן מידע נוסף על .well-known.

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

כאן ניתן למצוא פרטים נוספים על דוחות סיכום.

תוכלו ללמוד איך להגדיר דוחות ניפוי באגים במאמר סדרת ניפוי באגים בדוחות שיוך (Attribution).

דוחות סיכום – מושגים נוספים

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

שלבים אופציונליים

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

לא לשכוח את זיהוי התכונות

לפני שמשתמשים ב-API, משתמשים ב-Permissions-Policy כדי שהוא לא נחסם בדף. כדי לעשות זאת, מריצים את הקוד הבא:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

אם הבדיקה של זיהוי התכונות מחזירה True, ה-API מורשה בהקשר (הדף) שבו הבדיקה רצה.

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

השלבים הבאים

אם אתם מוכנים להתחיל בהטמעה, כדאי לעיין במסמכים הבאים:

הגדרה

רקע

הדגמות וכלים

תכנון

אם אתם עדיין בשלב התכנון, תוכלו לעיין במסמכים הבאים: