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