Cosa imparerai

Scopri come integrare OpenCart con Klaviyo. Dopo aver completato questi passaggi, potrai personalizzare e targetizzare le e-mail in base agli acquisti e all'attività sul sito web di ciascun cliente. L'integrazione OpenCart si sincronizza ogni ora.

Prima di iniziare

Nota: Klaviyo non sincronizza il tuo catalogo da OpenCart.

Aggiungi l'integrazione OpenCart

Il processo di aggiunta dell'integrazione OpenCart di Klaviyo prevede più passaggi e richiede di eseguire azioni sia in OpenCart sia in Klaviyo.

Per iniziare, al momento Klaviyo supporta OpenCart 1.4.x e 1.5.x. Scarica il modulo OpenCart di Klaviyo da qui: https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

  1. Estrai l'archivio nella root dell'installazione di OpenCart.
  2. Accedi alla sezione admin di OpenCart e vai alla pagina Estensioni > Moduli.
  3. Installa il modulo Klaviyo, quindi fai clic su Modifica per il modulo Klaviyo.
  4. Copia e incolla il seguente codice PHP alla fine di upload/index.php, subito prima della riga $response->getOutput();:
text
// [Klaviyo] Save customer cart if it exists.
if ($registry->get('cart')->hasProducts()) {
  $registry->get('load')->model('module/klaviyo');

  if ($registry->get('customer')->isLogged()) {
    $registry->get('model_module_klaviyo')->saveCustomerCart(
      session_id(),
      $registry->get('customer')->getId(),
      $session->data['cart']
    );
  } else if (array_key_exists('guest', $session->data)) {
    $registry->get('model_module_klaviyo')->saveGuestCart(
      session_id(),
      $session->data['guest'],
      $session->data['cart']
    );
  }
}
  1. In Klaviyo, seleziona la scheda Integrazioni.
  2. Clicca su Scopri le app e cerca OpenCart, quindi clicca sulla scheda. Dopodiché, clicca su Installa.
  3. Inserisci l’URL del tuo sito OpenCart in URL negozio, quindi fai clic su Connetti a OpenCart.
  1. Nella pagina successiva, copia la chiave API sotto Klaviyo OpenCart module e incollala nelle impostazioni del modulo Klaviyo in OpenCart. Salva le impostazioni del modulo Klaviyo nell’area di amministrazione di OpenCart. Conserva una copia di questa chiave in modo sicuro prima di completare la configurazione; Klaviyo non la mostrerà più in seguito.
  1. In Klaviyo, seleziona Aggiungi nuovi clienti OpenCart a un elenco Klaviyo e scegli un elenco se vuoi aggiungere i clienti che hanno dato il consenso alla newsletter OpenCart quando i dati dell’ordine vengono sincronizzati. Questa impostazione non li iscrive ai messaggi di marketing in Klaviyo. Se non vuoi aggiungere i clienti a un elenco, deseleziona la casella di controllo.
  2. Torna in Klaviyo e fai clic su Completa la configurazione per iniziare a sincronizzare i dati.

Installa il tracciamento sul sito Klaviyo

Per monitorare l'attività sul sito in OpenCart, per prima cosa trova la tua chiave API pubblica di Klaviyo facendo clic sul nome del tuo account nell'angolo in basso a sinistra e andando su Impostazioni > chiavi API. Copia la chiave in Chiave API pubblica / ID sito. La tua chiave pubblica è lunga 6 caratteri ed è diversa dalla chiave del modulo OpenCart usata sopra. Esistono 2 tipi di tracciamento sul sito che puoi installare:

  • Attivo sul sito
    Questa metrica viene tracciata ogni volta che un browser identificabile visita il tuo sito web
  • Prodotto visualizzato
    Questa metrica viene rilevata ogni volta che un browser identificabile visualizza una pagina prodotto sul tuo sito web

Aggiungi il tracciamento "Attivo sul sito"

Questa metrica viene rilevata ogni volta che un browser identificabile visita il tuo sito web. Per iniziare il tracciamento dell'attività Attivo sul sito:

  1. Aggiungi il seguente frammento di codice al modello principale del tuo negozio, in modo che sia incluso in tutte le pagine. Dovresti inserire questo frammento insieme agli altri script di analisi che usi oppure subito prima del tag </body> di chiusura:
text
<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js"></script>
<script type="text/javascript"> 
//Initialize Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>
  1. Assicurati di sostituire PUBLIC_API_KEY con la chiave API pubblica del tuo account Klaviyo.
  2. Se i visitatori o i clienti possono creare account per il tuo negozio, adatta l’esempio seguente al linguaggio del modello OpenCart, quindi aggiungilo direttamente sotto il primo snippet. Sostituisci i campi cliente di esempio con i dati del cliente con accesso effettuato del tuo negozio prima della pubblicazione:
text
<script type="text/javascript">
  var klaviyo = window.klaviyo || [];
  {% if user.is_logged_in %}
  klaviyo.identify({
    $email: '{{ user.email }}',
    $first_name: '{{ user.first_name }}',
    $last_name: '{{ user.last_name }}'
    });
  {% endif %}
</script>
  1. A seconda dei tipi di modelli che usi per il tuo sito web, la sintassi {% if user.is_logged_in %} e {{ user.email }} probabilmente è diversa. Usando il linguaggio del modello disponibile, devi verificare se la persona che visualizza la pagina corrente ha effettuato l’accesso. In tal caso, dovresti mostrare il suo indirizzo e-mail e il suo nome, se disponibili. Se non hai informazioni sul nome, rimuovi queste due righe e la virgola finale dopo la riga dell’e-mail $email. Esegui l’escape dei valori di e-mail e nome per JavaScript, in modo che le virgolette non compromettano lo snippet.

Aggiungere il tracciamento "Prodotto visualizzato"

Se desideri impostare un flusso di abbandono della navigazione o creare segmenti basati sui dati di navigazione dei prodotti, dovrai aggiungere il tracciamento degli eventi JavaScript per la metrica "Prodotto visualizzato".

  1. Nel modello della pagina prodotto, aggiungi l’esempio seguente dopo lo snippet principale di tracciamento onsite e il relativo codice di inizializzazione. Adatta i segnaposto al linguaggio del tuo modello OpenCart prima di pubblicare:
text
<script type="text/javascript">
    var klaviyo = window.klaviyo || [];
    klaviyo.track("Viewed Product", {
      Title: '{{ product.title }}',
      ItemId: {{ product.id }},
      Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings. 
      ImageUrl: '{{ product.image_url }}',
      Url: '{{ product.url }}',
      Metadata: {
        Brand: '{{ product.brand }}',
        Price: {{ product.price }},
        CompareAtPrice: {{ product.compare_at_price }} // If you have a compare at price. You could also include this for a sale or special price.
      }
  });
</script>
  1. Lo snippet sopra utilizza placeholder {{ }} di esempio. Sostituiscili con valori renderizzati dinamicamente per il prodotto visualizzato, utilizzando il linguaggio del modello OpenCart. Esegui il rendering delle categorie come un array di stringhe e dei prezzi come numeri, ed esegui l’escape dei valori di testo per JavaScript in modo che i nomi che contengono virgolette non interrompano lo snippet. Rimuovi il campo del prezzo di confronto se il tuo negozio non lo utilizza.
  2. Dopo che il tracciamento Viewed Product è stato configurato per il tuo sito, i dati Viewed Product dovrebbero iniziare a popolarsi nel tuo account Klaviyo mentre i visitatori conosciuti navigano tra le tue pagine prodotto.

Come funziona il tracciamento sul sito

Klaviyo associa l’attività sul sito a un profilo una volta identificato il browser del visitatore. Non è necessaria una visita precedente. Il tuo negozio può identificare un visitatore nei seguenti modi:

  • Nel caso in cui qualcuno a un certo punto abbia fatto clic su un'e-mail Klaviyo che porta al tuo sito web
  • Nel caso in cui qualcuno a un certo punto abbia effettuato l’iscrizione tramite un modulo di Klaviyo
  • Se qualcuno accede al tuo negozio e lo snippet di identificazione sopra invia le sue informazioni cliente a Klaviyo

Se Compilazione anonima è abilitata, Klaviyo può archiviare l’attività sul sito nel browser del visitatore prima che venga identificato e aggiungerla al suo profilo in un secondo momento. Scopri di più sul recupero delle informazioni sull'attività dei visitatori anonimi.

Monitora la sincronizzazione di Klaviyo

Il tempo necessario per sincronizzare i dati storici di clienti e ordini dal tuo negozio OpenCart dipende dalle dimensioni del tuo negozio. Per controllare l’avanzamento, apri integrazioni e seleziona OpenCart, quindi apri la scheda Dati. La sezione storico dei dati mostra l’avanzamento della sincronizzazione e conferma quando la sincronizzazione storica è completata.

Per verificare la tua integrazione:

  1. Vai a Analytics > Metriche e filtra per OpenCart. Apri Ordine effettuato e seleziona la scheda Feed di attività. Se la tua integrazione ha iniziato a sincronizzare i dati, inizierai a vedere qui gli eventi Ordine effettuato popolarsi.
  2. Klaviyo importa automaticamente gli ordini storici con indirizzi e-mail cliente validi e gli stati dell'ordine elencati di seguito. Dopo il completamento della sincronizzazione storica, confronta il numero di eventi Ordine effettuato in un determinato giorno con gli ordini corrispondenti in OpenCart.
  3. Ad esempio, apri la scheda Grafico per Ordine effettuato, scegli Giornaliero e Totale e seleziona un intervallo di date che includa ieri. Passa il mouse sul punto dati di ieri oppure guarda la tabella sotto il grafico per vedere quanti ordini sono stati riportati.
  4. Confronta questo conteggio con gli ordini OpenCart dello stesso giorno che soddisfano i requisiti di e-mail e di stato indicati sopra. Se i conteggi differiscono, verifica che la sincronizzazione sia terminata e che entrambe le viste utilizzino lo stesso fuso orario.
  5. Per controllare o aggiornare il fuso orario del tuo account:
    • Clicca sul nome del tuo account in basso a sinistra.
    • Seleziona Impostazioni.
    • Vai alla scheda Account e trova Fuso orario.
    • Se necessario, seleziona il fuso orario corretto e fai clic su Salva.

Dati sincronizzati da OpenCart

  • Dati di vendita e degli ordini
    Quali prodotti sono stati acquistati, inclusi dettagli e immagini dei prodotti.
  • Informazioni sul cliente
    Indirizzo e-mail, nome, cognome, numero di telefono, gruppo di clienti, negozio OpenCart e informazioni di adesione alla newsletter.
  • Dati di checkout avviato
    Utilizzati per attivare e-mail di carrello abbandonato. Questo richiede lo snippet di codice PHP che hai aggiunto durante l’integrazione e un carrello associato a un cliente che ha effettuato l’accesso o ai dettagli del checkout come ospite, che includono un indirizzo e-mail valido.
  • Dati sugli ordini evasi
    Utilizzati per monitorare quando gli ordini vengono spediti.
  • Tracciamento onsite
    Le attività Active on Site e Viewed Product vengono raccolte dagli snippet JavaScript che installi separatamente. Questi eventi sono separati dalla sincronizzazione degli ordini e del checkout di OpenCart.

Per visualizzare le metriche di OpenCart, vai su Analisi > Metriche in Klaviyo, dove puoi filtrare per OpenCart.

Metrics tab in Klaviyo filtered by OpenCart with Fulfilled Order, Ordered Product, Placed Order, and Started Checkout in list
Metrics tab in Klaviyo filtered by OpenCart with Fulfilled Order, Ordered Product, Placed Order, and Started Checkout in list

Per impostazione predefinita, Klaviyo sincronizza i seguenti stati per le metriche Ordine effettuato e Ordine evaso:

  • Ordine effettuato: In sospeso, Elaborato, In elaborazione, Spedito, Completato
  • Ordine evaso: Spedito, Completato

Risorse aggiuntive

Questo articolo è stato utile?
Usa questo modulo solo per il feedback sull'articolo. Scopri come contattare l'assistenza.

Esplora altri contenuti di Klaviyo

Community
Entra in contatto con altre aziende simili, partner ed esperti di Klaviyo per trovare ispirazione, condividere approfondimenti e ottenere risposte a tutte le tue domande.
Partner
Assumi un esperto certificato Klaviyo per aiutarti con un compito specifico o per la gestione continua del marketing.
Assistenza

Accedi all'assistenza tramite il tuo account.

Assistenza via e-mail (prova gratuita e account a pagamento) Disponibile 24 ore su 24, 7 giorni su 7

Chat/assistente virtuale
La disponibilità può variare in base alla località e al tipo di piano