ספר המתכונים לניפוי באגים בדוחות שיוך (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. בכל פעם שמפרסים קוד של דיווח שיוך, צריך לבדוק בזמן אמת אם מופיעים דוחות ניפוי באגים של הצלחה בנקודת הקצה. אם כן, ההגדרה של דיווח השיוך פועלת.
  3. דוחות ניפוי באגים של המרות מוצלחות נשלחים רק כשמתרחשת המרה. במקום זאת, מומלץ לבדוק שהשילוב מוגדר כראוי ללא קשר להמרות – כלומר, מומלץ לבדוק שהמקורות רשומים בהצלחה. כדי לעשות זאת, אפשר להסתמך על דוחות ניפוי באגים מפורטים של הצלחת רישום המקור. בחלק 2: הגדרת דוחות ניפוי באגים מוסבר איך מגדירים אותם.

מדריך: ניתוח אובדן ופתרון בעיות בשילוב

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

סקירה כללית

שלבים לניתוח הפסדים

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

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

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

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

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

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

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

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

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

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

בהמשך תקבלו דוח שיוך (Attribution) לגבי ההמרה הזו⏤עם כמה יוצאים מן הכלל:

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

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

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

יש לכך תנאי אחד:

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

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

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

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

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

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

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

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

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

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

לכל דוח ניפוי באגים מפורט יש שדה 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 כדי לחפש את דוחות ניפוי הבאגים או דוחות השיוך (Attribution) התואמים.

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

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

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

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

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

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

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

מכיוון שיש לכם 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 יכולה להיות סימן לבאג בדפדפן או לשגיאה ברשת. אם הבעיה הזו מתרחשת שוב ושוב, יש לדווח על באג למפתחי הדפדפן.