Finestre dei report personalizzati

Le finestre dei report personalizzati possono fornire report più rapidi a livello di evento e report selettivi per i report aggregabili.

Con le finestre dei report personalizzati per l'API Attribution Reporting (implementata in Chrome 110), puoi indicare al browser di filtrare le conversioni che si verificano dopo un determinato periodo di tempo.

  • Per i report a livello di evento, le finestre dei report ti consentono di ottenere report più rapidamente, oltre a filtrare le conversioni che si verificano dopo un determinato periodo di tempo. A seconda dell'obiettivo, un altro modo per considerare questo aspetto è come un compromesso: l'utilizzo delle finestre dei report consente di accedere più rapidamente ai report, ma implica la possibilità di perdere alcune conversioni. Per maggiori dettagli, consulta la sezione a livello di evento.
  • Per i report aggregabili, le finestre dei report consentono di filtrare le conversioni che si verificano dopo un determinato periodo di tempo. Per ulteriori dettagli, consulta la sezione Aggregabile.

Che cos'è una finestra di report personalizzato?

Una finestra del report personalizzato è il periodo successivo alla registrazione dell'origine durante il quale è possibile creare report del tipo corrispondente (evento o aggregabile) per questa origine.

Per i report a livello di evento, una finestra del report funge anche da ultima finestra in cui verranno inviati i report del tipo corrispondente.

Punti chiave relativi alle finestre dei report:

  • Se non è impostato alcun report_window, viene utilizzato expiry.
  • Se non è impostato alcun expiry, viene utilizzato il valore predefinito di 30 giorni.
  • La finestra minima del report personalizzato è di un giorno. Anche se imposti una finestra inferiore a un giorno, il valore verrà limitato a un giorno. Esamina gli esempi per i report a livello di evento.
  • Una finestra del report è definita in secondi.

Tieni presente che il funzionamento di expiry non cambia; expiry modifica le impressioni o i clic idonei all'attribuzione.

Report a livello di evento: report più rapidi e selettivi

Per impostazione predefinita, i report a livello di evento vengono inviati in base a una pianificazione delle finestre di report integrate: tre finestre per i clic e una per le visualizzazioni.

Per i report a livello di evento, le finestre dei report personalizzati ti consentono di:

  • Ricevi i report più velocemente. Tra le altre cose, le finestre dei report personalizzati ti consentono di ottenere report un giorno dopo il clic o l'impressione, anziché il limite di due giorni imposto dalle finestre di scadenza integrate prima di Chrome 110.
  • Filtra le conversioni che si verificano dopo un determinato periodo di tempo.

Per utilizzare le finestre dei report per i report a livello di evento, aggiungi il campo event_report_window all'intestazione di registrazione dell'origine Attribution-Reporting-Register-Source.

I report a livello di evento vengono programmati per essere inviati al più tardi poco dopo il raggiungimento della finestra del report.

Esempi di pianificazione per report a livello di evento, clic

scadenza event_report_window Se una conversione avviene un giorno dopo il clic, il browser invia il report: Report filtrati (non inviati) per le conversioni che si verificano:
Predefinita (30 giorni) (Non impostato) Circa 2 giorni più 1 ora dopo il clic
Comportamento predefinito dei report: finestra integrata n. 1		 Circa 30 giorni dopo il clic
Personalizzato, impostato su 5 giorni (Non impostato) Circa 2 giorni più 1 ora dopo il clic
Comportamento predefinito dei report: finestra integrata n. 1		 Più di 5 giorni dopo il clic
Predefinita (30 giorni) Impostato su 1 giorno Circa 1 giorno più 1 ora dopo il clic

Comportamento personalizzato dovuto alla finestra del report personalizzato. Nota come questo report viene generato più rapidamente rispetto alla prima riga, in cui devi attendere la prima finestra integrata (2 giorni).		 Più di 1 giorno dopo il clic
Personalizzato, impostato su 5 giorni Impostato su 1 giorno Circa 1 giorno più 1 ora dopo il clic

Comportamento personalizzato dovuto alla finestra del report personalizzato		 Più di 1 giorno dopo il clic
Predefinita (30 giorni) Imposta su 4 ore Circa 1 giorno più 1 ora dopo il clic
Comportamento personalizzato dovuto alla finestra del report personalizzato. Ciò è dovuto al clamping: la finestra temporale minima del report è di un giorno. Anche se imposti una finestra del report inferiore a un giorno, ad esempio 4 ore, il suo valore verrà limitato a un giorno.		 Più di 1 giorno dopo il clic

Esempi di pianificazione per report e visualizzazioni a livello di evento

scadenza event_report_window Se una conversione avviene un giorno dopo il clic, il browser invia il report:
Predefinita (30 giorni) (Non impostato) Circa 30 giorni più 1 ora dopo la visualizzazione
Comportamento predefinito dei report
Personalizzato, impostato su 5 giorni (Non impostato) Circa 5 giorni più 1 ora dopo la visualizzazione
Comportamento predefinito dei report
Predefinita (30 giorni) Impostato su 1 giorno Circa 1 giorno più 1 ora dopo la visualizzazione
Comportamento personalizzato dovuto alla finestra del report personalizzato
Personalizzato, impostato su 5 giorni Impostato su 1 giorno Circa 1 giorno più 1 ora dopo la visualizzazione
Comportamento personalizzato dovuto alla finestra del report personalizzato

Report aggregabili: report selettivi

Per i report aggregabili, il vantaggio delle finestre del report è solo quello di filtrare le conversioni che si verificano dopo un determinato periodo di tempo. Non ci sono vantaggi in termini di velocità di ricezione dei report.

Per utilizzare le finestre dei report per i report aggregabili, aggiungi il campo aggregatable_report_window all'intestazione di registrazione dell'origine Attribution-Reporting-Register-Source.

In questo modo verranno filtrate le conversioni che si verificano dopo un determinato periodo di tempo.

I report aggregabili vengono inviati entro un'ora dall'attivazione e vengono ritardati in modo casuale tra 10 minuti e un'ora.

scadenza aggregatable_report_window Report filtrati (non inviati) per le conversioni che si verificano:
Predefinita (30 giorni) (Non impostato) Più di 30 giorni dopo il clic o la visualizzazione
Personalizzato, impostato su 5 giorni (Non impostato) Più di 5 giorni dopo il clic o la visualizzazione
Predefinita (30 giorni) Impostato su 1 giorno Più di 1 giorno dopo il clic o la visualizzazione
Personalizzato, impostato su 5 giorni Impostato su 1 giorno Più di 1 giorno dopo il clic o la visualizzazione
Predefinita (30 giorni) Imposta su 4 ore Più di un giorno dopo il clic o la visualizzazione. Ciò è dovuto al clamping: la finestra temporale minima del report è di un giorno. Anche se imposti una finestra del report inferiore a un giorno, ad esempio 4 ore, il suo valore verrà limitato a un giorno.

Partecipare e condividere feedback

Puoi partecipare e sperimentare questa API.