חלונות דוחות בהתאמה אישית יכולים לספק דוחות מהירים יותר ברמת האירוע ודיווח סלקטיבי על דוחות שאפשר לצבור.
בעזרת חלונות דוחות מותאמים אישית לדיווח שיוך (שנוספו ב-Chrome 110), אפשר להורות לדפדפן לסנן המרות שמתרחשות אחרי חלון זמן מסוים.
- בדוחות ברמת האירוע, חלונות הדוחות מאפשרים לכם לקבל דוחות מהר יותר, בנוסף לסינון המרות שמתרחשות לאחר מסגרת זמן מסוימת. בהתאם ליעד שלכם, אפשר להסתכל על הנושא הזה גם כעל פשרה: שימוש בחלונות דוחות מאפשר לכם לגשת לדוחות מהר יותר, אבל משמעות הדבר היא שאתם עלולים לאבד חלק מההמרות. פרטים נוספים זמינים בקטע ברמת האירוע.
- בדוחות שאפשר לצבור, חלונות הדוחות מאפשרים לסנן המרות שמתרחשות לאחר מסגרת זמן מסוימת. פרטים נוספים זמינים בקטע 'נתונים שאפשר לצבור'.
מהו חלון דוח בהתאמה אישית?
חלון דוחות בהתאמה אישית הוא התקופה שלאחר רישום המקור, שבה אפשר ליצור עבור המקור הזה דוחות מהסוג המתאים (אירועים או דוחות שניתן לצבור).
בדוחות ברמת האירוע, חלון הדיווח משמש גם כחלון האחרון שבו יישלחו דוחות מהסוג המתאים.
נקודות חשובות לגבי חלונות הדיווח:
- אם לא מוגדרת
report_window
, המערכת תשתמש ב-expiry
. - אם לא מגדירים את
expiry
, המערכת חוזרת לברירת המחדל של 30 ימים. - חלון הדוח המינימלי בהתאמה אישית הוא יום אחד. גם אם תגדירו חלון של פחות מיום, הערך יוגבל ליום. עיינו בדוגמאות לדוחות ברמת האירוע.
- חלון הדוח מוגדר בשניות.
שימו לב שהאופן שבו expiry
פועל לא השתנה. expiry
משנה אילו חשיפות או קליקים עומדים בדרישות לצורך שיוך.
דוחות ברמת האירוע: דיווח מהיר יותר ודיווח סלקטיבי
כברירת מחדל, דוחות ברמת האירוע נשלחים בהתאם ללוח זמנים של חלונות דוחות מובנים: שלושה חלונות לקליקים וחלון אחד לצפיות.
בדוחות ברמת האירוע, חלונות דוחות בהתאמה אישית מאפשרים לכם:
- קבלת דוחות מהר יותר. בין היתר, חלונות דוחות מותאמים אישית מאפשרים לקבל דוחות יום אחד אחרי הקליק או החשיפת המודעה, במקום המגבלה של יומיים שהוטלה על ידי חלונות תפוגה מובנים לפני גרסה 110 של Chrome.
- לסנן המרות שמתרחשות אחרי מסגרת זמן מסוימת.
כדי להשתמש בחלונות דוחות בדוחות ברמת האירוע, מוסיפים את השדה event_report_window
לכותרת של רישום המקור Attribution-Reporting-Register-Source
.
הדוחות ברמת האירוע מתוזמנים להישלח לכל המאוחר זמן קצר אחרי סיום חלון הדיווח.
דוגמאות לתזמון דוחות ברמת האירוע, קליקים
תפוגה | event_report_window |
אם המרה מתרחשת יום אחד אחרי הקליק, הדפדפן שולח דוח: | דוחות מסוננים (לא נשלחים) לגבי המרות שמתרחשות: |
---|---|---|---|
ברירת מחדל (30 ימים) | (לא מוגדר) | כ-2 ימים ועוד שעה אחרי הלחיצה התנהגות ברירת המחדל של הדיווח – חלון מובנה מס' 1 |
כ-30 יום אחרי הקליק |
מותאם אישית, מוגדר ל-5 ימים | (לא מוגדר) | כ-2 ימים ועוד שעה אחרי הלחיצה התנהגות ברירת המחדל של הדיווח – חלון מובנה מס' 1 |
יותר מ-5 ימים אחרי הקליק |
ברירת מחדל (30 ימים) | מוגדר ליום אחד | בערך יום אחד ועוד שעה אחרי הלחיצה התנהגות מותאמת אישית עקב חלון הדוח המותאם אישית. שימו לב שהדוח זמין מהר יותר בשורה הזו מאשר בשורה הראשונה, שבה צריך להמתין לחלון המובנה הראשון (2 ימים). |
יותר מיום אחד אחרי הקליק |
בהתאמה אישית, מוגדר ל-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 הזה ולהתנסות בו.
- מומלץ לקרוא על דוחות נצברים ועל שירות הצבירה, לשאול שאלות ולשלוח משוב.
- קראו את המדריכים לדיווח על שיוך (Attribution).
- אפשר לשאול שאלות ולהצטרף לדיונים במאגר התמיכה למפתחים של ארגז החול לפרטיות.