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

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

במאמר הזה נסביר איך:

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

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

  • חיפוש מידע על הפניה ופתרון בעיות

בחירת סוג הדוח

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אישור שה-API מופעל

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

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

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

השלבים הבאים

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

הטמעה

רקע ומושגים

הדגמות וכלים

תכנון