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