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

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

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

מילון מונחים

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

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

איך עושים את זה: בודקים את השילוב בזמן אמת

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

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

כדי להשוות בין התוצאות של מעקב ההמרות שמבוססות על קובצי cookie לבין דוחות השיוך (Attribution)? אפשר להשתמש במפתחות לניפוי באגים ולמפות המרות מקובצי 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 Reporting.

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

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

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

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

יש אזהרה אחת לגבי זה:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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