חלונות דוחות בהתאמה אישית

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

בעזרת חלונות דוחות בהתאמה אישית בדוח השיוך (שנשלח ב-Chrome 110), אפשר להנחות את הדפדפן לסנן המרות שמתרחשות אחרי חלון זמן מסוים.

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

מהו חלון דוחות בהתאמה אישית?

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

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

נקודות חשובות לגבי חלונות דיווח:

  • אם לא מוגדר report_window, ברירת המחדל היא expiry.
  • אם לא מוגדר expiry, ברירת המחדל היא 30 ימים.
  • החלון המינימלי של דוח בהתאמה אישית הוא יום אחד. גם אם תגדירו חלון של פחות מיום, הערך יוגבל ליום. דוגמאות לדוחות ברמת האירוע
  • חלון הדוח מוגדר בשניות.

חשוב לשים לב שהאופן שבו expiry פועל לא השתנה. expiry משנה את החשיפות או הקליקים שעומדים בדרישות לשיוך.

דוחות ברמת האירוע: דיווח מהיר ודיווח סלקטיבי

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

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

  • קבלת דוחות מהר יותר. בין היתר, חלונות מותאמים אישית של דוחות מאפשרים לכם לקבל דוחות יום אחד אחרי הקליק או החשיפה, במקום מגבלת היומיים שהייתה קיימת בחלונות התפוגה המובנים לפני Chrome 110.
  • סינון המרות שמתרחשות אחרי פרק זמן מסוים.

כדי להשתמש בחלונות דיווח בדוחות ברמת האירוע, מוסיפים את השדה event_report_window לכותרת של רישום המקור Attribution-Reporting-Register-Source.

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

דוגמאות לתזמון של דוחות ברמת האירוע, קליקים

תפוגה event_report_window אם המרה מתרחשת יום אחרי הקליק, הדפדפן שולח דוח: הדוחות מסוננים (לא נשלחים) להמרות שמתרחשות:
ברירת מחדל (30 ימים) (לא מוגדר) בערך יומיים ושעה אחרי הקליק
התנהגות הדיווח שמוגדרת כברירת מחדל – חלון מובנה מספר 1
כ-30 יום אחרי הקליק
מותאם אישית, מוגדר ל-5 ימים (לא מוגדר) בערך יומיים ושעה אחרי הקליק
התנהגות הדיווח שמוגדרת כברירת מחדל – חלון מובנה מספר 1
יותר מ-5 ימים אחרי הקליק
ברירת מחדל (30 ימים) הגדרה ליום אחד בערך יום אחד ושעה אחת אחרי הקליק

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

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

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

תפוגה event_report_window אם המרה מתרחשת יום אחרי הקליק, הדפדפן שולח דוח:
ברירת מחדל (30 ימים) (לא מוגדר) כ-30 ימים ושעה אחרי הצפייה
התנהגות ברירת המחדל של הדיווח
מותאם אישית, מוגדר ל-5 ימים (לא מוגדר) כ-5 ימים ושעה אחרי הצפייה
התנהגות ברירת המחדל של הדיווח
ברירת מחדל (30 ימים) הגדרה ליום אחד בערך יום אחד ושעה אחרי הצפייה
התנהגות מותאמת אישית בגלל חלון הדוח המותאם אישית
מותאם אישית, מוגדר ל-5 ימים הגדרה ליום אחד בערך יום אחד ושעה אחרי הצפייה
התנהגות מותאמת אישית בגלל חלון הדוח המותאם אישית

דוחות שניתן לצבור: דיווח סלקטיבי

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

כדי להשתמש בחלונות דיווח בדוחות שניתן לצבור, מוסיפים את השדה aggregatable_report_window לכותרת של רישום המקור Attribution-Reporting-Register-Source.

הסינון הזה יסיר המרות שמתרחשות אחרי פרק זמן מסוים.

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

תפוגה aggregatable_report_window הדוחות מסוננים (לא נשלחים) להמרות שמתרחשות:
ברירת מחדל (30 ימים) (לא מוגדר) יותר מ-30 ימים אחרי קליק או צפייה
מותאם אישית, מוגדר ל-5 ימים (לא מוגדר) יותר מ-5 ימים אחרי קליק או צפייה
ברירת מחדל (30 ימים) הגדרה ליום אחד יותר מיום אחד אחרי הקליק או הצפייה
מותאם אישית, מוגדר ל-5 ימים הגדרה ליום אחד יותר מיום אחד אחרי הקליק או הצפייה
ברירת מחדל (30 ימים) הגדרה ל-4 שעות יותר מיום אחד אחרי קליק או צפייה. הסיבה לכך היא הגבלה: חלון הדוחות המינימלי הוא יום אחד. גם אם מגדירים חלון דוח של פחות מיום, למשל 4 שעות, הערך שלו יוגבל ליום.

השתתפות ושיתוף משוב

אתם יכולים להשתתף ולהתנסות ב-API הזה.