Come integrarsi con OpenCart

Imparerai

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

Prima di iniziare 

La preghiamo di notare che Klaviyo non sincronizza il suo catalogo da OpenCart.

Aggiungere l'integrazione con OpenCart

Il processo di aggiunta dell'integrazione con OpenCart di Klaviyo è in più fasi e richiede l'esecuzione di azioni sia in OpenCart che in Klaviyo.

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

1. Decomprima il file nella root della sua installazione di OpenCart.
2. Acceda alla sezione amministrativa di OpenCart e vada alla pagina Estensioni > Moduli.
3. Installi il modulo Klaviyo e poi clicchi su Modifica per il modulo Klaviyo.
4. L'ultima cosa da fare con la sua installazione di OpenCart è copiare e incollare il seguente codice PHP alla fine di `upload/index.php`, proprio prima della linea `$response->getOutput();`:

   // [Klaviyo] Salva il carrello del cliente se esiste.
   if ($registry->get('carrello')->hasProducts()) {
     $registry->get('load')->model('module/klaviyo');
   
     se ($registry->get('customer')->isLogged()) {
       $registry->get('model_module_klaviyo')->saveCustomerCart(
         session_id(),
         $registry->get('customer')->getId(),
         $session->data['cart']
       );
     } altrimenti se (array_key_exists('guest', $session->data)) {
       $registry->get('model_module_klaviyo')->saveGuestCart(
         session_id(),
         $session->data['guest'],
         $session->data['cart']
       );
     }
   }

5. Acceda al suo account Klaviyo, quindi clicchi sul nome del suo account nell'angolo inferiore sinistro e selezioni Integrazioni.
6. Clicchi su Aggiungi integrazioni e cerchi OpenCart, quindi clicchi sulla scheda. Poi, faccia clic su Installa.
7. Verrà indirizzato alla pagina delle Impostazioni di integrazione . Nella pagina delle impostazioni, inserisca l'URL del suo sito OpenCart e clicchi su Connetti a OpenCart.
   
8. Nella pagina successiva, copi la chiave API sotto Klaviyo OpenCart Module e la incolli nelle impostazioni del modulo Klaviyo in OpenCart. Salvi le impostazioni del modulo Klaviyo nell'amministrazione di OpenCart.
   
9. Se lo desidera, selezioni l'impostazione Aggiungi nuovi clienti OpenCart a un elenco Klaviyo, quindi selezioni un elenco dal menu a tendina.
10. Tornando a Klaviyo, clicchi su Completa configurazione per iniziare la sincronizzazione dei dati.

Installare il monitoraggio in loco di Klaviyo

Per tracciare l'attività in loco in OpenCart, per prima cosa trovi la sua chiave API pubblica Klaviyo accedendo al suo account, cliccando sul nome del suo account nell'angolo in basso a sinistra e navigando su Impostazioni > Chiavi API. La sua chiave pubblica è lunga sei caratteri. Ci sono due tipi di tracciamento in loco che può installare:

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

Aggiungi "attivo sul sito" tracking

Questa metrica viene tracciata ogni volta che un browser identificabile visita il suo sito web. Per iniziare a tracciare l'attività di Active on Site:

1. Aggiunga il seguente frammento di codice al modello principale del suo negozio, in modo che sia incluso in tutte le pagine. Dovrebbe collocare questo snippet insieme ad altri script di analisi che utilizza o subito prima del tag di chiusura </body >:</body>
   

   <tipo di script="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
   <tipo di script="text/javascript"> 
   //Inizializza l'oggetto Klaviyo al caricamento della pagina
   !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]=argomenti[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){finestra._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))});return e}}})}catch(n){finestra.klaviyo=finestra.klaviyo||[],finestra.klaviyo.push=funzione(){var n;(n=finestra._klSito).push.apply(n,argomenti)}}}}(); </script>
   

2. Si assicuri di sostituire PUBLIC_API_KEY con la chiave API pubblica del suo account Klaviyo.
3. Se i visitatori o i clienti possono creare account per il suo negozio, aggiunga 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 }}',
       $nome_nome: '{{ user.first_name }}',
       $nome_ultimo: '{{ user.last_name }}'
       });
     {% endif %}
   </script>

4. A seconda dei tipi di template che utilizza per il suo sito web, le sintassi {% if user.is_logged_in %} e {{ user.email }} sono probabilmente diverse. Utilizzando la lingua del modello disponibile, desidera verificare se la persona che sta visualizzando la pagina corrente ha effettuato l'accesso. In caso affermativo, dovrebbe fornire la loro e-mail e il loro nome, se disponibili. Se non ha informazioni sul nome, rimuova queste due righe e la virgola dopo la riga $email.

Aggiungi "Prodotto visto" tracking

Se desidera impostare un flusso di abbandono della navigazione o costruire segmenti basati sui dati di navigazione dei prodotti, dovrà aggiungere il tracciamento degli eventi JavaScript per una metrica "Viewed Product".

1. Nel modello della pagina del prodotto, aggiunga il seguente snippet:

   <script type="text/javascript">
       var klaviyo = window.klaviyo || [];
       klaviyo.track("Visualizzato Prodotto", {
         Titolo: '{{ product.title }}',
         ItemId: {{ product.id }},
         Categorie: {{ category in product.categories|json }}, // L'elenco delle categorie è un array di stringhe. 
         ImageUrl: '{{ product.image_url }}',
         Url: '{{ product.url }}',
         Metadati: {
           Marchio: '{{ product.brand }}',
           Prezzo: {{ product.price }},
           ConfrontaPrezzo: {{ product.compare_at_price }} // Se ha un confronto con il prezzo. Potrebbe anche includerlo per una vendita o un prezzo speciale.
         }
     });
   </script>

2. Lo snippet qui sopra utilizza la sintassi del segnaposto {{ }}, che potrebbe essere diversa per il suo negozio OpenCart. La parte importante è che i campi del prodotto sono resi dinamicamente in base alla pagina del prodotto che sta visualizzando.
3. Dopo aver configurato il tracciamento dei prodotti visti per il suo sito, i dati dei prodotti visti dovrebbero iniziare a comparire nel suo account Klaviyo quando i visitatori noti sfogliano le pagine dei prodotti.

Come funziona il monitoraggio in loco

Quando aggiunge il web tracking di Klaviyo al suo sito, siamo in grado di tracciare solo l'attività di navigazione dei browser noti "" - cioè i browser che hanno visitato e si sono impegnati almeno una volta in precedenza. Ci sono due modi principali in cui siamo in grado di identificare un visitatore del sito ai fini del tracciamento web:

• Se qualcuno, a un certo punto, ha cliccato attraverso un'email di Klaviyo per raggiungere il suo sito web
• Se qualcuno, a un certo punto, si è iscritto/optato attraverso un modulo Klaviyo

Klaviyo non terrà traccia dei browser anonimi.

Monitorare la sincronizzazione di Klaviyo

Il tempo necessario per sincronizzare tutti i dati storici dei clienti e degli ordini del suo negozio OpenCart dipende dalle dimensioni del suo negozio. Una volta completata questa sincronizzazione storica, vedrà un bordo verde intorno alla sua integrazione OpenCart sotto la voce Integrazioni abilitate.

Per verificare la sua integrazione:

1. Si rechi alla scheda Metriche del suo account, che si trova sotto la voce Analisi. Qui può filtrare per visualizzare tutte le metriche di OpenCart. Trovi la metrica Ordine effettuatodi OpenCart e clicchi sull'icona Feed di attività. Se la sua integrazione ha iniziato a sincronizzare i dati, inizierà a vedere popolarsi gli eventi dell'Ordine Effettuato.
2. Sincronizzeremo automaticamente tutti i dati storici degli ordini. Per verificarlo, può confrontare il numero di eventi in un determinato giorno in Klaviyo con quello presente nella sua interfaccia OpenCart e confermare che corrispondono.
3. Per esempio, quando esplora la metrica Ordine effettuato, può passare il mouse sul punto dati di ieri o guardare la tabella dei dati sotto il grafico per vedere quanti ordini sono stati segnalati ieri.
4. Confronti questo numero con quello memorizzato in OpenCart da ieri e vedrà che corrispondono esattamente. Se non lo fanno, il problema è molto probabilmente che il fuso orario del suo account Klaviyo non corrisponde al fuso orario di OpenCart impostato.

5. Per controllare o aggiornare il fuso orario del tuo account:

   • Fai clic sul nome della tua organizzazione in basso a sinistra.

   • Seleziona Impostazioni.
   • Vada alla scheda Organizzazione . 

Dati sincronizzati da OpenCart

• Dati sulle vendite e sugli ordini
  Quali prodotti sono stati acquistati, compresi i dettagli dei prodotti e le immagini.
• Informazioni sul cliente
  Nome, cognome, località e gruppo di clienti.
• Dati di avvio del checkout
  Utilizzato per attivare le e-mail del Carrello Abbandonato. Questo è abilitato dallo snippet di codice PHP che ha aggiunto al momento dell'integrazione.
• Dati dell'ordine evaso
  Utilizzato per tracciare quando gli ordini vengono spediti.
• Tracciamento in loco
  Quando le persone visitano il suo sito web

Per le metriche di OpenCart, si rechi in Analytics > Metriche in Klaviyo, dove può filtrare per OpenCart.

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

• Ordine effettuato: In attesa, Elaborato, In lavorazione, Spedito, Completato
• Ordine evaso: Spedito, Completo

Risorse aggiuntive

• Con quale frequenza le integrazioni sincronizzano il riferimento
• Ha bisogno di ulteriore aiuto per l'integrazione con Klaviyo? Scopra le agenzie partner di Klaviyo