ספר המתכונים לניפוי באגים בדוחות שיוך (Attribution)

חלק 3 מתוך 3 בנושא ניפוי באגים של דוחות שיוך. הוראות לשימוש בדוחות ניפוי באגים

במדריך הזה מפורטות הוראות לשימוש בדוחות ניפוי באגים בתרחישים שונים לשימוש, שמתוארים בחלק 1: מבוא לדוחות ניפוי באגים.

מילון מונחים

• המקור של הדיווח הוא המקור שמגדיר את הכותרות מקור וטריגר לדיווח השיוך. כל הדוחות שנוצרו על ידי הדפדפן נשלחים למקור הזה. בהנחיות האלה אנחנו משתמשים ב-https://adtech.example בתור מקור הדיווח לדוגמה.
• דוח שיוך (Attribution) (דוח בקיצור) הוא הדוח הסופי (ברמת האירוע או באופן מצטבר) שמכיל את נתוני המדידה שביקשתם.
• דוח ניפוי באגים מכיל נתונים נוספים על דוח השיוך (Attribution), או על מקור או אירוע מסוג טריגר. קבלת דוח על ניפוי באגים לא בהכרח מצביעה על כך שמשהו עובד בצורה לא תקינה. יש שני סוגים של דוחות ניפוי באגים
• דוח ניפוי באגים בזמן ההעברה הוא דוח לניפוי באגים, שיש להגדיר קובץ cookie כדי ליצור ולשלוח אותו. אם לא הוגדר קובץ Cookie, ולאחר שקובצי Cookie של צד שלישי יצאו משימוש, דוחות ניפוי באגים במעבר לא יהיו זמינים. כל דוחות ניפוי הבאגים שמתוארים במדריך הזה הם דוחות ניפוי באגים בזמן מעבר.
• דוחות ניפוי באגים בהצלחה עוקבים אחרי יצירה מוצלחת של דוח שיוך. הן קשורות ישירות לדוח השיוך. דוחות ניפוי הבאגים שהצליחו זמינים החל מגרסה 101 של Chrome (אפריל 2022).
• דוחות Verbose לניפוי באגים יכולים לעקוב אחרי דוחות חסרים ולעזור לכם להבין למה הם חסרים. הם מציינים מקרים שבהם הדפדפן לא תיעד מקור או לא הפעיל אירוע (כלומר הוא לא יפיק דוח שיוך), ומקרים שבהם לא ניתן ליצור או לשלוח דוח שיוך מסיבה כלשהי. דוחות ניפוי באגים מילוליים כוללים שדה type שמתאר את הסיבה לכך שלא נוצרו אירוע מקור, אירוע הפעלה או דוח שיוך. דוחות Verbose לניפוי באגים זמינים החל מ-Chrome 109 (יציב בינואר 2023).
• מפתחות לניפוי באגים הם מזהים ייחודיים שאפשר להגדיר גם בצד המקור וגם בצד הטריגר. מפתחות לניפוי באגים מאפשרים למפות המרות שמבוססות על קובצי cookie והמרות שמבוססות על שיוך. אחרי שמגדירים את המערכת ליצור דוחות ניפוי באגים ולהגדיר מפתחות לניפוי באגים, הדפדפן יכלול את המפתחות האלה לניפוי באגים בכל דוחות השיוך (Attribution) ובדוחות ניפוי הבאגים.

למושגים נוספים ולמונחי מפתח שמופיעים במסמכי התיעוד שלנו, תוכלו לעיין במילון המונחים של ארגז החול לפרטיות.

הוראות: בדיקת השילוב בזמן אמת

1. מגדירים את המערכת ליצירת דוחות ניפוי באגים של המרות. הסבר מפורט מופיע במאמר חלק 2: הגדרת דוחות ניפוי באגים.
2. בכל פעם שמטמיעים קוד של דוחות שיוך, כדאי לבדוק בזמן אמת אם מקבלים כמה דוחות ניפוי באגים של הצלחה בנקודת הקצה. אם כן, ההגדרה של Attribution Reporting פועלת.
3. דוחות ניפוי באגים של הצלחה נשלחים רק כשמתרחשת המרה. במקום זאת, כדאי לבדוק שהשילוב מוגדר בצורה תקינה בלי קשר להמרות – כלומר, כדאי לבדוק שהמקורות נרשמים בהצלחה. כדי לעשות את זה, אפשר להסתמך על הצלחת רישום המקור ודוחות ניפוי באגים מפורטים. במאמר בנושא הגדרת דוחות של ניפוי באגים (חלק 2) מוסבר איך מגדירים אותם.

הוראות: ניתוח של אובדן נתונים ופתרון בעיות בשילוב

כדי להשוות בין תוצאות המדידה של המרות שמבוססות על קובצי Cookie לבין דוחות של Attribution Reporting, צריך להשתמש במפתחות ניפוי באגים ולמפות המרות שמבוססות על קובצי Cookie באמצעות דוחות ניפוי באגים. חשוב לזכור שדוחות ניפוי הבאגים נשלחים באופן מיידי לנקודת הקצה.

סקירה כללית

משתמשים במקשי ניפוי הבאגים (<source_debug_key, trigger_debug_key> זוג) כדי למפות המרות של קובצי Cookie לדוחות ניפוי באגים של הצלחה. לכל המרה באמצעות קובץ Cookie, האם קיבלת דוח ניפוי באגים תואם של הצלחה בזמן ההמרה?

אם כן: לגבי כל דוחות הניפוי באגים האלה שמעידים על הצלחה, צפוי להתקבל בהמשך דוח שיוך – עם כמה חריגים. פרטים נוספים זמינים במאמר בנושא תרחיש של דוח ניפוי באגים עם סטטוס Success.

אם לא: המשמעות היא שההמרה לא נרשמה ב-Attribution Reporting. משתמשים בצמד <source_debug_key, trigger_debug_key> (או במפתח לניפוי באגים של מקור אם מפתח לניפוי באגים של טריגר לא קיים) כדי למפות המרות של קובצי Cookie לדוחות מפורטים לניפוי באגים. לגבי כל אחת מההמרות האלה, קיבלת בשלב מסוים (מקור או זמן הפעלה) דוח ניפוי באגים מפורט שתואם להמרה?

• אם לא קיבלתם דוח מפורט של ניפוי באגים: יכול להיות שהסיבה לכך היא התנהגות המשתמש או בעיה בשילוב. פרטים נוספים זמינים במאמר בנושא תרחיש ללא דוח ניפוי באגים.

• אם קיבלתם דוח ניפוי באגים מפורט, כדאי לבדוק את השדה type.

  • אם הערך של type הוא source-success: המשמעות היא שמקור הנתונים נרשם בהצלחה, אבל הטריגר לא נרשם. כדי לצמצם את הסיבה לכך שדוח ניפוי הבאגים של ההצלחה חסר, מחפשים דוח ניפוי באגים מפורט תואם מכל סוג אחר – הדוח הזה יציין בעיה בצד הטריגר.

  • אם הערך של type הוא משהו אחר: המקור או הטריגר לא נרשמו. type מסביר למה. דוח השיוך המתאים (ודוח ניפוי הבאגים של ההמרות) לא יופיע. בהתאם לtype של דוח ניפוי הבאגים המפורט, יכול להיות שתרצו להתייחס למידע הזה כנקודת נתונים של ניתוח הפסדים (כלומר, לא נדרשת פעולה מצידכם), או שתרצו לדווח על באג או לפתור בעיות בהטמעה. פרטים נוספים זמינים בתרחיש של דוח ניפוי באגים מפורט.

תרחישים אפשריים

דוח ניפוי באגים של הצלחה

אם קיבלתם דוח ניפוי באגים של הצלחה לגבי המרה מסוימת שמבוססת על קובץ Cookie, המשמעות היא שההמרה הזו נרשמה בהצלחה בדוח הייחוס.

אפשר לצפות לקבל בהמשך דוח שיוך להמרה הזו, עם כמה יוצאים מן הכלל:

• התנהגות המשתמשים: מחיקת נתונים אחרי ההמרה ולפני שליחת דוח השיוך, סגירת הדפדפן וכו'. אם משתמש סוגר את הדפדפן אחרי ההמרה ולא פותח אותו במשך שבוע, הדוח לא יישלח במשך שבוע או יותר. יכול להיות שהעיכוב הזה יגרום לכם להפסד.
• רלוונטי רק לדיווח ברמת האירוע: דוח ברמת האירוע מוחלף בדוח אחר בעדיפות גבוהה יותר.
• בעיות אפשריות ברשת.

דוח מפורט לניפוי באגים מסוג source-success

אם קיבלתם דוח מפורט לניפוי באגים מסוג source-success לגבי המקור של המרה מסוימת שמשויכת לקובץ Cookie, המשמעות היא שהרישום של המקור בוצע בהצלחה. בהתאם לשאלה אם ההרשמה של הטריגר תצליח מאוחר יותר, יכול להיות שתקבלו דוח על ההמרה הזו ויכול להיות שלא.

יש נקודה אחת שחשוב לשים לב אליה:

דוח ניפוי באגים מפורט מכל סוג אחר

אם קיבלתם דוח מפורט של ניפוי באגים מכל סוג אחר לגבי המרה מסוימת שמשויכת לקובץ Cookie, לא תקבלו דוח ניפוי באגים של הצלחה, ולכן לא תקבלו דוח שיוך מאוחר יותר – כי דוח מפורט מצביע על כשל שניתן לדווח עליו. משהו מנע את רישום המקור, רישום הטריגר, יצירת הדוח או שליחת הדוח. סיבות אפשריות:

• מגבלות בנושא פרטיות
• מגבלות אחסון
• כללים מותאמים אישית
• בעיה בהטמעה בקוד
• באג בדפדפן

חלק מההתנהגויות האלה צפויות! הפעולה שצריך לבצע תלויה בtype של כל דוח מפורט. בודקים את ההפניה לדוחות מפורטים.

אין דוחות ניפוי באגים

אם קיבלתם רק דוח שיוך להמרה מסוימת שמשויכת לקובץ Cookie (לא דוח ניפוי באגים של הצלחה ולא דוח ניפוי באגים מפורט), המשמעות היא שמשהו מנע את יצירת דוחות ניפוי הבאגים. סיבות אפשריות:

• העדפות המשתמש (המשתמש השבית קובצי Cookie של צד שלישי)
• קובץ Cookie חסר או מפתחות ניפוי באגים חסרים (מפתח ניפוי הבאגים נוקה כי קובץ Cookie חסר). ב-chrome://attribution-internals, פותחים את הכרטיסייה Logs (יומנים) ובודקים אם מופיעה שם בעיה כלשהי.
• בעיות ברשת שהתרחשו בזמן המקור או הטריגר, אבל לא בזמן שליחת דוח הייחוס.

האם אתם מקבלים דוחות שיוך (Attribution)?

זהו מקרה משנה של אי-קבלת דוח ניפוי באגים: אם לגבי המרה מסוימת שמתבססת על קובץ Cookie לא קיבלתם דוחות מכל סוג (לא דוח ניפוי באגים מכל סוג, לא דוח שיוך), המשמעות היא שהתרחש כשל שלא ניתן לדווח עליו. סיבות אפשריות:

• בעיה בסיסית בשילוב. הוראות לפתרון בעיות כאלה מופיעות במאמר פתרון בעיות בסיסיות בשילוב.
• בעיות אפשריות ברשת.
• העדפות המשתמש בהגדרות הדפדפן, כמו ארגז החול לפרטיות, מושבתות.

הפניה לדוחות מפורטים של ניפוי באגים

לכל דוח מפורט של ניפוי באגים יש שדה type שבו מצוינת הסיבה לכך שדוח השיוך התואם לא נכלל. אפשר להשתמש בהפניה כדי להבין איזו פעולה צריך לבצע לגבי כל type בדוח המפורט.

ההרשמה של המקור הצליחה

מקור נרשם בהצלחה.

source-success

פרטים וגוף הדוח

דוחות על מגבלות הפרטיות

הדוחות האלה צפויים. הם מציינים מגבלות פרטיות כדי לצמצם את דליפת הזהויות של משתמשים באתרים שונים.

source-destination-limit

פרטים וגוף הדוח

source-noised

פרטים וגוף הדוח

trigger-attributions-per-source-destination-limit

פרטים וגוף הדוח

trigger-reporting-origin-limit

פרטים וגוף הדוח

trigger-event-noise

פרטים וגוף הדוח

trigger-event-excessive-reports

ההודעה הזו נוצרת אם מספר הדוחות חורג מהמגבלה. אפשר לרשום לכל היותר המרה אחת לצפיות ושלוש המרות לקליקים. חשוב לזכור שאפשר להגדיר עדיפויות כדי לקבוע אילו דוחות יתקבלו. פרטים וגוף הדוח

דוחות על מגבלות אחסון

הדוחות האלה צפויים. הן מציינות מגבלות אחסון כדי למנוע שימוש מוגזם במשאבים.

source-storage-limit

פרטים וגוף הדוח

trigger-event-storage-limit

פרטים וגוף הדוח

trigger-aggregate-storage-limit

פרטים וגוף הדוח

דוחות של כללים מותאמים אישית

הדוחות האלה צפויים אם אתם משתמשים בסינון, בהסרת כפילויות, בסדרי עדיפויות או בסינון לפי חלון זמן. למקרה הצורך, כדאי לבדוק שוב את הכללים המותאמים אישית המתאימים כדי לוודא שהדוח שמתאים לדוח המפורט הזה הוא אכן דוח שאתם רוצים להסיר. אם המידע הזה נכון, לא צריך לבצע שום פעולה.

trigger-no-matching-filter-data

פרטים וגוף הדוח

trigger-event-no-matching-configuration

פרטים וגוף הדוח

trigger-event-deduplicated

פרטים וגוף הדוח

trigger-aggregate-deduplicated

פרטים וגוף הדוח

trigger-event-low-priority

פרטים וגוף הדוח

trigger-event-report-window-passed

פרטים וגוף הדוח

trigger-aggregate-report-window-passed

פרטים וגוף הדוח

דוחות מפורטים אחרים

יכול להיות שהדוחות האלה יצביעו על בעיות אפשריות בהטמעה של הקוד.

trigger-no-matching-source

יכול להיות שזו בעיה בהטמעה. בודקים שאין טעויות בהגדרות של <reporting origin, destination>. יכול להיות שזו התנהגות צפויה של ה-API. לדוגמה, המשתמש ניקה את הנתונים בשלב מסוים אחרי האינטראקציה עם המודעה ולפני השלמת ההמרה, או שהמשתמש השלים המרה בלי שראה מודעה משויכת. פרטים וגוף הדוח

trigger-aggregate-no-contributions

סביר להניח שזה לא אופן הפעולה שרציתם שהקוד יבצע. בודקים את קוד הרישום של הטריגר ומוודאים שהגדרת התרומה נכונה. פרטים וגוף הדוח

trigger-aggregate-insufficient-budget

סביר להניח שזה לא אופן הפעולה שרציתם שהקוד יבצע. בודקים שוב את קוד הרישום של הטריגר כדי לוודא שסכום כל התרומות לא חורג מתקציב התרומות. פרטים וגוף הדוח

שגיאות לא צפויות (באגים פוטנציאליים בדפדפן)

הדוחות האלה לא צפויים. יכול להיות שהן נגרמות בגלל באג בדפדפן. מדווחים על באג ומציינים בתיאור את השלבים לשחזור הבאג.

source-unknown-error

פרטים וגוף הדוח

trigger-unknown-error

פרטים וגוף הדוח

דוגמה לניתוח הפסדים

שלב 1: הגדרה ומיפוי באמצעות קובצי Cookie

פועלים לפי ההוראות שבחלק 2: הגדרת דוחות ניפוי באגים כדי להגדיר את המערכת ליצירת דוחות ניפוי באגים של הצלחה ודוחות ניפוי באגים מפורטים.

כך תוכלו להשתמש במידע על המרות שמבוסס על קובצי Cookie כדי לחפש את דוחות ניפוי הבאגים או דוחות השיוך המתאימים.

שלב 2: זיהוי רישומים מוצלחים ודוחות חסרים

בדוגמה הזו, נניח שעקבתם אחרי 100 המרות באמצעות המערכת שמבוססת על קובצי Cookie.

בכל פעם שמתעדים המרה שמבוססת על קובץ Cookie, צריך לחפש את דוח הניפוי באגים של ההצלחה (שנשלח באופן מיידי) עם אותה <source_debug_key, trigger_debug_key> כמו של ההמרה שמבוססת על קובץ Cookie.

נניח שקיבלתם דוח ניפוי באגים של הצלחה עבור 70 מההמרות האלה שמבוססות על קובצי Cookie.

• דוחות הצלחה מציינים שהשיוך נרשם בהצלחה, כך שאפשר להניח שתקבלו דוח שיוך שמתאים לכל דוח הצלחה – עם כמה יוצאים מן הכלל.
• אתם יכולים להחליט לעקוב אחרי החריגים האלה. כדי לעשות זאת, כשהדוחות על שיוך (Attribution) יישלחו לנקודת הקצה שלכם במהלך הימים או השבועות הבאים (בהתאם לתאריך התפוגה), חפשו את הדוחות על שיוך שכוללים את אותו צמד מפתחות ניפוי באגים כמו כל דוח ניפוי באגים של המרות. חשוב לחכות קצת: יכול להיות שהדוחות לא יישלחו מיד בסוף כל חלון. נניח שמצאתם רק 60 דוחות שיוך. יכול להיות ש-10 דוחות השיוך החסרים נובעים מהתנהגות המשתמשים.

שלב 3: הערכה קצרה של אובדן

חסרים 30 דוחות ניפוי באגים של הצלחות (100 פחות 70). המשמעות היא ש-30 ההמרות האלה (שנמדדו בהטמעה מבוססת-העוגיות) לא תועדו בדוח השיוך. לא תקבלו דוחות שיוך לגביהם.

מכיוון שיש לכם 100 המרות שמבוססות על קובצי Cookie ורק 70 המרות שמבוססות על שיוך, ההפסד שלכם הוא 30%. עכשיו יש לך הערכה קצרה של ההפסד.

שלב 4: ניתוח הסיבות

כדי לבדוק למה הדוחות האלה חסרים, צריך לחפש דוחות מפורטים של ניפוי באגים שקיבלתם בזמן ההמרה (רישום הטריגר) או קודם לכן בזמן רישום המקור. משתמשים במפתחות של ההמרות שמבוססות על קובצי Cookie כדי למפות אותן לדוחות מפורטים של ניפוי באגים.

• נניח שיש 10 מפתחות שלא קיים לגביהם דוח מפורט של ניפוי באגים. בודקים אם יש בעיה בשילוב. אם לא, יכול להיות שהסיבה לכך היא התנהגות המשתמש.
• יש לך 20 דוחות מפורטים של ניפוי באגים. עכשיו אפשר לצמצם את ניתוח ההפסדים. מנתחים את השדה type בכל דוח מפורט. לדוגמה, יכול להיות שתגלו:
  • חסרים 10 דוחות (10% בדוגמה שלנו) בגלל pending destination limit
  • חסרים 5 דוחות (5%) בגלל trigger-aggregate-no-contributions.
  • חסרים 5 דוחות (5%) בגלל unknown-error.

שלב 5: פועלים בהתאם לניתוח ומנסים לפתור את הבעיה

עכשיו, אחרי שקיבלתם תובנות לגבי הסיבות לכך שדוחות חסרים, תוכלו לפעול בהתאם לתובנות האלה.

הפעולה שצריך לבצע תלויה בtype של כל דוח מפורט. פרטים נוספים זמינים במאמר בנושא דוחות מפורטים. לדוגמה:

• ‫pending-destination-limit היא הגנה על הפרטיות. לא נדרשת פעולה מצידכם. מומלץ להשתמש במספר הזה כנקודת נתונים, כדי לקבל תמונה ברורה יותר ולעקוב אחרי הנתונים.
• trigger-aggregate-no-contributions יכול להיות שזו בעיה בהטמעה בצד שלכם. תנתח את זה לעומק. אם צריך, אפשר להשתמש בפרטים בגוף הדוח המפורט כדי לפתור את הבעיה.
• יכול להיות שזו שגיאת דפדפן או שגיאת רשת.unknown-error אם הבעיה חוזרת על עצמה, צריך לדווח על באג למפתחי הדפדפן.