Come integrare OpenCart

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. Decomprimi il file nella directory principale dell’installazione OpenCart.
2. Accedi alla sezione admin di OpenCart e vai alla pagina Estensioni > Moduli.
3. Installa il modulo Klaviyo e poi fai clic su Modifica per il modulo Klaviyo.
4. L’ultima cosa da fare con l’installazione di OpenCart è copiare e incollare il seguente codice PHP alla fine di `upload/index.php`, subito prima della riga `$response->getOutput();`:

// [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. Si aprirà una pagina Impostazioni integrazioni . Nella pagina delle impostazioni, inserisci l’URL del tuo sito OpenCart e fai clic su Connetti a OpenCart.
   

4. Nella pagina successiva, copia la chiave API in Klaviyo OpenCart Module e incollala nelle impostazioni del modulo Klaviyo in OpenCart. Salva le impostazioni del modulo Klaviyo nell'area di amministrazione di OpenCart.
   

5. Se vuoi, seleziona l'impostazione Aggiungi i nuovi clienti OpenCart a un elenco Klaviyo, quindi seleziona un elenco dal menu a discesa.
6. 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, individua innanzitutto la chiave API pubblica di Klaviyo accedendo al tuo account, cliccando sul nome del tuo account nell'angolo in basso a sinistra e seguendo questo percorso Impostazioni > Chiave API. La tua chiave pubblica è lunga sei caratteri. Esistono due 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:
   

<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 le persone che visitano il tuo sito o la tua clientela possono creare account per il tuo negozio, aggiungi il seguente snippet direttamente sotto il primo snippet:

<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. Utilizzando il linguaggio del modello disponibile, devi verificare se la persona che visualizza la pagina corrente ha effettuato l’accesso. Se sì, dovresti restituire il loro e-mail e nome, se disponibili. Se non hai informazioni sul nome, rimuovi quelle due righe e la virgola finale dopo la riga dell’e-mail $email.

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 il seguente snippet:

<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 la sintassi dei segnaposto {{ }}, che potrebbe essere diversa per il tuo negozio OpenCart. La parte importante è che i campi prodotto vengono visualizzati dinamicamente in base alla pagina prodotto che stai visualizzando.
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

Quando aggiungi il tracciamento web di Klaviyo al tuo sito, possiamo tracciare solo l’attività di navigazione dei "browser noti", ovvero browser che hanno visitato e coinvolto almeno una volta in precedenza. Esistono due modi principali per identificare un visitatore del sito ai fini del tracciamento web:

• 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

Klaviyo non terrà traccia dei browser anonimi.

Monitora la sincronizzazione di Klaviyo

Il tempo necessario per sincronizzare tutti i dati storici di clienti e ordini dal tuo negozio OpenCart dipende dalle dimensioni del tuo negozio. Una volta completata questa sincronizzazione storica, vedrai un bordo verde attorno alla tua integrazione OpenCart in Integrazioni abilitate.

Per verificare la tua integrazione:

1. Vai alla scheda Metrica del tuo account, che trovi in Analisi. Qui puoi applicare filtri per visualizzare tutte le metriche OpenCart. Trova la metrica Placed Order di OpenCart e fai clic sull'icona Feed attività. Se la tua integrazione ha iniziato a sincronizzare i dati, inizierai a vedere qui gli eventi Ordine effettuato.
2. Sincronizzeremo automaticamente tutti i dati storici degli ordini. Per verificarlo, puoi confrontare il numero di eventi in un determinato giorno in Klaviyo con quello presente nella tua interfaccia OpenCart e confermare che corrispondano.
3. Ad esempio, quando esplori la metrica Placed Order, puoi passare il mouse sul punto dati di ieri o guardare la tabella dei dati sotto il grafico per vedere quanti ordini sono stati registrati ieri.
4. Confronta quel numero con quello memorizzato in OpenCart a ieri e dovresti vedere che corrispondono esattamente. In caso contrario, il problema è molto probabilmente dovuto al fatto che il fuso orario del tuo account Klaviyo non corrisponde al fuso orario impostato in OpenCart.
5. Per controllare o aggiornare il fuso orario del tuo account:
   • Clicca sul nome della tua organizzazione in basso a sinistra.
   • Seleziona Impostazioni.
   • Vai alla scheda Organizzazione .

Dati sincronizzati da OpenCart

• Dati di vendita e degli ordini
  Quali prodotti sono stati acquistati, inclusi dettagli e immagini dei prodotti.
• Informazioni sul cliente
  Nome, cognome, località e gruppo di clienti.
• Dati di avvio del checkout
  Utilizzato per attivare e-mail sul carrello abbandonato. Questo è possibile grazie allo snippet di codice PHP che hai aggiunto durante l’integrazione.
• Dati sugli ordini evasi
  Utilizzati per monitorare quando gli ordini vengono spediti.
• Tracciamento onsite
  Quando le persone visitano il tuo sito web

Per le tue metriche OpenCart, vai a Analisi > Metriche in Klaviyo, dove puoi filtrare per OpenCart.

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