חלק 1 מתוך 3 בנושא ניפוי באגים בדיווח על שיוך (Attribution). הסבר על החשיבות של ניפוי באגים ומתי להשתמש בדוחות ניפוי באגים במהלך בדיקות.
למה צריך דוחות ניפוי באגים
אם אתם בודקים את Attribution Reporting API, חשוב לוודא שהשילוב פועל כמו שצריך, להבין את הפערים בתוצאות המדידה בין ההטמעה שמבוססת על קובצי cookie לבין ההטמעה של Attribution Reporting API, ולפתור בעיות שקשורות לשילוב.
דוחות ניפוי באגים נדרשים כדי להשלים את המשימות האלה. לכן, מומלץ מאוד להגדיר אותם.
מילון מונחים
היבטים מרכזיים בדוחות ניפוי באגים
שני סוגים של דוחות ניפוי באגים
יש שני סוגים של דוחות על תוצאות ניפוי באגים. מומלץ להשתמש בשניהם, כי הם מתאימים לתרחישים שונים לדוגמה.
דוחות ניפוי באגים בהצלחה
דוחות ניפוי באגים בהצלחה עוקבים אחרי יצירה מוצלחת של דוח שיוך. הם קשורים ישירות לדוח השיוך.
דוחות ניפוי הבאגים שהצליחו זמינים החל מגרסה 101 של Chrome (אפריל 2022).
דוחות ניפוי באגים מפורטים
דוחות ניפוי באגים מילוליים מספקים יותר מידע על המקור והטריגרים של אירועים, כך שתוכלו לוודא שהמקורות נרשמו בהצלחה או לעקוב אחר דוחות חסרים ולהבין למה הם חסרים (כשל באירועי המקור או ההפעלה, כשל בזמן השליחה או היצירה של הדוח). דוחות ניפוי באגים מילוליים מצביעים על:
- מקרים שבהם הדפדפן רשם מקור בהצלחה.
- מקרים שבהם הדפדפן לא רשם בהצלחה מקור או מפעיל אירוע – כלומר, הוא לא יפיק דוח שיוך.
- מקרים שבהם לא ניתן ליצור או לשלוח דוח שיוך מסיבה כלשהי.
דוחות ניפוי באגים מפורטים כוללים את השדה type שמתאר רישום מקור בהצלחה, או את הסיבה לכך שלא נוצר דוח מקור, טריגר או דוח שיוך.
הדוחות על תוצאות ניפוי באגים מילוליים זמינים החל מגרסה 109 של Chrome (ינואר 2023) – פרט לדוחות ניפוי באגים מפורט על תוצאות של רישום מקור שנוספו מאוחר יותר בגרסה 112 של Chrome.
אפשר לעיין בדוחות לדוגמה בקטע חלק 2: הגדרת דוחות של ניפוי באגים.
דוחות ניפוי הבאגים מבוססים על קובצי Cookie
כדי להשתמש בדוחות ניפוי באגים, המקור לדיווח צריך להגדיר קובץ cookie.
אם המקור שהוגדר לקבלת דוחות הוא צד שלישי, קובץ ה-cookie הזה יהיה קובץ cookie של צד שלישי. יש לכך כמה השלכות עיקריות:
- דוחות על ניפוי באגים נוצרים רק אם קובצי Cookie של צד שלישי מותרים בדפדפן של המשתמש.
- דוחות ניפוי באגים לא יהיו זמינים יותר אחרי ההוצאה משימוש של קובצי Cookie של צד שלישי.
דוחות ניפוי באגים נשלחים באופן מיידי
דוחות ניפוי באגים נשלחים מיד על ידי הדפדפן אל מקור הדיווח. הדבר שונה מדוחות שיוך (Attribution), שנשלחים עם עיכוב.
דוחות ניפוי באגים בהצלחה נוצרים ונשלחים ברגע שדוח השיוך התואם נוצר: כלומר, בזמן רישום הטריגר.
דוחות ניפוי באגים מילוליים נשלחים מיד לאחר רישום המקור או הפעלת הרישום.
לדוחות ניפוי באגים יש נתיבים שונים של נקודות קצה
בדומה לדוחות שיוך (Attribution), כל דוחות ניפוי הבאגים נשלחים אל מקור הדיווח. דוחות ניפוי באגים נשלחים לשלוש נקודות קצה נפרדות של מקור הדיווח:
- נקודת קצה לדוחות ניפוי באגים להצלחה, ברמת האירוע
- נקודת קצה (endpoint) מסוג הצלחה לדוחות ניפוי באגים,
- נקודת קצה (endpoint) מפורטת של דוחות ניפוי באגים, ברמת האירוע וניתנת לצבירה.
מידע נוסף זמין בקטע חלק 2: הגדרת דוחות של ניפוי באגים.
תרחישים לדוגמה
בדיקת שילוב בסיסית בזמן אמת
דוחות על ניפוי באגים נשלחים לנקודת הקצה באופן מיידי, בניגוד לדוחות שיוך (Attribution) שמתעכבים כדי להגן על פרטיות המשתמשים. כדאי להשתמש בדוחות ניפוי באגים כדי לראות בזמן אמת שהשילוב עם Attribution Reporting API פועל.
חלק 3: ספר המתכונים לניפוי באגים
ניתוח אובדן
בניגוד לקובצי cookie של צד שלישי, Attribution Reporting API כולל אמצעי הגנה מובנים על הפרטיות, שנועדו לשמור על איזון בין כלי השירות לבין הפרטיות. פירוש הדבר הוא שעם Attribution Reporting API, יכול להיות שלא תוכלו לאסוף את כל נתוני המדידה שאתם אוספים כרגע באמצעות קובצי cookie. לא כל ההמרות שאחריהן אפשר לעקוב באמצעות קובצי Cookie של צד שלישי ייצרו דוח שיוך.
דוגמה אחת: בדוחות ברמת האירוע אפשר לרשום רק המרה אחת לכל חשיפה. כלומר, לגבי חשיפה מסוימת של מודעה תקבלו רק דוח שיוך אחד, לא משנה כמה פעמים המשתמש משלים המרה.
בעזרת דוחות ניפוי באגים תוכלו לראות את ההבדלים בין תוצאות המדידה שמבוססות על קובצי cookie לבין התוצאות שמתקבלות מ-Attribution Reporting API. תוכלו לזהות אילו המרות מדווחות, כמה המרות לא מדווחות, ובפרט אילו המרות מדווחות ולמה.
חלק 3: ספר המתכונים לניפוי באגים מוסבר איך להפעיל ניתוח אובדן נתונים.
פתרון בעיות
צפוי אובדן כתוצאה מאמצעים להגנה על הפרטיות או מאמצעי הגנה על משאבים, אבל יכול להיות של אובדן אחר באופן לא מכוון. הגדרות שגויות בהטמעה או באגים בדפדפן עצמו עלולים לגרום לכך שלא יופיעו בדוחות.
תוכלו להשתמש בדוחות של ניפוי באגים כדי לזהות ולתקן בעיית הטמעה בצד שלכם, או כדי לדווח על באג אפשרי לצוותי הדפדפנים. בחלק 3: ספר המתכונים לניפוי באגים מוסבר איך עושים זאת.
בדיקת הגדרות מתקדמות
חלק מהתכונות של Attribution Reporting API מאפשרות להתאים אישית את ההתנהגות של ה-API. דוגמאות לכללי סינון, כללי ביטול כפילויות וכללי עדיפות הם כמה דוגמאות.
כשמשתמשים בתכונות האלה, כדאי להשתמש בדוחות ניפוי באגים כדי לוודא שהלוגיקה מובילה להתנהגות הרצויה בסביבת הייצור, בלי להמתין לדוחות השיוך. חלק 3: ספר המתכונים לניפוי באגים
בדיקה מקומית עם דוחות נצברים
בניגוד לדוחות שיוך (Attribution) נצברים מוצפנים, דוחות ניפוי באגים נצברים כוללים את המטען הייעודי (payload) הלא מוצפן.
משתמשים בדוחות ניפוי באגים נצברים כדי לאמת את התוכן של דוחות נצברים, וכדי ליצור דוחות סיכום באמצעות כלי הצבירה המקומי לצורך בדיקה.
עיבוד מחדש של דוחות של שירותי צבירה
יתרון נוסף בשימוש במצב ניפוי באגים הוא שהוא מאפשר לעבד שוב דוחות. לכן, אם רוצים לעבד דוחות יותר מפעם אחת, צריך להפעיל דוחות ניפוי באגים. יכול להיות שתרצו לעבד מחדש דוחות במקרים הבאים:
- לנסות לנפות באגים בשירות הצבירה.
- להתנסות באסטרטגיות אצווה שונות.
- לערוך ניסויים עם ערכים שונים של אפסילון.
שחזור נתונים
אנחנו ממליצים שטכנולוגיות הפרסום מאפשרות למצב ניפוי הבאגים לקבל דוחות על תוצאות ניפוי הבאגים כדי לשחזר את נתוני הדיווח. האפשרות הזו שימושית במקרים של בעיות בשירות הצבירה, כמו שירותים לא זמינים או לא רספונסיביות, שעלולים לגרום לכשל ביצירת דוח סיכום.