חלק 3 מתוך 3 בנושא ניפוי באגים בדיווח על שיוך (Attribution). מעיינים בהוראות לשימוש בדוחות של ניפוי באגים.
במדריך המתכונים הזה תמצאו הוראות לשימוש בדוחות ניפוי באגים בתרחישים שונים לדוגמה, בקטע חלק 1: מבוא לדוחות לניפוי באגים.
מילון מונחים
- המקור של הדיווח הוא המקור שמגדיר את הכותרות מקור וטריגר לדיווח השיוך.
כל הדוחות שנוצרו על ידי הדפדפן נשלחים למקור הזה. בהנחיות האלה אנחנו משתמשים ב-
https://adtech.example
בתור מקור הדיווח לדוגמה. - דוח שיוך (Attribution) (דוח בקיצור) הוא הדוח הסופי (ברמת האירוע או באופן מצטבר) שמכיל את נתוני המדידה שביקשתם.
- דוח ניפוי באגים מכיל נתונים נוספים על דוח השיוך (Attribution), או על מקור או אירוע מסוג טריגר. קבלת דוח על ניפוי באגים לא בהכרח מצביעה על כך שמשהו עובד בצורה לא תקינה. יש שני סוגים של דוחות ניפוי באגים
- דוח ניפוי באגים בזמן ההעברה הוא דוח לניפוי באגים, שיש להגדיר קובץ cookie כדי ליצור ולשלוח אותו. אם לא הוגדר קובץ Cookie, ולאחר שקובצי Cookie של צד שלישי יצאו משימוש, דוחות ניפוי באגים במעבר לא יהיו זמינים. כל דוחות ניפוי הבאגים שמתוארים במדריך הזה הם דוחות ניפוי באגים בזמן מעבר.
- דוחות ניפוי באגים בהצלחה עוקבים אחרי יצירה מוצלחת של דוח שיוך. הן קשורות ישירות לדוח השיוך. דוחות ניפוי הבאגים שהצליחו זמינים החל מגרסה 101 של Chrome (אפריל 2022).
- דוחות Verbose לניפוי באגים יכולים לעקוב אחרי דוחות חסרים ולעזור לכם להבין למה הם חסרים. הם מציינים מקרים שבהם הדפדפן לא תיעד מקור או לא הפעיל אירוע (כלומר הוא לא יפיק דוח שיוך), ומקרים שבהם לא ניתן ליצור או לשלוח דוח שיוך מסיבה כלשהי.
דוחות ניפוי באגים מילוליים כוללים שדה
type
שמתאר את הסיבה לכך שלא נוצרו אירוע מקור, אירוע הפעלה או דוח שיוך. דוחות Verbose לניפוי באגים זמינים החל מ-Chrome 109 (יציב בינואר 2023). - מפתחות לניפוי באגים הם מזהים ייחודיים שאפשר להגדיר גם בצד המקור וגם בצד הטריגר. מפתחות לניפוי באגים מאפשרים למפות המרות שמבוססות על קובצי cookie והמרות שמבוססות על שיוך. אחרי שמגדירים את המערכת ליצור דוחות ניפוי באגים ולהגדיר מפתחות לניפוי באגים, הדפדפן יכלול את המפתחות האלה לניפוי באגים בכל דוחות השיוך (Attribution) ובדוחות ניפוי הבאגים.
למושגים נוספים ולמונחי מפתח שמופיעים במסמכי התיעוד שלנו, תוכלו לעיין במילון המונחים של ארגז החול לפרטיות.
איך עושים את זה: בודקים את השילוב בזמן אמת
- מגדירים את המערכת ליצירת דוחות של ניפוי באגים בהצלחה. מידע נוסף זמין בקטע חלק 2: הגדרה של דוחות ניפוי באגים.
- בכל פעם שפורסים את הקוד של Attribution Reporting, צריך לבדוק בזמן אמת אם אתם מקבלים דוחות על תוצאות ניפוי באגים בנקודת הקצה (endpoint) שלכם. אם כן, ההגדרה של דיווח על שיוך (Attribution) פועלת.
- דוחות של ניפוי באגים להצלחה נשלחים רק כשמתרחשת המרה. במקום זאת, כדאי לוודא שהשילוב מוגדר בצורה תקינה ללא קשר להמרות. כלומר, כדאי לבדוק שהמקורות נרשמו בהצלחה. כדי לעשות זאת, תוכלו להשתמש בדוחות מפורטים של ניפוי באגים על הצלחה ברישום מקור. בחלק 2: הגדרה של דוחות ניפוי באגים מוסבר איך להגדיר אותם.
איך לבצע: ניתוח אובדן ופתרון בעיות בשילוב
כדי להשוות בין התוצאות של מעקב ההמרות שמבוססות על קובצי cookie לבין דוחות השיוך (Attribution)? אפשר להשתמש במפתחות לניפוי באגים ולמפות המרות מקובצי cookie באמצעות דוחות של ניפוי באגים. חשוב לזכור שדוחות על ניפוי באגים נשלחים מיד אל נקודת הקצה שלכם.
סקירה כללית
![שלבים לניתוח הפסדים](https://developers.google.cn/static/privacy-sandbox/assets/images/steps-a-loss-analysis-92c05fa7a306c.png?authuser=0000&hl=he)
אפשר להשתמש במפתחות לניפוי באגים (צמד <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
.
- 10 (= 10% בדוגמה שלנו) חסרים עקב
שלב 5: פועלים לפתרון הבעיות
אחרי שהבנתם למה הדוחות חסרים, תוכלו לפעול בהתאם לתובנות האלה.
הפעולה שצריך לבצע תלויה במשתנה type
של כל דוח מפורט. לפרטים נוספים, אפשר לעיין בחומר העזר בנושא דוחות מפורטים. לדוגמה:
- התוסף
pending-destination-limit
הוא הגנה על פרטיות. אין צורך לבצע פעולה כלשהי. ניתן להשתמש במספר הזה כנקודת נתונים, לצורכי חשיפה ומעקב. trigger-aggregate-no-contributions
עשוי להיות סימן לבעיה בהטמעה אצלך. עליך לנתח זאת יותר. ניתן להשתמש בפרטים בגוף הדוח המפורט כדי לפתור בעיות ולתקן אותן לפי הצורך.unknown-error
עשוי להיות סימן לבאג בדפדפן או לשגיאת רשת. אם הבעיה הזו קיימת שוב ושוב, יש לדווח על באג למפתחי הדפדפן.