Risoluzione dei problemi dei moduli d'iscrizione

Se il tuo modulo è pubblicato su Klaviyo ma non viene visualizzato:

• Verifica che il tuo modulo sia attivo. Nella scheda Moduli d'iscrizione, dovresti vedere "Attivo" con una freccia verde sotto la colonna Stato per il tuo modulo.
  • Come indicato sopra, i moduli d'iscrizione di Klaviyo non verranno visualizzati su Internet Explorer.
• Verifica di aver seguito tutte le indicazioni per installare e abilitare lo snippet di codice onsite Klaviyo.js (chiamato anche tracciamento "Active on Site").
• Se utilizzi un modulo incorporato, verifica di aver installato nel codice del tuo sito il codice di incorporamento corretto, esattamente come appare nel modello di installazione.
• Esamina la sezione Targeting e comportamento nell'editor del modulo d'iscrizione:
  • In Targeting, assicurati che il modulo sia configurato per essere visualizzato sull’URL che stai visualizzando oppure che tu stia utilizzando un indirizzo e-mail univoco (come descritto nel suggerimento di test sopra).
  • In Tempistiche di visualizzazione, assicurati che le impostazioni delle tempistiche di visualizzazione non siano troppo restrittive. Se il modulo è impostato su Mostra in base alle regole, tutti i criteri devono essere soddisfatti affinché il modulo venga visualizzato. Ad esempio, se sono selezionati sia "Mostra quando il visitatore sta uscendo dalla pagina" sia "Mostra dopo aver fatto scorrere il 60% della pagina", un visitatore deve scorrere il 60% della pagina e mostrare l’intenzione di uscire affinché il modulo venga visualizzato.
• Esegui nuovamente il test in modalità incognito/di navigazione privata in una nuova finestra. Potresti aver già chiuso il pop-up, ed è per questo che non viene visualizzato di nuovo. Applichiamo i cookie ai browser per 1 anno, quindi quando qualcuno chiude un pop-up, non vedrà lo stesso pop-up di nuovo per un altro anno (a meno che non cancelli i cookie).
• Se utilizzi un modulo incorporato, conferma che il codice di incorporamento del modulo sia stato aggiunto esattamente come appare nel modale di installazione e che sia incollato correttamente nel codice del tuo sito.
• Verifica che solo 1 account Klaviyo sia integrato con il tuo sito. Se hai più account Klaviyo per 1 negozio, deseleziona l’opzione Aggiungi automaticamente JavaScript onsite di Klaviyo in tutti gli account tranne 1. Se hai installato manualmente il file .js di Klaviyo, assicurati di aver installato lo snippet solo da 1 account.
• Per i negozi Shopify: in base alle impostazioni sulla privacy del cliente in Shopify, Klaviyo potrebbe non tracciare gli eventi sul sito (e quindi non applicare alcuni tipi di targeting dei moduli) per i visitatori del tuo negozio Shopify nell'UE, nello SEE, nel Regno Unito e in Svizzera, a meno che non abbiano fornito il consenso.
• In generale, se un visitatore non ha fornito il suo consenso esplicito, ma sarebbe stato incluso in base ai requisiti di targeting, non vedrà il modulo perché non sarà identificato. Il targeting per questi visitatori sarà applicato in questo modo:
• • Se selezioni "Non mostrare ai profili Klaviyo già esistenti", il visitatore vedrà comunque il modulo perché non sarà identificato come profilo già esistente.
  • Se selezioni "Destina i visitatori a una lista o a un segmento", il visitatore non vedrà il modulo (anche se è presente nella lista o nel segmento) perché non sarà identificato. Se selezioni "Mostra a tutti i visitatori", il visitatore lo vedrà.
  • Se selezioni "Mostra ai profili esistenti", "Mostra solo agli iscritti alle e-mail" o "Mostra solo agli iscritti agli SMS", il visitatore non vedrà il modulo perché sarà identificato solo come profilo esistente, iscritto alle e-mail o iscritto agli SMS.
  • Alcuni trigger personalizzati basati sulle informazioni dei cookie e sulle proprietà dell'utente non si attivano a causa della mancanza di identificazione.
  • Il targeting per località non viene influenzato.
  • Il targeting per mostrare il tipo di dispositivo (desktop, mobile) non viene influenzato.

Se il tuo modulo non viene inviato quando fai clic sul pulsante Invia:

• Verifica che l'elenco a cui è collegato il modulo non sia stato eliminato.
• Verifica che il pulsante sia un pulsante Invia, non un pulsante Chiudi. Fai clic sul pulsante nell’anteprima dell’editor del modulo per vederlo.
• Controlla la posta in arrivo per un’e-mail di conferma. Se la tua lista è impostata su doppio opt-in, non verrai aggiunto finché non confermi l’iscrizione.

I moduli d'iscrizione di Klaviyo dovrebbero essere visualizzati sul tuo sito web così come sono stati progettati nell'editor dei moduli di Klaviyo. Se ha un aspetto diverso, significa che il CSS del sito sta sovrascrivendo lo stile del modulo. Per risolvere il problema:

• Cerca i tag !important nel tuo CSS e rimuovili, se possibile.
• Il tuo sviluppatore può anche usare gli strumenti di sviluppo del browser per ispezionare il codice del sito e identificare il CSS problematico. Se continui ad avere problemi, trovi assistenza qui.

Tieni presente che tutti i moduli di Klaviyo che raccolgono il consenso e-mail, il consenso SMS o che includono un coupon hanno protezioni ant-bot attive per impostazione predefinita. Se Klaviyo rileva un comportamento sospetto o una precedente attività di bot dall'indirizzo IP di un visitatore del sito, a quest'ultimo verrà richiesto di risolvere un CAPTCHA prima di inviare il modulo.

Se le persone compilano il modulo, ma non le vedi aggiunte all'elenco a cui è collegato il modulo:

• Fai clic sul pulsante nell’anteprima dell’editor dei moduli e assicurati di aver selezionato un elenco a cui inviare i dati.
• Controlla le impostazioni di opt-in della tua lista. Se la lista è impostata su doppio opt-in (consigliato), è probabile che gli iscritti mancanti non abbiano completato il passaggio di conferma.

Se il numero di invii del modulo non corrisponde al numero di persone nel tuo elenco:

• È possibile che gli iscritti non abbiano completato il passaggio di conferma (se la tua lista è impostata su doppio opt-in).
• Potrebbe anche indicare voci duplicate. Se un iscritto compila un modulo più volte, ogni voce verrà conteggiata come un “invio” nelle analisi del tuo modulo, ma comparirà nel tuo elenco solo 1 volta.
• È anche possibile che alcuni invii provengano da bot o list bomber. Klaviyo ha attivato protezioni contro il list bombing per proteggerti da questi attacchi informatici.

Potresti ricevere il messaggio di errore "Impossibile rilevare che i moduli d'iscrizione siano installati correttamente sul tuo sito. Consulta la documentazione di installazione." pur avendo aggiunto correttamente lo snippet di installazione al tuo sito web (o pur utilizzando un’integrazione predefinita che lo fa automaticamente). Questo può comparire se stai utilizzando una piattaforma di gestione dei tag (ad es. Google Tag Manager) o un altro metodo per distribuire lo snippet al tuo sito web quando la pagina viene caricata.

Questo messaggio non ti impedirà di pubblicare un modulo, quindi se lo snippet è installato correttamente sul sito web puoi tranquillamente ignorarlo. Se continui a riscontrare problemi, contattaci.

Tieni presente che JAWS, un programma di lettura dello schermo per computer Microsoft Windows, potrebbe non rilevare i moduli d'iscrizione sul tuo sito web creati in Klaviyo. Per garantire che chi visita il sito usando JAWS possa comunque interagire con i moduli d'iscrizione sul tuo sito web, ti consigliamo di aggiungere al sito uno snippet di codice aggiuntivo che lo renda più accessibile a JAWS.

Copia il seguente snippet di codice e incollalo nel file del tema principale del tuo sito in modo che JAWS rilevi e legga il tuo modulo d'iscrizione Klaviyo:

 {
  const ariaHiddenValue = $el ? $el.getAttribute('aria-hidden') : null;
  return ariaHiddenValue === 'true';
};

const isHTMLElement = (node) => {
  return node.nodeType === Node.ELEMENT_NODE;
};

const isModal = (node) => {
  if (node.children.length !== 1) return false;
  const modalContainer = Array.from(node.children[0].classList).some((cls) => cls.startsWith('kl-private-reset'));

  return modalContainer;
};

const getTopLevelDomElements = () => {
  const body = document.body;

  // Use the children property to get all top-level elements
  const topLevelNodes = Array.from(body.children).filter((node) => {
    if (isHTMLElement(node)) {
      const tagName = node.tagName.toLowerCase();

      console.log('isModal: ', isModal);

      // Filter out specific tags
      return (
        tagName !== 'script' &&
        tagName !== 'link' &&
        tagName !== 'iframe' &&
        tagName !== 'style' &&
        !isModal(node)
      );
    }
    return false;
  });

  return topLevelNodes;
};

const a11yHideTopLevelElements = () => {
  const $elements = getTopLevelDomElements();

  $elements.forEach(($el) => {
    if (!isAriaHiddenTrue($el)) {
      $el.setAttribute('kl-aria-hidden', 'true');
      $el.setAttribute('aria-hidden', 'true');
    }
  });
};

const a11yShowTopLevelElements = () => {
  const $elements = getTopLevelDomElements();

  $elements.forEach(($el) => {
    if ($el.hasAttribute('kl-aria-hidden')) {
      $el.removeAttribute('kl-aria-hidden');
      $el.removeAttribute('aria-hidden');