Parte 1 di 3 sul debug di Attribution Reporting. Scopri perché il debug è importante e quando utilizzare i report di debug nei test.
Perché hai bisogno dei report di debug
Se stai testando l'API Attribution Reporting, devi verificare che l'integrazione funzioni correttamente, comprendere le lacune nei risultati di misurazione tra l'implementazione basata sui cookie e l'implementazione di Attribution Reporting e risolvere eventuali problemi relativi all'integrazione.
Per completare queste attività sono necessari report di debug. Pertanto, ti consigliamo vivamente di configurarle.
Glossario
Aspetti chiave dei report di debug
Due tipi di report di debug
Sono disponibili due tipi di report di debug. Utilizzali entrambi, in quanto soddisfano casi d'uso diversi.
Report di debug riusciti
I report di debug riusciti monitorano la generazione riuscita di un report sull'attribuzione. Sono correlati direttamente a un report sull'attribuzione.
I report di debug riusciti sono disponibili a partire da Chrome 101 (aprile 2022).
Report di debug dettagliati
I report di debug dettagliati offrono maggiore visibilità sugli eventi di origine e trigger, in modo da poter verificare che le origini siano state registrate correttamente o monitorare i report mancanti e determinare il motivo per cui non sono presenti (errore negli eventi di origine o trigger, errore durante l'invio o la generazione del report). I report di debug dettagliati indicano:
- Casi in cui il browser ha registrato correttamente un'origine.
- Casi in cui il browser non ha registrato correttamente un evento di origine o trigger, il che significa che non genererà un report sull'attribuzione.
- 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 la registrazione riuscita di un'origine o il motivo per cui non è stato generato un report sull'attribuzione, su un trigger o su un'origine.
I report di debug dettagliati sono disponibili da Chrome 109 (gennaio 2023), ad eccezione dei report di debug dettagliati sulla registrazione riuscita delle origini, che sono stati aggiunti successivamente in Chrome 112.
Esamina i report di esempio nella Parte 2: configura i report di debug.
I report di debug si basano sui cookie
Per utilizzare i report di debug, l'origine dei report deve impostare un cookie.
Se l'origine configurata per ricevere i report è una terza parte, questo cookie sarà un cookie di terze parti. Ciò significa che i report di debug vengono generati solo se i cookie di terze parti sono consentiti nel browser dell'utente.
I report di debug vengono inviati immediatamente
I report di debug vengono inviati immediatamente dal browser all'origine dei report. A differenza dei report sull'attribuzione, che vengono inviati con un ritardo.
I report di debug riusciti vengono generati e inviati non appena viene generato il report sull'attribuzione corrispondente, ovvero al momento della registrazione del trigger.
I report di debug dettagliati vengono inviati immediatamente al momento della registrazione dell'origine o del trigger.
I report di debug hanno percorsi degli endpoint diversi
Come i report sull'attribuzione, tutti i report di debug vengono inviati all'origine dei report. I report di debug vengono inviati a tre endpoint separati dell'origine dei report:
- Endpoint per i report di debug riusciti a livello di evento
- Endpoint per i report di debug riusciti, aggregabili
- Endpoint per i report di debug dettagliati, a livello di evento e aggregabili.
Scopri di più nella Parte 2: configura i report di debug.
Casi d'uso
Controllo di integrazione di base in tempo reale
I report di debug vengono inviati immediatamente all'endpoint, a differenza dei report sull'attribuzione che vengono inviati in ritardo per proteggere la privacy degli utenti. Utilizza i report di debug come indicatore in tempo reale che l'integrazione con l'API Attribution Reporting funziona.
Scopri come farlo nella Parte 3: Ricette di debug.
Analisi delle perdite
A differenza dei cookie di terze parti, l'API Attribution Reporting include protezioni della privacy integrate, progettate per trovare un equilibrio tra utilità e privacy. Ciò significa che con l'API Attribution Reporting potresti non essere in grado di raccogliere tutti i dati di misurazione che potresti raccogliere con i cookie. Non tutte le conversioni che puoi monitorare con i cookie di terze parti genereranno un report sull'attribuzione.
Un esempio: per i report a livello di evento, puoi registrare al massimo una conversione per impressione. Ciò significa che per una determinata impressione dell'annuncio riceverai un solo report sull'attribuzione, indipendentemente dal numero di conversioni dell'utente.
Utilizza i report di debug per ottenere visibilità sulle differenze tra i risultati della misurazione basata sui cookie e quelli ottenuti con l'API Attribution Reporting. Individua le conversioni registrate, il numero di conversioni non registrate e, in particolare, quali e perché.
Scopri come eseguire un'analisi delle perdite nella Parte 3: Ricettario per il debug.
Risoluzione dei problemi
Sebbene la perdita causata dalla privacy o dalle protezioni delle risorse sia prevista, altre perdite potrebbero essere involontarie. Configurazioni errate nell'implementazione o bug nel browser stesso possono causare la scomparsa dei report.
Puoi utilizzare i report di debug per rilevare e correggere un problema di implementazione da parte tua o per segnalare un potenziale bug ai team dei browser. Scopri come farlo nella Parte 3: Ricettario per il debug.
Controllo della configurazione avanzata
Alcune funzionalità dell'API Attribution Reporting consentono di personalizzare i comportamenti dell'API. Le regole di filtraggio, le regole di deduplicazione e le regole di priorità sono alcuni esempi.
Quando utilizzi queste funzionalità, utilizza i report di debug per verificare che la logica porti al comportamento previsto in produzione, senza attendere i report sull'attribuzione. Scopri come farlo nella Parte 3: Ricette di debug.
Test locale con report aggregabili
A differenza dei report sull'attribuzione aggregabili criptati, i report di debug aggregabili includono il payload non criptato.
Utilizza i report di debug aggregabili per convalidare i contenuti dei report aggregabili e per generare report di riepilogo con lo strumento di aggregazione locale per i test.
Rielaborare i report del servizio di aggregazione
Un altro vantaggio dell'utilizzo della modalità di debug è che consente di elaborare nuovamente i report. Pertanto, per elaborare i report più di una volta, assicurati che i report di debug siano abilitati. Potresti voler rielaborare i report quando:
- tentativo di eseguire il debug del servizio di aggregazione.
- sperimentare diverse strategie di raggruppamento.
- sperimentando diversi valori di epsilon.
Recupero dati
Consigliamo alle tecnologie pubblicitarie di attivare la modalità di debug per ricevere report di debug e recuperare i dati dei report. Ciò è utile in caso di problemi con il servizio di aggregazione, ad esempio servizi non disponibili o che non rispondono, che potrebbero causare l'errore di generazione del report di riepilogo.
A seguire
Parte 2: configurare i report di debug