Questa pagina è stata tradotta dall'API Cloud Translation.

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 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 le intestazioni origine e trigger di Attribution Reporting. Tutti i report generati dal browser vengono inviati a questa origine. In queste istruzioni, utilizziamo https://adtech.example come origine del rapporto di esempio.
Un report sull'attribuzione (report in breve) è il report finale (a livello di evento o aggregabile) che contiene i dati di misurazione richiesti.
Un report di debug contiene dati aggiuntivi su un report sull'attribuzione o su un'origine o un evento attivatore. La ricezione di un report di debug non significa necessariamente che qualcosa non funzioni correttamente. 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 una volta che 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. I report di debug riusciti sono disponibili a partire da Chrome 101 (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 i 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 non è stato generato un evento di origine, un evento di trigger o un report sull'attribuzione. 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 origine sia sul lato attivatore. Le chiavi di debug consentono di mappare le conversioni basate sui cookie e le conversioni basate sull'attribuzione. Dopo aver configurato il sistema per generare report di debug e impostare le chiavi di debug, il browser includerà queste chiavi in tutti i report sull'attribuzione e in tutti i report di debug.

Per ulteriori 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

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.

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

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.

Nota: è possibile che tu abbia report sull'attribuzione a livello di evento che non sono mappati a una conversione basata sui cookie. Molto probabilmente questi sono report "sporchi" generati dall'API in modo casuale. Puoi verificarlo cercando i report dettagliati di debug di tipo source-noised che hanno la stessa chiave di debug sorgente del report a livello di evento.

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.

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.