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.

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

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 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.