Alcune tecnologie Privacy Sandbox verranno ritirate gradualmente.

Consulta il nostro aggiornamento sui piani per le tecnologie Privacy Sandbox.

Stato delle funzionalità di Privacy Sandbox fornisce ulteriori informazioni sullo stato delle singole API e funzionalità della piattaforma.

Libro di ricette sul debug di Attribution Reporting

Parte 3 di 3 sul debug di Attribution Reporting. Trova le istruzioni su come utilizzare i report di debug.

In questo cookbook troverai le istruzioni su come utilizzare i report di debug per vari casi d'uso descritti nella Parte 1: Introduzione ai report di debug.

Glossario

The reporting origin is the origin that sets the Attribution Reporting source and trigger headers. All reports generated by the browser are sent to this origin. In this guidance, we use https://adtech.example as the example reporting origin.
An attribution report (report for short) is the final report (event-level or aggregatable) that contains the measurement data you've requested.
A debug report contains additional data about an attribution report, or about a source or trigger event. Receiving a debug report does not necessarily mean that something is working incorrectly! There are two types of debug reports
A transitional debug report is a debug report that requires a cookie to be set in order to be generated and sent. Transitional debug reports will be unavailable if a cookie is not set, and once third-party cookies are deprecated. All debug reports described in this guide are transitional debug reports.
Success debug reports track successful generation of an attribution report. They relate directly to an attribution report. Success debug reports have been available since Chrome 101 (April 2022).
Verbose debug reports can track missing reports and help you determine why they're missing. They indicate cases where the browser did not record a source or trigger event, (which means it will not generate an attribution report), and cases where an attribution report can't be generated or sent for some reason. Verbose debug reports include a type field that describes the reason why a source event, trigger event or attribution report was not generated. Verbose debug reports are available starting in Chrome 109 (Stable in January 2023).
Debug keys are unique identifiers you can set on both the source side and the trigger side. Debug keys enable you to map cookie-based conversions and attribution-based conversions. When you've set up your system to generate debug reports and set debug keys, the browser will include these debug keys in all attribution reports and debug reports.

For more concepts and key terms used throughout our documentation, refer to the Privacy Sandbox glossary.

Istruzioni: controlla l'integrazione in tempo reale

Configura il sistema per generare report di debug riusciti. Scopri come nella Parte 2: configura i report di debug.
Ogni volta che implementi il codice Attribution Reporting, controlla in tempo reale se ricevi alcuni report di debug riusciti sull'endpoint. In questo caso, la configurazione dei report sull'attribuzione funziona.
I report di debug riusciti vengono inviati solo quando si verifica una conversione. Ti consigliamo invece di verificare che l'integrazione sia configurata correttamente indipendentemente dalle conversioni, ovvero che le origini siano registrate correttamente. Per raggiungere questo obiettivo, puoi fare affidamento a registrazione delle sorgenti riuscita e report di debug dettagliati. Scopri come configurarli nella Parte 2: configura i report di debug.

Guida pratica: analizzare la perdita e risolvere i problemi di integrazione

Per confrontare i risultati della misurazione delle conversioni basata sui cookie con i report Attribution Reporting, utilizza le chiavi di debug e mappa le conversioni basate sui cookie con i report di debug. Ricorda che i report di debug vengono inviati immediatamente all'endpoint.

Panoramica

Passaggi per un'analisi delle perdite — Passaggi per un'analisi della perdita

Utilizza le chiavi di debug (coppia <source_debug_key, trigger_debug_key>) per mappare le conversioni dei cookie ai report di debug riusciti. Per ogni conversione da cookie, al momento della conversione hai ricevuto un report di debug di esito positivo corrispondente?

Se la risposta è sì: per tutti questi report di debug riusciti, in un secondo momento riceverai un report sull'attribuzione, con alcune eccezioni. Per maggiori dettagli, consulta lo scenario del report di debug riuscito.

Se no: significa che la conversione non è stata registrata con Attribution Reporting. Utilizza la coppia <source_debug_key, trigger_debug_key> (o la chiave di debug dell'origine se la chiave di debug del trigger è assente) per mappare le conversioni dei cookie ai report di debug dettagliati. Per ciascuna di queste conversioni, hai ricevuto a un certo punto (ora di origine o trigger) un report di debug dettagliato corrispondente?

Se non hai ricevuto un report di debug dettagliato, il problema potrebbe essere dovuto al comportamento dell'utente o a un problema di integrazione. Per maggiori dettagli, consulta lo scenario senza report di debug.
Se hai ricevuto un report di debug dettagliato, esamina il campo type.
- Se il suo type è source-success: significa che l'origine è stata registrata correttamente, ma il trigger no. Per restringere il motivo per cui manca il report di debug di successo, cerca un report di debug dettagliato corrispondente di qualsiasi altro tipo. Questo report indicherà un problema sul lato del trigger.
- Se il suo type è diverso: l'origine o il trigger non sono stati registrati. type ti spiega il motivo. Il report sull'attribuzione corrispondente (e il report di debug riuscito) non sarà presente. A seconda del type di un report di debug dettagliato, potresti voler considerare queste informazioni solo come un punto dati di analisi delle perdite (in altre parole, non è richiesta alcuna azione da parte tua) oppure potresti voler segnalare un bug o risolvere i problemi di implementazione. Per maggiori dettagli, consulta lo scenario del report di debug dettagliato.

Possibili scenari

Report di debug riuscito

Se per una determinata conversione da cookie hai ricevuto un report di debug riuscito, significa che questa conversione è stata registrata correttamente con Attribution Reporting.

Puoi aspettarti di ricevere in un secondo momento un report sull'attribuzione per questa conversione, con alcune eccezioni:

Comportamento degli utenti: cancellazione dei dati dopo la conversione e prima dell'invio del report sull'attribuzione, chiusura del browser e così via. Se un utente chiude il browser dopo la conversione e non lo apre per una settimana, il report non verrà inviato per una settimana o più. Potresti considerare questo ritardo come una perdita.
Applicabile solo a livello di evento: un report a livello di evento viene sostituito da un altro report con priorità più alta.
Possibili problemi di rete.

Report di debug dettagliato di tipo `source-success`

Se per l'origine di una determinata conversione cookie hai ricevuto un report di debug dettagliato di tipo source-success, significa che la registrazione dell'origine è andata a buon fine. A seconda che la registrazione del trigger abbia esito positivo in un secondo momento, potresti ricevere o meno un report per quella conversione.

C'è un'avvertenza da tenere presente:

Report di debug dettagliato di qualsiasi altro tipo

Se per una determinata conversione dei cookie hai ricevuto un report di debug dettagliato di qualsiasi altro tipo, non riceverai un report di debug riuscito e quindi nessun report sull'attribuzione, perché un report dettagliato indica che si è verificato un errore segnalabile. Un problema ha impedito la registrazione dell'origine, del trigger, la generazione del report o l'invio del report. Possibili cause:

Limiti di privacy
Limiti di archiviazione
Regole personalizzate
Problema di implementazione nel codice
Bug del browser

Alcuni di questi sono previsti. L'azione da intraprendere dipende dal type di ogni report dettagliato. Consulta i riferimenti dei report dettagliati.

Nessun report di debug

Se per una determinata conversione da cookie hai ricevuto solo un report sull'attribuzione (nessun report di debug riuscito né report di debug dettagliato), significa che qualcosa ha impedito la generazione dei report di debug. Possibili cause:

Preferenze dell'utente (l'utente ha disattivato i cookie di terze parti)
Cookie mancante o chiavi di debug mancanti (chiave di debug cancellata a causa di un cookie mancante). In chrome://attribution-internals, apri la scheda Log e controlla se è presente qualche problema.
Problemi di rete verificatisi all'ora di origine o di attivazione, ma non al momento dell'invio del report sull'attribuzione.

Ricevi report sull'attribuzione?

Si tratta di un sottocaso di mancata ricezione di un report di debug: se per una determinata conversione da cookie non hai ricevuto report di alcun tipo (nessun report di debug di alcun tipo, nessun report sull'attribuzione), significa che si è verificato un errore non segnalabile. Possibili cause:

Problema di integrazione fondamentale. Scopri come risolvere questi problemi in Risolvere i problemi di integrazione fondamentali.
Possibili problemi di rete.
Preferenze utente nelle impostazioni del browser, ad esempio Privacy Sandbox disattivata.

Riferimento ai report di debug dettagliati

Ogni report di debug dettagliato ha un campo type che indica il motivo per cui il report sull'attribuzione corrispondente è stato eliminato. Utilizza il riferimento per capire, per ogni type del report dettagliato, quale azione intraprendere.

Nota:se type di un report dettagliato inizia con trigger-event, può essere generato solo per eventi di origine o trigger associati a report a livello di evento. Se l'type di un report dettagliato inizia con trigger-aggregate, può essere generato solo per eventi di origine o trigger associati a report aggregabili. In tutti gli altri casi, si tratta di un report a livello di evento o aggregabile.

Registrazione dell'origine riuscita

Una sorgente è stata registrata correttamente.

source-success: Dettagli e corpo del report

Report sulle limitazioni della privacy

Questi report sono previsti. Indicano limitazioni della privacy per ridurre la divulgazione dell'identità degli utenti tra i siti.

source-destination-limit: Dettagli e corpo del report
source-noised: Dettagli e corpo del report
trigger-attributions-per-source-destination-limit: Dettagli e corpo del report
trigger-reporting-origin-limit: Dettagli e corpo del report
trigger-event-noise: Dettagli e corpo del report
trigger-event-excessive-reports: Questo valore viene generato se il conteggio dei report supera il limite. Puoi registrare al massimo una conversione per le visualizzazioni e tre per i clic. Tieni presente che puoi configurare i report da ricevere impostando le priorità. Dettagli e corpo del report

Report sulle limitazioni dello spazio di archiviazione

Questi report sono previsti. Indicano le limitazioni dello spazio di archiviazione per evitare un utilizzo eccessivo delle risorse.

source-storage-limit: Dettagli e corpo del report
trigger-event-storage-limit: Dettagli e corpo del report
trigger-aggregate-storage-limit: Dettagli e corpo del report

Report sulle regole personalizzate

Questi report sono previsti se utilizzi filtri, deduplicazione, priorità o filtri basati su finestre. Per sicurezza, controlla le regole personalizzate corrispondenti per confermare che il report corrispondente a quello dettagliato sia effettivamente un report che vuoi eliminare. Se è così, non devi fare nulla.

trigger-no-matching-filter-data: Dettagli e corpo del report
trigger-event-no-matching-configuration: Dettagli e corpo del report
trigger-event-deduplicated: Dettagli e corpo del report
trigger-aggregate-deduplicated: Dettagli e corpo del report
trigger-event-low-priority: Dettagli e corpo del report
trigger-event-report-window-passed: Dettagli e corpo del report
trigger-aggregate-report-window-passed: Dettagli e corpo del report

Altri report dettagliati

Questi report potrebbero indicare potenziali problemi di implementazione nel codice.

trigger-no-matching-source: Potrebbe trattarsi di un problema di implementazione. Verifica che non ci siano errori di configurazione in <reporting origin, destination>. Questo potrebbe anche essere un comportamento previsto dell'API. Ad esempio, l'utente ha cancellato i dati a un certo punto dopo aver interagito con un annuncio e prima di effettuare la conversione oppure ha effettuato la conversione senza mai vedere un annuncio associato. Dettagli e corpo del report
trigger-aggregate-no-contributions: Probabilmente non è il comportamento che vuoi che abbia il tuo codice. Risolvi i problemi relativi al codice di registrazione del trigger e assicurati che la configurazione del contributo sia corretta. Dettagli e corpo del report
trigger-aggregate-insufficient-budget: Probabilmente non è il comportamento che vuoi che abbia il tuo codice. Controlla attentamente il codice di registrazione del trigger per assicurarti che la somma di tutti i contributi non superi il budget dei contributi. Dettagli e corpo del report

Errori imprevisti (potenziali bug del browser)

Questi report sono inattesi. Potrebbero essere dovuti a un bug del browser. Segnala un bug e specifica nella descrizione i passaggi per riprodurlo.

source-unknown-error: Dettagli e corpo del report
trigger-unknown-error: Dettagli e corpo del report

Esempio di analisi delle perdite

Passaggio 1: configurazione e mappatura con i cookie

Segui le istruzioni riportate nella Parte 2: Configurare i report di debug per configurare il sistema in modo da generare report di debug riusciti e report di debug dettagliati.

In questo modo, puoi utilizzare le informazioni sulle conversioni basate sui cookie per cercare i report di debug o di attribuzione corrispondenti.

Passaggio 2: identifica le registrazioni riuscite e i report mancanti

In questo esempio, supponiamo di aver monitorato 100 conversioni con il tuo sistema basato sui cookie.

Ogni volta che registri una conversione basata sui cookie, cerca il report di debug riuscito (inviato immediatamente) che ha la stessa coppia <source_debug_key, trigger_debug_key> di questa conversione basata sui cookie.

Supponiamo di aver ricevuto un report di debug riuscito per 70 di queste conversioni da cookie.

I report di successo indicano che l'attribuzione è stata registrata correttamente, quindi puoi dare per scontato che riceverai un report sull'attribuzione corrispondente a ogni report di successo, con alcune eccezioni.
Puoi decidere di monitorare queste eccezioni. A questo scopo, man mano che i report sull'attribuzione vengono inviati al tuo endpoint nei giorni o nelle settimane successive (a seconda della scadenza), cerca i report sull'attribuzione che hanno la stessa coppia di chiavi di debug di ogni report di debug riuscito. Assicurati di attendere un po': i report potrebbero non essere inviati immediatamente al termine di ogni finestra. Supponiamo di trovare solo 60 report sull'attribuzione. I 10 report sull'attribuzione mancanti potrebbero essere dovuti al comportamento degli utenti.

Nota:è possibile che tu abbia report sull'attribuzione a livello di evento che non vengono mappati a una conversione basata sui cookie. Si tratta molto probabilmente di report rumorosi generati in modo casuale dall'API. Puoi verificarlo cercando i report dettagliati di debug di tipo source-noised che hanno la stessa chiave di debug di origine del report a livello di evento.

Passaggio 3: valutazione sommaria della perdita

Mancano 30 report di debug riusciti. Ciò significa che queste 30 conversioni (monitorate nell'implementazione basata sui cookie) non sono state registrate con Attribution Reporting. Non riceverai report sull'attribuzione per questi elementi.

Poiché hai 100 conversioni basate sui cookie e solo 70 conversioni basate sull'attribuzione, la perdita è del 30%. Ora hai una breve valutazione della perdita.

Passaggio 4: analizza le cause

Per capire perché questi report non sono presenti, cerca i report di debug dettagliati corrispondenti che hai ricevuto al momento della conversione (registrazione dei trigger) o in precedenza al momento della registrazione dell'origine. Utilizza le chiavi delle conversioni basate sui cookie per mapparle ai report di debug dettagliati.

Supponiamo che ci siano 10 chiavi per le quali non è presente un report di debug dettagliato. Controlla se ci sono problemi di integrazione. In caso contrario, il problema potrebbe essere dovuto al comportamento dell'utente.
Hai 20 report di debug dettagliati. Ora puoi perfezionare l'analisi delle perdite. Analizza il campo type di ogni report dettagliato. Ad esempio, potresti scoprire che:
- 10 (= 10% nel nostro esempio) report mancano a causa di pending destination limit
- Mancano 5 report (5%) a causa di trigger-aggregate-no-contributions.
- Mancano 5 report (5%) a causa di unknown-error.

Passaggio 5: intervieni e risolvi i problemi

Ora che hai visibilità sul motivo per cui mancano i report, puoi agire in base a questi approfondimenti.

L'azione da intraprendere dipende dal type di ogni report dettagliato. Per ulteriori dettagli, consulta il riferimento ai report dettagliati. Ad esempio:

pending-destination-limit è una protezione della privacy. Non devi intraprendere alcuna azione. Utilizza questo numero come punto dati per la tua visibilità e il tuo monitoraggio.
trigger-aggregate-no-contributions potrebbe indicare un problema di implementazione da parte tua. Analizza ulteriormente questo aspetto. Utilizza i dettagli nel corpo del report dettagliato per risolvere il problema, se necessario.
unknown-error potrebbe essere il segno di un bug del browser o di un errore di rete. Se riscontri questo problema ripetutamente, segnala un bug agli sviluppatori del browser.