Iniziare con Magento 1.x (CE ed EE)

Imparerai

Scopra come integrarsi con Magento 1. Klaviyo si integra sia con Magento 1 CE che con Magento 1 EE. Attualmente supportiamo le versioni di Magento 1.5 e successive.

Ci sono due fasi principali per integrare Magento 1 con Klaviyo:

1. Abilitazione dell'integrazione di Magento in Klaviyo.
2. Installazione dell'estensione Klaviyo in Magento.

Questa guida copre entrambi i passaggi e le attività correlate per i negozi Magento 1.

Impostare le credenziali API di Magento

L'integrazione di Magento 1.x con Klaviyo richiede la creazione di un nuovo ruolo con accesso completo alle risorse e l'assegnazione di un nuovo utente a questo ruolo. Il nome utente e la password di questo utente serviranno come credenziali API.

Nel pannello di amministrazione di Magento, faccia clic sulla scheda Sistema e selezioni Servizi Web > SOAP/XML-RPC-Roles.

Selezioni Aggiungi nuovo ruolo .Quindi clicchi sulla scheda Risorse del ruolo e imposti l'accesso alle risorse su Tutti.

Selezioni la scheda Info ruolo, dia un nome al ruolo "Klaviyo," e faccia clic su Salva ruolo.

Clicchi sulla scheda Sistema e selezioni Servizi Web > SOAP/XML-RPC-Users.

Selezioni Aggiungi nuovo utente.

Clicchi sulla scheda Ruolo utente e imposti il Ruolo su Klaviyo.

Clicchi sulla scheda Informazioni utente. Imposti il nome utente a "klaviyo" e inserisca una chiave API forte. Può digitare qualsiasi valore alfanumerico. Salvi il nome utente e la chiave API, perché li utilizzerà quando abiliterà l'integrazione di Magento 1 in Klaviyo. Compili il resto delle informazioni e clicchi su Salva utente.

Prestazioni API

Per migliorare le prestazioni della sua integrazione, consigliamo vivamente di attivare la cache per le due impostazioni di Configurazione dei servizi web di Magento.

Nel pannello di amministrazione di Magento, clicchi su Sistema > Gestione della cache.

Abilita la cache sulle due impostazioni di Configurazione dei servizi web.

Abilitare l'integrazione di Magento 1 in Klaviyo

Utilizzi la chiave API di Magento che ha creato per abilitare l'integrazione di Magento 1 in Klaviyo.

Acceda al suo account Klaviyo e clicchi sul nome del suo account nell'angolo in basso a sinistra. Poi seleziona Integrazioni > Aggiungi integrazioni e cerca Magento. Clicchi sulla scheda Magento, quindi su Installa.

Inserisca le seguenti informazioni:

• URL del sito
  L'URL del sito è l'indirizzo della sua istanza Magento.
• Nome utente API
  Il nome utente che ha creato per il suo nuovo utente con permessi API.
• Password / chiave API
  La chiave API che ha creato per il suo nuovo utente.

Ora, faccia clic su Connetti a Magento. Le verranno presentate le seguenti opzioni avanzate, che dovrà attivare se necessario:

• Negozi
  Tutti i negozi Magento 1 sono sincronizzati con Klaviyo per impostazione predefinita. Questa impostazione le consente di essere selettivo sui negozi con cui si integra. Per saperne di più, visiti la sezione Supporto di più negozi Magento. 
• Impostazioni prezzo speciale
  Le consigliamo vivamente di attivare le Impostazioni di prezzo speciale se intende utilizzare questa funzione. È più difficile abilitare questa funzione in un secondo momento. Può leggere di più su questa impostazione nella sezionePrezzo speciale qui sotto.
• Impostazioni dei coupon
  Consulti questa guida su come abilitare i coupon in Magento 1 e poi compili questi campi.

Al termine, clicchi su Completa la configurazione.

Magento 1 è ora collegato a Klaviyo. Poi aggiungerà l'estensione/plugin Klaviyo al suo account Magento.

Installi l'estensione Klaviyo in Magento

L'estensione Klaviyo aggiunge al suo negozio Magento il monitoraggio delle attività sul sito e dei prodotti visti. L'installazione dell'estensione Klaviyo per Magento è necessaria anche per iniziare a sincronizzare gli eventi di Checkout Started . È importante sincronizzare gli eventi di Checkout Started in modo che possano innescare il flusso del carrello abbandonato.

L'ultima estensione di Klaviyo per Magento 1 è la v.1.9.0, aggiornata a ottobre 2024: Estensione Magento 1 v1.9.0 Download.

Dopo aver scaricato l'estensione sul suo computer, si colleghi a System > Magento Connect > Magento Connect Manager.

Alla voce Caricamento diretto dei file del pacchetto, faccia clic su Scegli file e selezioni l'estensione che ha scaricato in precedenza. Clicchi su Carica. L'estensione verrà caricata e installata.

Una volta installata l'estensione, si rechi nella pagina dell'estensione per configurare le impostazioni.
Clicchi su Sistema > Configurazione e poi clicchi su Klaviyo nella sezione Clienti. Se dopo aver fatto clic su Klaviyo si verifica un messaggio 404, esca da Magento e vi acceda nuovamente.

Imposti Abilitato su Sì e compili gli altri campi. La Chiave del Consumatore, il Segreto del Consumatore, il Token di Autorizzazione e il Segreto di Autorizzazione possono essere lasciati vuoti, a meno che non stia impostando dei coupon con Magento.

Sincronizzare un modulo di iscrizione Magento con una lista Klaviyo

Può opzionalmente sincronizzare un modulo di iscrizione di Magento, in modo che gli utenti vengano aggiunti ad una lista di Klaviyo.

Per prima cosa, crei una lista in Klaviyo che desidera sincronizzare con il suo modulo di iscrizione Magento.

Se non si trova già nella scheda Impostazioni generali (come indicato nella sezione precedente), vada su Sistema > Configurazione e clicchi su Klaviyo nella sezione Clienti.

Dal menu a tendina Elenco abbonamenti generale, selezioni l'elenco Klaviyo a cui desidera sincronizzarsi.

Per impostazione predefinita, Utilizza le impostazioni Opt-In di Klaviyo per questa lista è impostato su Sì, utilizza le impostazioni di Klaviyo per questa lista. Le consigliamo di mantenere questa impostazione abilitata. Quando questa impostazione è abilitata:

• Per una lista double opt-in: l'utente riceverà un'e-mail di conferma prima di essere aggiunto alla lista designata. Una volta confermati via e-mail, vengono aggiunti alla lista e viene creata una metrica di iscrizione alla lista. Se non riceve alcuna conferma, non verrà aggiunto all'elenco.
• Per una lista opt-in singola: il cliente verrà aggiunto ad una lista e verrà creata una metrica Iscriviti alla lista.

Se l'opzione No, non inviare email opt-in da Klaviyo è attivata, non verrà mai creata una metrica Sottoscritto a una lista quando un profilo viene aggiunto a una lista. Non raccomandiamo questa impostazione, ma è disponibile per preservare un'impostazione ereditata.

Impostare un cron job di Magento

L'estensione Klaviyo utilizza i cron job per essere sempre aggiornata ed eseguire attività di manutenzione periodica.

Dal pannello di amministrazione di Magento, vada su Configurazione del sistema > .

Scorra fino alla sezione Avanzate e scelga Sistema.

Quindi selezioni Cron (Attività pianificate) .Impostate un Cron da eseguire ogni 5 minuti, quindi cliccate su Salva configurazione.

Per maggiori informazioni sull'impostazione dei cron job di Magento, consulti la documentazione di Magento per informazioni più dettagliate sull'impostazione di un cron job.

Configurare cron in un sistema operativo basato su UNIX

Se ha accesso alla shell del suo server, può utilizzare il comando crontab service. Il cron di Magento deve essere eseguito ogni cinque minuti, quindi la configurazione temporale è:

*/5 * * * *

La riga completa in crontab avrà l'aspetto di una di queste (suggeriamo la prima versione):

*/5 * * * * /bin/sh MAGENTO_PATH/cron.sh
*/5 * * * /bin/bash MAGENTO_PATH/cron.sh
*/5 * * * /usr/bin/php MAGENTO_PATH/cron.php
*/5 * * * /usr/local/bin/php -f MAGENTO_PATH/cron.php

dove MAGENTO_PATH è la posizione della sua installazione di Magento sul server.

Configuri cron utilizzando cPanel (o il suo provider di hosting virtuale).

Se non ha accesso alla shell, può consultare la documentazione del suo provider di hosting virtuale. Di seguito, trattiamo l'utilizzo di cPannel come esempio.

Acceda a cPanel per il suo account di hosting. Trovi la sezione Avanzate e clicchi sull'icona "Cron Jobs".

Viene visualizzato un elenco dei lavori cron attuali e un modulo per aggiungere un nuovo lavoro. Inserisca le seguenti impostazioni nel modulo "Add New Cron Job". Si assicuri di sostituire MAGENTO_PATH con il percorso della sua installazione di Magento. Se non è sicuro di quale sia il percorso o di come trovarlo, può utilizzare un programma FTP per sfogliare i file sul suo server e trovare la directory che contiene il file cron.sh.

Dopo aver aggiunto il nuovo cron job, dovrebbe vedere i dati di checkout in Klaviyo entro 15 minuti.

Monitoraggio della sincronizzazione dei dati storici

Quando si integra per la prima volta con Magento 1, Klaviyo sincronizzerà gli ultimi 90 giorni dei dati di Magento 1, in modo da poter iniziare subito a coinvolgere i clienti più recenti. Dopo la sincronizzazione dei suoi ultimi 90 giorni di dati, Klaviyo inizierà la sincronizzazione completa dei dati storici. A seconda del numero di ordini, clienti e prodotti del suo negozio, possono essere necessari da pochi minuti a diversi giorni per sincronizzare tutti i suoi dati.

Una volta completata questa sincronizzazione storica, i nuovi dati verranno sincronizzati con Klaviyo ogni 30 minuti. Per verificare il progresso della sincronizzazione iniziale, clicchi sulla scheda Analytics nella barra laterale.

Trovi la metrica e cambi l'intervallo di date del grafico per vedere quali date sono state completamente sincronizzate. Al termine della sincronizzazione, l'integrazione di Magento 1 nellascheda Integrazioni sarà contrassegnata come completa. Se vuole verificare di persona che tutti i dati di Magento 1 siano sincronizzati, può fare un controllo incrociato degli ordini totali per alcuni giorni o una settimana. Prima di iniziare la convalida, si assicuri che il fuso orario del suo account corrisponda alle impostazioni di Magento 1.

Dati sincronizzati con l'integrazione di Magento 1

L'integrazione di Klaviyo con Magento le consente di estrarre determinate informazioni sui clienti dalla sua piattaforma Magento per inviare e-mail mirate e basate sui dati in Klaviyo. Una volta configurata l'integrazione, sarà in grado di personalizzare e indirizzare le e-mail in base agli acquisti dei clienti e all'attività del sito web. Ecco alcuni dei dati che sincronizziamo da Magento:

• Informazioni sul cliente, tra cui nome, cognome e località.
• Klaviyo sincronizza tutti i clienti che si iscrivono alla sua lista di newsletter Magento in futuro. È importante assicurarsi che tutti i clienti che entrano nella sua lista di newsletter Magento abbiano acconsentito a ricevere email di marketing.
• Dati relativi all'evasione, al rimborso e all'annullamento degli ordini.
• Quando le persone visitano il suo sito web e quali articoli e categorie visualizzano.
  • Queste metriche saranno visualizzate nel suo account come Attivo sul sito e Prodotto visto.
  • Non dovrà aggiungere lo snippet di monitoraggio di Klaviyo al suo sito con l'integrazione Magento, poiché queste metriche sono già gestite dalla nostra estensione.

Per saperne di più, si rechi a Rivedere e comprendere i dati di Magento 1.

Creare una chiave API con permessi limitati

Questa documentazione riguarda l'API SOAP di Magento su cui si basa l'integrazione di Klaviyo. Consigliamo di dare accesso a tutti gli endpoint all'interno del percorso /api/*. Anche se molto probabilmente queste non corrisponderanno direttamente alle autorizzazioni che vedrà al momento dell'impostazione dell'utente e del ruolo SOAP (poiché le autorizzazioni sono cambiate nel corso delle varie versioni 1.x), ecco le chiamate API che effettuiamo per Magento 1.x:

• catalogoAlberoCategoria
• catalogoInventarioElenco articoli
• catalogoProductAttributeInfo
• catalogoProdottoAttributoMediaList
• catalogoProductInfo
• catalogoElenco prodotti
• catalogoProductTagList
• clienteCustomerInfo
• clienteElenco clienti
• elenco dei gruppi di clienti
• salesOrderInfo
• elenco degli ordini di vendita
• shoppingCartInfo
• storeList

Se deve consentire l'accesso a determinate porte (se ha un firewall, ad esempio), l'integrazione di Magento è attualmente su HTTP/80, ma se è disponibile su 443 questo può essere modificato.

Prezzo speciale

Quando configura le impostazioni dell'integrazione, avrà la possibilità di inserire "Special Price," che si riferisce ad un prezzo di vendita speciale per gli articoli che può essere applicato facoltativamente in un determinato intervallo di date. Per ogni prodotto, ci sono 4 campi di metadati che sincronizzeremo:

• prezzo (Richiesto float): Il prezzo standard dell'articolo
• prezzo_speciale (float opzionale): Si tratta di un prezzo di vendita speciale per l'articolo. Quando questo prezzo è in vigore, vedrà questo prezzo_speciale accanto a una barra del prezzo
• data_speciale_da (data opzionale): Specifica la data di inizio dell'efficacia di prezzo_speciale.
• special_to_date (data opzionale): Specifica la data di scadenza dell'efficacia di prezzo_speciale .

Nella pagina delle impostazioni di integrazione di Magento 1, c'è una casella di controllo per Utilizzare il prezzo speciale per i prezzi dei prodotti, quando applicabile. Quando questa impostazione è attivata, il blocco prodotto visualizzerà il prezzo speciale, se applicabile. Quando utilizza un feed di prodotti dinamici, il prezzo speciale verrà popolato al momento dell'invio. Quando seleziona manualmente gli articoli dal suo catalogo, il prezzo speciale verrà visualizzato una volta selezionato il prodotto o i prodotti.

Converta i valori degli ordini di Magento in un'unica valuta

Klaviyo supporta la conversione di tutte le valute estere in Magento in una valuta primaria in Klaviyo. Quando questa funzione è abilitata, la conversione avviene quando Magento sincronizza i dati dell'ordine in Klaviyo. Questo è particolarmente utile se ha più negozi con transazioni in valute diverse.

Klaviyo verificherà se il codice_valuta_ordine è uguale al codice_valuta_globale impostato. In caso contrario, Klaviyo convertirà il totale dell'ordine dalla valuta dell'ordine alla valuta globale specificata nelle impostazioni dell'integrazione. Questo assicura che le sue analisi finanziarie siano accurate.

Aggiorna la sua estensione

Sta utilizzando una versione dell'estensione Magento inferiore a 1.8.3? Le consigliamo di effettuare immediatamente l'aggiornamento alla versione 1.8.3. Le versioni precedenti dell'estensione utilizzano le API v1 e v2 di Klaviyo, che sono state ritirate e non funzionano più come previsto. 

Per aggiornare la sua estensione, rimuova la vecchia estensione e poi segua i passi contenuti in questa guida per reinstallarla. Può scaricare la versione 1.8.3 qui: Magento 1 v1.8.3 Extension Download.