Parte 1 di 3 sul debug dei report Attribution Reporting. Scopri perché il debug è importante e quando utilizzare i report di debug durante i test.
Perché hai bisogno di 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 i report di debug. Pertanto, ti consigliamo vivamente di configurarli.
Glossario
Aspetti chiave dei report di debug
Due tipi di report di debug
Sono disponibili due tipi di report di debug. Utilizza entrambi, poiché soddisfano casi d'uso diversi.
Report di debug riusciti
I report di debug relativi al successo monitorano la generazione riuscita di un report sull'attribuzione. Si riferiscono direttamente a un report sull'attribuzione.
I report di debug relativi al completamento sono disponibili da Chrome 101 (aprile 2022).
Report di debug dettagliati
I report di debug dettagliati ti offrono una maggiore visibilità sulle origini e sugli eventi di attivazione, in modo da poter verificare che le origini siano state registrate correttamente o monitorare i report mancanti e determinare il motivo della loro assenza (errore negli eventi di origine o di attivazione, 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 attivazione o di origine, il che significa che non verrà generato 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 di una sorgente riuscita o il motivo per cui non è stato generato un report sulle sorgenti, sugli attivatori o sull'attribuzione.
I report di debug dettagliati sono disponibili da Chrome 109 (gennaio 2023), ad eccezione dei report di debug dettagliati relativi alla registrazione dell'origine andata a buon fine che sono stati aggiunti in un secondo momento in Chrome 112.
Esamina i report di esempio nella Parte 2: configurare i report di debug.
I report di debug si basano sui cookie
Per utilizzare i report di debug, l'origine report deve impostare un cookie.
Se l'origine configurata per ricevere i report è di terze parti, 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 report. diversamente dai report sull'attribuzione, che vengono inviati con un ritardo.
I report di debug di successo vengono generati e inviati non appena viene generato il report sull'attribuzione corrispondente, ovvero al momento della registrazione dell'attivatore.
I report di debug dettagliati vengono inviati immediatamente al momento della registrazione della fonte o dell'attivatore.
I report di debug hanno percorsi di endpoint diversi
Come i report sull'attribuzione, tutti i report di debug vengono inviati all'origine report. I report di debug vengono inviati a tre endpoint distinti dell'origine report:
- Endpoint per i report di debug success a livello di evento
- Endpoint per i report di debug positivi, aggregabili
- Endpoint per i report di debug dettagliati, aggregabili e a livello di evento.
Scopri di più nella Parte 2: configurare i report di debug.
Casi d'uso
Controllo di base dell'integrazione 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 dell'efficacia dell'integrazione con l'API Attribution Reporting.
Scopri come farlo nella Parte 3: Suggerimenti per il 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 generano 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 informazioni 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: Suggerimenti per il debug.
Risoluzione dei problemi
Sebbene la perdita causata da protezioni della privacy o delle risorse sia prevista, altre perdite potrebbero essere indesiderate. 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 lato tuo o per segnalare un potenziale bug ai team dei browser. Scopri come farlo nella Parte 3: Suggerimenti per il debug.
Controllo della configurazione avanzata
Alcune funzionalità dell'API Attribution Reporting ti consentono di personalizzare il suo comportamento. Regole di filtro, regole di deduplica e regole di priorità sono alcuni esempi.
Quando utilizzi queste funzionalità, utilizza i report di debug per verificare che la logica generi il comportamento previsto in produzione, senza attendere i report sull'attribuzione. Scopri come farlo nella Parte 3: Suggerimenti per il debug.
Test locali con report aggregabili
A differenza dei report sull'attribuzione aggregabili che sono 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.
Riproduci i report del Servizio di aggregazione
Un altro vantaggio dell'utilizzo della modalità di debug è che ti consente di elaborare di nuovo i report. Pertanto, per elaborare i report più di una volta, assicurati di aver attivato i report di debug. Potresti voler rielaborare i report quando:
- Tentativo di eseguire il debug del servizio di aggregazione.
- sperimentare con diverse strategie di raggruppamento.
- Sperimenta con diversi valori di epsilon.
Recupero dati
Consigliamo agli esperti di tecnologia pubblicitaria di attivare la modalità di debug per ricevere report di debug in modo da poter recuperare i dati dei report. Questo è utile in caso di problemi con il servizio di aggregazione, ad esempio servizi non disponibili o non responsivi che potrebbero causare l'errore di generazione del report di riepilogo.