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

המדריך הזה כולל סקירה כללית והוראות הגדרה של דוחות שיוך ברמת האירוע ודוחות סיכום שיוך באמצעות Attribution Reporting API.

בתור התחלה, תלמדו:

  • הבדלים בין סוגי הדוחות של Attribution Reporting API

  • משלימים את שלבי ההטמעה של ה-API ויצירת הדוחות

  • מידע עזר ופתרון בעיות

בחירת סוג דוח

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

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

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

סקירה כללית על ההטמעה

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

דרישה מוקדמת: כדי שתוכלו לרשום מקורות, טריגרים ולקבל דוחות, לאתרים שלכם צריכים להיות אישורי SSL/TLS (HTTPS).

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

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

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

  2. רישום טריגר: מתועד אירוע המרה ומקושר למקור שרשום בעבר. הוראות מפורטות זמינות במאמר רישום טריגרים של שיוך (Attribution).

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

לסקירה מפורטת יותר על דוחות ברמת האירוע, אפשר לעיין במאמר הסבר על דוחות ברמת האירוע.

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

  1. רישום מקור: זהה לדיווחים ברמת האירוע. פרטים נוספים זמינים במאמרים רישום מקורות שיוך ורישום של מקורות שיוך.

  2. רישום טריגר: זהה לדיווח ברמת האירוע. רישום טריגרים של שיוך

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

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

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

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

הגדרת מסננים (אופציונלי)

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

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

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

מוודאים שה-API מופעל

לפני שמשתמשים ב-API, צריך לבדוק אם הוא מופעל באמצעות הקוד הבא:

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

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

השלבים הבאים

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

הטמעה

רקע ומושגים

הדגמות וכלים

תכנון