Strumenti di debug per le implementazioni di Analytics
Gli strumenti di debug, a volte denominati analizzatori di pacchetti o sniffer di pacchetti, consentono di controllare i dati inviati dall’implementazione ad Adobe. Possono aiutarti a confermare che le richieste di si attivano correttamente, esaminare le variabili e i payload inclusi in tali richieste e risolvere eventuali problemi relativi a comportamenti di implementazione imprevisti.
Scegliere uno strumento di debug
Le seguenti categorie possono essere utili per selezionare uno strumento in base a ciò che si desidera controllare.
Analytics e debugger dei tag
Analytics e i debugger di tag riconoscono le tecnologie di analisi e interpretano le loro richieste. Questi strumenti possono semplificare l’identificazione delle variabili di Adobe Analytics, dei payload di Experience Platform Web SDK, dei tag e delle informazioni di implementazione correlate, senza dover decodificare manualmente le richieste di rete.
Strumenti per sviluppatori di browser
Ogni browser moderno include strumenti per sviluppatori in grado di verificare le richieste di rete, pertanto spesso non è necessario uno strumento separato per eseguire il debug di un’implementazione web. Premere F12 o Ctrl+Maiusc+I (Windows e Linux) o Cmd+Opzione+I (macOS), quindi selezionare la scheda Rete. In Safari, abilita innanzitutto le funzionalità per sviluppatori nelle impostazioni Avanzate di Safari.
Proxy di debug HTTP(S)
I proxy di debug HTTP intercettano il traffico HTTP e HTTPS tra un client e un server. Sono utili quando gli strumenti di sviluppo del browser non forniscono una visibilità sufficiente o quando l’implementazione viene eseguita al di fuori di un browser web tradizionale.
L’ispezione HTTPS in genere richiede la configurazione del client per considerare attendibile un certificato fornito dal proxy di debug. Segui i criteri di sicurezza della tua organizzazione durante l’installazione dei certificati o l’intercettazione del traffico crittografato.
Individuare le richieste di Adobe Analytics
Per le implementazioni che inviano dati direttamente ad Adobe Analytics, come AppMeasurement, filtra le richieste di rete per:
/ss/
Le richieste di raccolta di Adobe Analytics contengono variabili di Analytics nell’URL della richiesta o nel payload. Le richieste non elaborate utilizzano nomi di parametri di query anziché nomi di variabili; ad esempio, eVar1 viene visualizzato come v1 e prop1 come c1. Questi nomi vengono decodificati automaticamente dai debugger di Analytics. Per decodificarli, consulta il riferimento alla variabile nella documentazione dell’API di inserimento dati.
Per i codici di stato HTTP restituiti dai server di raccolta dati di Analytics, vedi Codici di risposta HTTP nella documentazione dell’API di inserimento dati.
Per le implementazioni che utilizzano Adobe Experience Platform Web SDK, filtra le richieste di rete per:
/ee/
Seleziona la richiesta e analizzane il payload per visualizzare i dati inviati a Adobe Experience Platform Edge Network. Il Web SDK invia i dati ad Edge Network, che può quindi inoltrarli ad Adobe Analytics e ad altri servizi configurati. L’ispezione della richiesta del client verifica ciò che il browser ha inviato all’Edge Network; non conferma di per sé che i dati sono stati elaborati correttamente da ogni servizio a valle. Per vedere come Edge Network ha elaborato un evento, usa Adobe Experience Platform Assurance.
Richieste interrotte
Quando una pagina si sposta, il browser può annullare le richieste ancora in corso. Firefox etichetta queste richieste NS_BINDING_ABORTED; Chrome e Edge le etichetta (canceled). Per mantenere visibili le richieste dopo la navigazione, abilita Mantieni registro (Chrome e Edge) o Mantieni registri (Firefox).
Una richiesta annullata non significa necessariamente che i dati siano andati persi. Il browser potrebbe aver inviato la richiesta completa e interrotto l’attesa solo della risposta. Gli strumenti per sviluppatori di browser in genere non possono mostrare la differenza, ma un proxy di debug HTTP può.
Le richieste inviate con navigator.sendBeacon() non vengono annullate durante la navigazione. AppMeasurement utilizza sendBeacon per i collegamenti di uscita e ogni volta che useBeacon è abilitato. Il Web SDK lo utilizza per gli eventi inviati con documentUnloading. Se le richieste di tracciamento dei collegamenti vengono spesso annullate, utilizza queste opzioni.