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