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

L'origine dei report è l'origine che imposta l'origine e l'attivatore di Attribution Reporting. Tutti i report generati dal browser vengono inviati a questa origine. In queste indicazioni, utilizziamo https://adtech.example come origine di segnalazione di esempio.
Un report sull'attribuzione (in breve report) è il report finale (a livello di evento o aggregabile) contenente i dati di misurazione che hai richiesto.
Un report di debug contiene dati aggiuntivi su un report sull'attribuzione o su un'origine o un evento di attivazione. La ricezione di un report di debug non significa necessariamente che qualcosa funzioni in modo errato. Esistono due tipi di report di debug
Un report di debug di transizione è un report di debug che richiede l'impostazione di un cookie per poter essere generato e inviato. I report di debug di transizione non saranno disponibili se non viene impostato un cookie e quando i cookie di terze parti verranno ritirati. Tutti i report di debug descritti in questa guida sono report di debug di transizione.
I report di debug riusciti monitorano la generazione riuscita di un report sull'attribuzione. Sono direttamente correlate a un report sull'attribuzione. Sono disponibili report di debug riuscito a partire dalla versione 101 di Chrome (aprile 2022).
I report di debug dettagliati possono monitorare i report mancanti e aiutarti a determinarne il motivo. Indicano i casi in cui il browser non ha registrato un'origine o un evento di attivazione, il che significa che non genererà un report sull'attribuzione, e casi in cui un report sull'attribuzione non può essere generato o inviato per qualche motivo. I report di debug dettagliati includono un campo type che descrive il motivo per cui un evento di origine, un evento di attivazione o un report sull'attribuzione non è stato generato. I report di debug dettagliati sono disponibili a partire da Chrome 109 (stabile a gennaio 2023).
Le chiavi di debug sono identificatori univoci che puoi impostare sia sul lato di origine sia sul lato trigger. Le chiavi di debug ti consentono di mappare le conversioni basate sui cookie e quelle basate sull'attribuzione. Una volta configurato il sistema per generare report di debug e impostare chiavi di debug, il browser includerà queste chiavi di debug in tutti i report sull'attribuzione e in tutti i report di debug.

Per altri concetti e termini chiave utilizzati nella nostra documentazione, consulta il glossario di Privacy Sandbox.

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 dei report sull'attribuzione 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 relativo al 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 nei report sull'attribuzione. 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 relativo al completamento) 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 del 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 del cookie hai ricevuto un report dettagliato di debug di qualsiasi altro tipo, non riceverai un report di debug di successo e, di conseguenza, in un secondo momento nessun 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 di debug dettagliato contiene 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 attivatori associati a report a livello di evento. Se 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 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 alla 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 sui limiti di 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 sono previsti 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 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 non sono previsti. 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 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 del successo (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 dei cookie.

I report di successo indicano che l'attribuzione è stata registrata correttamente, pertanto 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, poiché i report sull'attribuzione vengono inviati al tuo endpoint nei giorni/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 che tu trovi 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. 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 è richiesta 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. 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.