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