Parte 3 di 3 sul debug di Attribution Reporting. Trova le istruzioni su come utilizzare i report di debug.
In questo libro di ricette troverai le istruzioni su come utilizzare i report di debug per i 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: controlla l'integrazione in tempo reale
- Configura il sistema per generare report di debug riusciti. Scopri come fare nella Parte 2: configurare i report di debug.
- Ogni volta che esegui il deployment del codice di Attribution Reporting, verifica in tempo reale se stai ricevendo alcuni report di debug riusciti sul tuo endpoint. In questo caso, la configurazione dei report di 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. A questo scopo, puoi utilizzare i report di debug dettagliati per la registrazione dell'origine riuscita. Scopri come impostarli nella Parte 2: configurare i report di debug.
Procedura: analizzare la perdita e risolvere i problemi dell'integrazione
Per confrontare i risultati della misurazione delle conversioni basata sui cookie con i report sull'attribuzione, 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
![Passaggi per l'analisi delle perdite](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/steps-a-loss-analysis-92c05fa7a306c.png?authuser=19&hl=it)
Utilizza le chiavi di debug (<source_debug_key, trigger_debug_key>
coppia) per mappare le conversioni dei cookie ai report di debug corretti.
Per ogni conversione di cookie, hai ricevuto un report di debug riuscito corrispondente al momento della conversione?
Se la risposta è sì: per tutti questi report di debug efficaci, dovresti ricevere un report sull'attribuzione in un secondo momento, con alcune eccezioni. Per maggiori dettagli, esamina lo scenario del report di debug riuscito.
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 del codice sorgente se non è presente la chiave di debug dell'attivatore) per mappare le conversioni dei cookie a report di debug dettagliati. Per ciascuna di queste conversioni, a un certo punto (origine o ora di attivazione) hai ricevuto un report di debug dettagliato corrispondente?
Se non hai ricevuto un report di debug dettagliato, la causa potrebbe essere il comportamento dell'utente o un problema di integrazione. Per informazioni dettagliate, esamina lo scenario senza report di debug.
Se hai ricevuto un report di debug dettagliato, controlla il campo
type
.Se il valore
type
èsource-success
, significa che l'origine è stata registrata correttamente, ma l'attivatore non è stato registrato. Per restringere il motivo per cui manca il report di debug corretto, cerca un report di debug dettagliato corrispondente di qualsiasi altro tipo, il report indicherà un problema sul lato attivatore.Se il valore
type
corrisponde a qualcos'altro, significa che l'origine o l'attivatore non sono stati registrati.type
ti spiega il motivo. Non sarà presente il report sull'attribuzione corrispondente (e il report di debug riuscito). A seconda dell'type
di un report di debug dettagliato, potresti voler considerare queste informazioni come un punto dati per l'analisi della perdita (in altre parole, nessuna azione per te) oppure potresti voler segnalare un bug o risolvere i problemi relativi all'implementazione. Per informazioni dettagliate, esamina lo scenario del report di debug dettagliato.
Scenari possibili
Report di debug riuscito
Se per una determinata conversione dei cookie hai ricevuto un report di debug riuscito, significa che la conversione è stata registrata correttamente in Attribution Reporting.
Potresti 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 apre il browser per una settimana, il report non verrà inviato per almeno una settimana. Potresti considerare questo ritardo come una perdita.
- Applicabile solo a livello di evento: un report a livello di evento è sostituito da un altro report con priorità più elevata.
- Possibili problemi di rete.
Report di debug dettagliato di tipo source-success
Se per l'origine di una determinata conversione dei cookie hai ricevuto un report di debug dettagliato di tipo source-success
, significa che la registrazione dell'origine è riuscita. A seconda che la registrazione del trigger abbia esito positivo in un secondo momento, è possibile che tu riceva o meno un report per quella conversione.
A questo proposito, occorre tenere presente quanto segue:
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 con esito positivo e, in un secondo momento, non riceverai alcun report sull'attribuzione perché un report dettagliato indica che si è verificato un errore segnalabile. Qualcosa ha impedito la registrazione dell'origine, la registrazione di trigger, la generazione o l'invio di report. Possibili cause:
- Limiti relativi alla 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 valore type
di ogni report dettagliato. Consulta il riferimento ai report dettagliati.
Nessun report di debug
Se, per una determinata conversione dei cookie, hai ricevuto solo un report sull'attribuzione (nessun report di debug riuscito o report di debug dettagliato), significa che qualcosa ha impedito la generazione dei report di debug. Possibili cause:
- Preferenze utente (l'utente ha disattivato i cookie di terze parti)
- Cookie mancanti 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 si è verificato un problema. - Problemi di rete che si sono verificati al momento dell'origine o di attivazione, ma non al momento dell'invio del report sull'attribuzione.
Ricevi report sull'attribuzione?
Si tratta di un caso in cui non ricevi un report di debug: se per una determinata conversione dei cookie non hai ricevuto report di alcun tipo (nessun report di debug di alcun tipo o nessun report sull'attribuzione), significa che si è verificato un errore non segnalabile. Possibili cause:
- Problema di integrazione di base. Scopri come risolvere questi problemi in Risolvere i problemi di integrazione fondamentali.
- Possibili problemi di rete.
- Preferenze utente nelle impostazioni del browser, come Privacy Sandbox disattivate.
Riferimento dettagliato ai report di debug
Ogni report di debug dettagliato ha un campo type
che mostra il motivo per cui il report sull'attribuzione corrispondente è stato eliminato. Utilizza il riferimento per capire, per ogni type
di report dettagliato, quale azione intraprendere.
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à degli utenti 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
- Viene generato se il numero di 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 report sono previsti se utilizzi filtri, deduplicazione, priorità o filtri basati su finestre. In caso affermativo, verifica le regole personalizzate corrispondenti per confermare che il report corrispondente a quel report dettagliato sia effettivamente un report che vuoi eliminare. Se è corretto, non è richiesta alcuna azione da parte tua.
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 possono indicare potenziali problemi di implementazione nel codice.
trigger-no-matching-source
- Potrebbe trattarsi di un problema di implementazione. Verifica che non siano presenti errori di configurazione nella configurazione di
<reporting origin, destination>
. Questo potrebbe anche essere il 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 una conversione oppure ha effettuato una conversione senza mai aver visualizzato un annuncio associato. Dettagli e corpo del report trigger-aggregate-no-contributions
- È probabile che questo non sia il comportamento previsto dal codice. Risolvi i problemi relativi al codice di registrazione del trigger; assicurati che la configurazione dei contributi sia corretta. Dettagli e corpo del report
trigger-aggregate-insufficient-budget
- È probabile che questo non sia il comportamento previsto dal codice. Ricontrolla 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)
Queste segnalazioni sono impreviste. Il problema potrebbe essere dovuto 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: configura e mappa con i cookie
Segui le istruzioni riportate nella Parte 2: configurare i report di debug per configurare il sistema in modo che generi report di debug corretti e report di debug dettagliati.
In questo modo, puoi utilizzare le informazioni sulle conversioni basate sui cookie per cercare i report di debug o sull'attribuzione corrispondenti.
Passaggio 2: identifica le registrazioni andate a buon fine e i report mancanti
In questo esempio, supponiamo che tu abbia 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 su cookie.
Supponiamo che tu abbia ricevuto un report di debug con esito positivo per 70 di queste conversioni dei cookie.
- I report sull'attribuzione indicano che l'attribuzione è stata registrata correttamente, pertanto puoi presumere che riceverai un report sull'attribuzione corrispondente a ciascun report di successo, con alcune eccezioni.
- Puoi decidere di monitorare queste eccezioni. Per farlo, poiché i report sull'attribuzione vengono inviati sul tuo endpoint nel corso dei prossimi giorni/settimane (a seconda della scadenza), cerca i report sull'attribuzione che hanno la stessa coppia di chiavi di debug di ogni report di debug riuscito. Attendi un po': i report potrebbero non essere inviati immediatamente alla fine di ogni finestra. Supponiamo che trovi solo 60 report sull'attribuzione. I 10 report sull'attribuzione mancanti potrebbero essere dovuti al comportamento degli utenti.
Passaggio 3: breve valutazione della perdita
100-70 = 30 report di debug riusciti mancanti. Ciò significa che queste 30 conversioni (che sono state monitorate nell'implementazione basata sui cookie) non sono state registrate con i report sull'attribuzione. Non riceverai report sull'attribuzione per questi dispositivi.
Dal momento che hai 100 conversioni basate sui cookie e solo 70 conversioni basate sull'attribuzione, la perdita è pari al 30%. Ora hai una breve valutazione della perdita.
Passaggio 4: analizza le cause
Per capire il motivo dell'assenza di questi report, cerca i report di debug dettagliati corrispondenti che hai ricevuto al momento della conversione (registrazione dell'attivatore) o prima e al momento della registrazione dell'origine. Utilizza le chiavi delle conversioni basate su cookie per associarle a report di debug dettagliati.
- Supponiamo che esistano 10 chiavi per le quali non esiste un report di debug dettagliato. Verifica se sono presenti problemi di integrazione. In caso contrario, ciò 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 notare che:- 10 (= 10% nel nostro esempio) report mancanti a causa di
pending destination limit
- 5 (= 5%) report mancanti a causa di
trigger-aggregate-no-contributions
. - 5 (= 5%) report mancanti a causa di
unknown-error
.
- 10 (= 10% nel nostro esempio) report mancanti a causa di
Passaggio 5: intervieni e risolvi i problemi
Ora che hai acquisito informazioni sul motivo per cui mancano i report, puoi intervenire sulla base di queste informazioni.
L'azione da intraprendere dipende dal valore 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 da parte tua. Utilizza questo numero come punto dati per la tua visibilità e il tuo monitoraggio.trigger-aggregate-no-contributions
potrebbe essere un segnale di un problema di implementazione da parte tua. Analizzi ulteriormente il problema. Utilizza i dettagli nel corpo del report dettagliato per risolvere il problema e, se necessario, risolvere il problema.unknown-error
potrebbe essere un segnale di un bug del browser o di un errore di rete. Se riscontri questo problema ripetutamente, segnala un bug per gli sviluppatori del browser.