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