Test dei pixel personalizzati

Dopo aver creato un pixel personalizzato, devi testarlo per assicurarti che invii i dati correttamente quando si verificano eventi sul tuo sito.

Puoi utilizzare Shopify Pixel Helper per testare se gli eventi del pixel vengono caricati e se hai effettuato correttamente l'iscrizione agli eventi di Shopify. Shopify Pixel Helper ti consente di testare il pixel personalizzato sul tuo negozio online per visualizzare in tempo reale gli eventi ricevuti, insieme ai dati di tali eventi.

Se il tuo pixel personalizzato si integra con una piattaforma di terze parti che dispone di un proprio strumento di assistenza per pixel, puoi utilizzare lo strumento di assistenza per pixel di terze parti in aggiunta a Shopify Pixel Helper per verificare se gli eventi del pixel vengono elaborati e ricevuti dalla piattaforma di terze parti. Ad esempio, se aggiungi un pixel TikTok personalizzato al tuo negozio, puoi utilizzare sia Shopify Pixel Helper sia lo strumento di assistenza per pixel di TikTok per testare il pixel.

Puoi utilizzare Shopify Pixel Helper nella stessa sessione del browser di uno strumento di assistenza per pixel di terze parti per testare contemporaneamente gli eventi per entrambe le piattaforme.

Ecco uno script di pixel personalizzato che attiverà tutti gli eventi standard nella sandbox e registrerà i dati dell'evento nella console. Gli eventi standard saranno visibili in Shopify Pixel Helper. Inoltre, puoi iscriverti ad altre iscrizioni in blocco, all_events, all_custom_events e all_dom_events, per scoprire tutto ciò che i pixel web possono offrire. Visita la API dei pixel web per maggiori informazioni.

analytics.subscribe("all_standard_events", event => {
   console.log("Event data ", event?.data);
});

In questa pagina

Verifica della connessione di un pixel personalizzato

Prima di testare il pixel personalizzato, assicurati che sia collegato.

Procedura:

Dal pannello di controllo Shopify, vai a Impostazioni > Eventi cliente.
Accanto al pixel che desideri testare, verifica che per il pixel sia visualizzato lo stato Connesso nella colonna Stato.
Se il pixel non è connesso, clicca su ..., quindi clicca su Connetti.

Test di un pixel personalizzato con Shopify Pixel Helper

Dopo aver verificato che il pixel personalizzato è connesso, puoi utilizzare Shopify Pixel Helper per testare se sta inviando dati e ricevendo i dati del negozio. Puoi testare un pixel personalizzato alla volta.

Procedura:

Dal pannello di controllo Shopify, vai a Impostazioni > Eventi cliente.
Clicca sul pixel personalizzato che desideri testare.
Clicca su Test per aprire il pixel personalizzato sul tuo sito web per il test.
Facoltativo: a seconda delle impostazioni di consenso del negozio e delle impostazioni sulla privacy dei clienti del pixel personalizzato, la finestra di dialogo Assistente pixel potrebbe visualizzare il messaggio Pixel in attesa di consenso. Esegui una delle seguenti operazioni per continuare il test:
- Accetta il tracciamento nel banner dei cookie o nelle preferenze del negozio.
- Clicca su Dai il consenso per continuare il test.
- Se il pixel continua a non caricarsi, controlla le impostazioni sulla privacy dei clienti.
Per visualizzare quali eventi vengono caricati, visita ogni pagina per la quale desideri testare il pixel e controlla la finestra di dialogo Assistente pixel per assicurarti che l'iscrizione all'evento e la funzione di richiamata siano state completate correttamente nella sezione Eventi ricevuti:
- Vai a una nuova pagina per testare l'evento page_viewed.
- Clicca su un prodotto per testare l'evento product_viewed.
- Aggiungi un prodotto al carrello per testare l'evento product_added_to_cart.
- Vai al check-out per testare l'evento checkout_started.
- Inserisci le informazioni di spedizione al check-out per verificare che l'evento checkout_shipping_info_submitted sostituisca l'evento checkout_started.
- Completa il check-out per verificare che l'evento checkout_completed sostituisca l'evento checkout_shipping_info_submitted. Scopri di più su come effettuare un ordine di prova.
Per visualizzare i dati dell'evento ricevuti, clicca su per espandere la finestra di dialogo dell'assistente pixel.

Visualizzazione della sezione Eventi ricevuti

Quando testi quali eventi vengono caricati nel passaggio 5, viene visualizzato uno dei seguenti stati nella sezione Eventi ricevuti della finestra di dialogo Assistente pixel:

Un puntino verde indica che l'iscrizione all'evento è stata effettuata con successo e la funzione di richiamata è stata eseguita correttamente.
Un puntino rosso indica che l'iscrizione all'evento è stata effettuata con successo, ma la funzione di richiamata non è riuscita. Scopri come risolvere i problemi del pixel personalizzato.
L'assistente pixel mostra gli errori non intercettati che si verificano al livello superiore o nella funzione di richiamata. Gli errori di livello superiore vengono visualizzati al caricamento dell'assistente pixel. I messaggi di errore della richiamata vengono visualizzati quando clicchi per espandere un evento con un puntino rosso.
L’esempio di codice seguente contiene un errore di callback e un errore di primo livello. A seconda di dove si trova l’errore di primo livello, il pixel potrebbe funzionare parzialmente.

analytics.subscribe("all_standard_events", event => {
  console.log("Event data ", event?.data);
  throw new Error("callback error");
});

throw new Error("top level error")

Per maggiori informazioni su come risolvere gli errori JavaScript, visita la pagina Risoluzione dei problemi di JavaScript.

Risoluzione dei problemi del pixel personalizzato

Se il pixel non si carica o non si attiva durante il test e hai già controllato i dati dell’evento e il codice del pixel per verificare la presenza di errori, prova le seguenti misure per la risoluzione dei problemi.

Controlla le impostazioni sulla privacy dei clienti

Se il pixel non si carica o non si attiva durante il test, potrebbero esserci impostazioni sulla privacy dei clienti che ne impediscono il caricamento.

Dal pannello di controllo Shopify, vai su Impostazioni > Privacy dei clienti per verificare le impostazioni sulla privacy dei clienti nel pannello di controllo Shopify che potrebbero essere applicate alla sessione. A seconda delle impostazioni sulla privacy dei clienti, procedi come segue:

Se hai impostazioni sulla privacy dei clienti che richiedono il consenso nella tua area geografica, assicurati di aver fornito il consenso tramite il banner dei cookie.
Se non hai impostazioni sulla privacy dei clienti che bloccano il caricamento del pixel, svuota i cookie del browser per reimpostare il banner dei cookie e fornire il consenso.

Se utilizzi uno strumento di terze parti per gestire il consenso, contatta il fornitore di terze parti per ricevere assistenza.

Risoluzione dei problemi aggiuntiva

Se non è ancora chiaro se il pixel personalizzato è sottoscritto correttamente a un evento del cliente, prova le seguenti misure per la risoluzione dei problemi:

Svuota i cookie del browser.
Se stai testando un evento standard, consulta la documentazione per gli sviluppatori di Shopify sulle descrizioni degli eventi standard per assicurarti di eseguire i passaggi necessari per attivare l’evento.

Test con helper per pixel di terze parti

Un SDK (software development kit) per pixel contiene gli strumenti che consentono al pixel di raccogliere informazioni sul comportamento dei clienti. Puoi utilizzare l’helper per pixel del fornitore di pixel di terze parti per testare i seguenti comportamenti del pixel e assicurarti che l’SDK per pixel funzioni come previsto:

Verifica se un SDK di terze parti per pixel è caricato

I passaggi per controllare la scheda di rete dipendono dal browser web che utilizzi. Ad esempio, per scoprire come controllare la scheda di rete su Google Chrome, consulta la documentazione di Chrome for Developers Inspect network activity.

Per verificare che un SDK di terze parti per pixel sia caricato, devi prima recuperare il codice del fornitore di terze parti per l’URL dell’SDK, in modo da poterlo aggiungere al codice del pixel. Per ricevere assistenza, contatta il fornitore di pixel di terze parti.

Procedura:

Dal pannello di controllo Shopify, vai a Impostazioni > Eventi cliente.
Clicca sul pixel personalizzato che desideri testare.
Nella sezione Codice, inserisci alla fine del codice del pixel l’SDK fornito dal fornitore di terze parti.
Clicca su Salva.
Visita il negozio online, quindi controlla la scheda di rete per assicurarti che l’URL dell’SDK del fornitore di terze parti venga scaricato.
Facoltativo: se l’SDK di terze parti per pixel non si carica, controlla la presenza di errori di runtime JavaScript nella sandbox. Ad esempio, su Chrome puoi selezionare un iFrame specifico per esaminare i relativi log della console e quindi restringere i log al pixel specifico che stai testando. Per maggiori informazioni su come verificare la presenza di errori di runtime JavaScript su Chrome, consulta la documentazione di Chrome Debug JavaScript.

Se l’SDK di terze parti per pixel non si carica durante il test, contatta il fornitore di pixel di terze parti per ricevere assistenza.

Altri test dell’SDK di terze parti per pixel

Per verificare se un SDK di terze parti per pixel è inizializzato o raccoglie gli eventi, consulta la documentazione del fornitore di pixel di terze parti.

Per verificare se un SDK per pixel sta raccogliendo gli eventi, potrebbe esserti richiesto di controllare la scheda di rete del browser. I passaggi per controllare la scheda di rete dipendono dal browser web che utilizzi. Ad esempio, per scoprire come controllare la scheda di rete su Google Chrome, consulta la documentazione di Chrome for Developers Inspect network activity.