Questa pagina è stata tradotta dall'API Cloud Translation.

Libro di ricette sul debug di Attribution Reporting

Parte 3 di 3 sul debug dei report sull'attribuzione. Trova le istruzioni su come utilizzare i report di debug.

In questo cookbook troverai le istruzioni per 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: controllare l'integrazione in tempo reale

Configura il sistema in modo da generare report di debug di successo. Scopri come nella Parte 2: configurare i report di debug.
Ogni volta che esegui il deployment del codice dei report sull'attribuzione, controlla in tempo reale se ricevi report di debug di successo sul tuo endpoint. In questo caso, la configurazione di Attribution Reporting funziona.
I report di debug di successo 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 farlo, puoi utilizzare i report di debug dettagliati sulla registrazione dell'origine riuscita. Scopri come configurarli nella Parte 2: configurare i report di debug.

Istruzioni: analizza le perdite e risolvi 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 dei cookie con i report di debug. Ricorda che i report di debug vengono inviati immediatamente al tuo endpoint.

Panoramica

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

Se sì: per tutti questi report di debug di successo, puoi aspettarti di ricevere in un secondo momento un report sull'attribuzione, con alcune eccezioni. Per maggiori dettagli, consulta lo scenario del report di debug di successo.

In caso contrario: significa che la conversione non è stata registrata in Attribution Reporting. Utilizza la coppia <source_debug_key, trigger_debug_key> (o la chiave di debug dell'origine se la chiave di debug dell'attivatore non è presente) per mappare le conversioni dei cookie ai report di debug dettagliati. Per ognuna di queste conversioni, hai ricevuto a un certo punto (ora di origine o attivazione) un report dettagliato di debug corrispondente?

Se non hai ricevuto un report dettagliato sul debug, 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 dettagliato sul debug, controlla il relativo campo type.
- Se type è source-success: significa che l'origine è stata registrata correttamente, ma non l'attivatore. Per restringere il motivo per cui manca il report di debug relativo al completamento, cerca un report di debug dettagliato corrispondente di qualsiasi altro tipo. Questo report indicherà un problema lato trigger.
- Se type è diverso: l'origine o l'attivatore non è stato registrato. type ti spiega perché. Il report sull'attribuzione corrispondente (e il report di debug del successo) non sarà presente. A seconda del type di un report di debug dettagliato, puoi semplicemente prendere queste informazioni come punto dati per l'analisi delle perdite (in altre parole, non devi fare nulla) oppure puoi segnalare un bug o risolvere i problemi di implementazione. Per maggiori dettagli, consulta lo scenario di report di debug dettagliato.

Possibili scenari

Report di debug di successo

Se per una determinata conversione cookie hai ricevuto un report di debug di successo, significa che questa conversione è stata registrata correttamente nei report sull'attribuzione.

Prevedi di ricevere in un secondo momento un report sull'attribuzione per questa conversione⏤con alcune eccezioni:

Comportamento dell'utente: eliminazione 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 dell'attivatore vada a buon fine anche in un secondo momento, potresti o meno ricevere un report per la conversione.

Esiste un'eccezione:

Report di debug dettagliato di qualsiasi altro tipo

Se per una determinata conversione cookie hai ricevuto un report di debug dettagliato di qualsiasi altro tipo, non riceverai un report di debug di successo e, di conseguenza, in un secondo momento non riceverai alcun report sull'attribuzione⏤perché un report dettagliato indica che si è verificato un errore registrabile. Un problema ha impedito la registrazione dell'origine, la registrazione dell'attivatore, la generazione o l'invio dei report. Possibili cause:

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

Alcuni di questi sono previsti. L'azione da intraprendere dipende da type di ogni report dettagliato. Consulta il riferimento ai report dettagliati.

Nessun report di debug

Se per una determinata conversione del cookie hai ricevuto solo un report sull'attribuzione (nessun report di debug di successo 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 viene visualizzato un problema.
Problemi di rete verificatisi all'origine o al momento dell'attivazione, ma non al momento dell'invio del report sull'attribuzione.

Ricevi report sull'attribuzione?

Si tratta di un caso particolare di mancata ricezione di un report di debug: se per una determinata conversione cookie non hai ricevuto report di alcun tipo (nessun report di debug, 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 di base.
Possibili problemi di rete.
Preferenze utente nelle impostazioni del browser, ad esempio Privacy Sandbox, disattivate.

Riferimento ai report di debug dettagliati

Ogni report dettagliato di debug 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 gli eventi di origine o di attivazione associati ai report a livello di evento. Se type di un report dettagliato inizia con trigger-aggregate, può essere generato solo per eventi di origine o attivatori associati a report aggregabili. In tutti gli altri casi, si tratta di un report aggregabile o a livello di evento.

Registrazione dell'origine riuscita

Un'origine è 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 fuga di identità utente tra 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 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 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 errori si verificano se utilizzi filtri, deduplica, priorità o filtri basati su finestre. Per sicurezza, controlla le regole personalizzate corrispondenti per verificare che il report corrispondente al report dettagliato sia effettivamente un report che vuoi eliminare. Se l'informazione è corretta, 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 nella configurazione di <reporting origin, destination>. Questo potrebbe anche essere un comportamento previsto dell'API. Ad esempio, l'utente ha cancellato i dati in un determinato momento dopo aver interagito con un annuncio e prima di effettuare una conversione oppure ha effettuato una conversione senza mai visualizzare un annuncio associato. Dettagli e corpo del report
trigger-aggregate-no-contributions: Probabilmente questo non è il comportamento che intendi che abbia il tuo codice. Risolvi i problemi relativi al codice di registrazione dell'attivatore; assicurati che la configurazione dei contributi sia corretta. Dettagli e corpo del report
trigger-aggregate-insufficient-budget: Probabilmente questo non è il comportamento che intendi che abbia il tuo codice. Controlla attentamente il codice di registrazione dell'attivatore 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 inaspettati. 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 nella Parte 2: Configurare i report di debug per configurare il sistema in modo da generare report di debug di successo 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 che tu abbia monitorato 100 conversioni con il tuo sistema basato su cookie.

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

Supponiamo che tu abbia ricevuto un report di debug positivo per 70 di queste conversioni cookie.

I report di successo indicano che l'attribuzione è stata registrata correttamente, quindi puoi presumere con certezza che riceverai un report sull'attribuzione corrispondente a ogni report di successo, con alcune eccezioni.
Puoi decidere di monitorare queste eccezioni. A tal fine, man mano che i report sull'attribuzione vengono inviati al tuo endpoint nei giorni o nelle settimane successivi (a seconda della scadenza), cerca i report sull'attribuzione che hanno la stessa coppia di chiavi di debug di ogni report di debug di successo. 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 su cookie. Molto probabilmente si tratta di report con dati non significativi generati in modo casuale dall'API. Puoi confermare questa operazione cercando report dettagliati di debug di tipo source-noised che hanno la stessa chiave di debug dell'origine del report a livello di evento.

Passaggio 3: breve valutazione della perdita

Mancano 100-70 = 30 report di debug di successo. Ciò significa che queste 30 conversioni (monitorate nell'implementazione basata sui cookie) non sono state registrate con i report sull'attribuzione. Non riceverai report sull'attribuzione per questi dati.

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 scoprire il motivo per cui questi report non sono presenti, cerca i report di debug dettagliati corrispondenti che hai ricevuto al momento della conversione (registrazione dell'attivatore) o in precedenza al momento della registrazione dell'origine. Utilizza le chiavi delle conversioni basate su cookie per mapparle ai report di debug dettagliati.

Supponiamo che esistano 10 chiavi per le quali non è disponibile 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:
- Mancano 10 (= 10% nel nostro esempio) report 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 capito perché i report non sono disponibili, puoi intervenire in base a queste informazioni.

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

pending-destination-limit è una protezione della privacy. Non devi fare nulla. 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. Utilizza i dettagli nel corpo del report dettagliato per risolvere il problema, se necessario.
unknown-error potrebbe indicare un bug del browser o un errore di rete. Se il problema si verifica ripetutamente, segnala un bug agli sviluppatori del browser.