Risoluzione dei problemi relativi a integrazioni, eventi e widget sul sito di terze parti in Klaviyo

Problemi comuni con strumenti di terze parti

Quando utilizzi app di terze parti con Klaviyo (come plugin di e-commerce, strumenti di revisione o widget di pagine), potresti riscontrare problemi come:

• Integrazioni di segnalazione dei problemi di connessione
• Eventi o proprietà previsti che non appaiono in Klaviyo
• Le variabili dinamiche (ad esempio, {{ review_url }} o i tag coupon) appaiono vuote
• widget sul sito o moduli che non si caricano regolarmente sulle tue pagine

Questa guida illustra i controlli di base che puoi eseguire prima di contattare l'assistenza.

Verifica lo stato dell'integrazione e la connettività

1. Controlla l'integrazione in Klaviyo:

• Vai alle Integrazioni e verifica che l'integrazione pertinente (ad esempio, WooCommerce o la tua app di revisione) sia abilitata.
• Se hai ricevuto un'e-mail su un problema di connessione, segui le istruzioni incluse (ad esempio, autorizzando nuovamente l'integrazione).

2. Esegui un'azione di prova dal tuo sito o dalla tua app:

• Effettua un ordine di prova, invia una recensione o completa un'azione di prova per inviare i dati a Klaviyo.

3. In Klaviyo, controlla:

• Dati analitici > Metriche per i nuovi eventi correlati a quello strumento.
• Un profilo interessato per una nuova attività da quell'integrazione.

Se le azioni recenti non appaiono affatto in Klaviyo, potrebbe esserci un problema di connessione o configurazione nell'app di terze parti che impedisce l'invio di dati.

Diagnosticare gli eventi mancanti o le variabili vuote

A volte l'integrazione è connessa, ma alcuni dati (ad esempio l'URL di una recensione o il codice coupon) sono mancanti o vuoti.

1. Identifica l'evento utilizzato dal tuo flusso o dalla tua e-mail:

• Apri il flusso e annota l'evento trigger (ad esempio, un evento di ordine evaso o un evento di recensione personalizzato).

2. Vai su Dati analitici > Metriche, seleziona la metrica e apri un evento recente.
3. Nei dettagli dell'evento:

• Verifica che la proprietà che ti aspetti (ad esempio, review_url o un valore di codice coupon) sia presente e che abbia un valore.

4. Se la proprietà è mancante o vuota nel payload dell'evento:

• L'app di terze parti non invia quei dati a Klaviyo per questo evento.
• Controlla le impostazioni di integrazione dell'applicazione per assicurarti che il campo sia abilitato oppure contatta l'assistenza dell'applicazione.

5. Se la proprietà esiste con un valore ma appare vuota nella tua e-mail:

• Verifica che la variabile dinamica nel tuo modello corrisponda esattamente al nome della proprietà (ad esempio, {{ review_url }} se la proprietà si chiama review_url).
• Verifica che l'e-mail venga attivata dallo stesso evento che contiene la proprietà; l'utilizzo di un evento diverso potrebbe non fornire le variabili previste.

Per i problemi relativi ai coupon nei flussi, verifica anche:

• che l'elemento del codice coupon o il tag siano configurati correttamente per la tua piattaforma di negozio online.
• L'integrazione sottostante (come WooCommerce o Shopify) ha coupon attivi e validi associati al flusso.

Risolvi i problemi dei widget sul sito che non appaiono

Se i widget di uno strumento di terze parti appaiono solo a volte o non appaiono affatto sulle tue pagine:

1. Verificare che il widget o il plugin sia installato correttamente in base alle istruzioni del provider.
2. Assicurati che gli script pertinenti (ad esempio, lo script del widget di recensioni e lo script onsite di Klaviyo) vengano caricati sulle pagine interessate.
3. Verifica la presenza di problemi comuni come:

• Cache del generatore di pagine o temi che impedisce il caricamento di nuovi script o sezioni.
• JavaScript in conflitto da altre app.
• Contenitori HTML mancanti o errati (ad esempio, un div o un ID mancante in cui il widget prevede di eseguire il rendering).

4. Testa in una finestra del browser privata/in incognito e, se possibile, in un tema diverso o in una pagina minima per escludere i conflitti.

Se lo script di widget non viene mai caricato o se viene caricato ma non viene visualizzato il contenuto, condividi i registri e gli screenshot della console del browser con il team di assistenza del provider di widget.

Quando contattare il provider di app o l'assistenza di Klaviyo

In generale:

• Contatta il provider dell'app quando:
• I dati sono mancanti o vuoti nel payload dell'evento inviato a Klaviyo.
• Un widget o un plugin non appaiono sul tuo sito web come previsto.
• Devi inviare ulteriori eventi o proprietà a Klaviyo.
• Contatta l'assistenza Klaviyo quando:
• Gli eventi e le proprietà sono presenti in Klaviyo, ma non puoi utilizzarli nei segmenti, nei flussi o nei modelli come previsto.
• Puoi notare errori o comportamenti inaspettati all'interno dell'app Klaviyo stessa.

Prima di contattarti, raccogli:

• Screenshot delle tue impostazioni di integrazione.
• Esempi di eventi recenti da Dati analitici > Metriche.
• Screenshot o link che mostrano il problema (ad esempio, variabili vuote in un'e-mail di prova o un widget mancante da una pagina di prodotto specifica).

Fornire questi dettagli aiuterà il provider della tua app e l'assistenza di Klaviyo a identificare rapidamente se il problema riguarda i dati inviati a Klaviyo o il modo in cui vengono utilizzati una volta arrivati.