Come impostare i coupon (per Magento 1.x)
L’integrazione di Klaviyo con Magento 1 non accetta più nuove installazioni e raggiungerà la fine del supporto completa verso la fine del 2027. Il Supporto Klaviyo non è più in grado di assisterti con richieste relative a Magento 1.
Cosa imparerai
Magento supporta le regole prezzo del carrello che possono essere utilizzate per applicare uno sconto all’ordine di un cliente. È possibile creare codici coupon per le regole prezzo esistenti, in modo che gli acquirenti possano usare facilmente un determinato codice per applicare uno sconto durante il processo di pagamento.
La funzionalità coupon di Klaviyo per Magento consente ai negozi Magento 1.0 di fare quanto segue:
- Crea nuovi coupon in Klaviyo associati a regole di prezzo preesistenti in Magento.
- Includi coupon univoci nelle e-mail del flusso, così ogni destinatario riceve un codice univoco.
Questa guida spiegherà come configurare i coupon Magento in Klaviyo.
I coupon univoci non sono attualmente disponibili quando invii e-mail di campagne. Inviare codici coupon univoci in una campagna richiederebbe la generazione di migliaia di codici al secondo. Klaviyo non può garantire che le impostazioni di limitazione della velocità di un server Magento specifico non influiscano sulla generazione di coupon univoci a questo volume e a questa velocità. Per questo motivo, i coupon univoci sono disponibili solo quando invii e-mail di flussi.
Requisiti
Come prerequisito, assicurati di aver abilitato l'integrazione Magento in Klaviyo e installato l'estensione Klaviyo in Magento.
Abilita l'API REST
Inizia abilitando l'API REST creando un nuovo ruolo REST e assegnandogli l'accesso completo, quindi assegna il ruolo a uno dei tuoi utenti amministratori.
- Fai clic su Sistema > Servizi web > REST - Ruoli.
- Crea un nuovo ruolo Amministratore. Nel campo Nome ruolo inserisci un nome, ad esempio "Amministratore".
- Fai clic sulla scheda Risorse API del ruolo a sinistra. Imposta Accesso alle risorse su Tutto e fai clic su Salva ruolo.
- Quindi, vai a Sistema > Servizi Web > REST - Attributi.
- Seleziona Amministratore dall’elenco dei tipi di utente.
- Imposta Accesso risorsa su Tutto e fai clic su Salva.
- Poi, vai a Sistema > Autorizzazioni > Utenti.
- Seleziona un utente amministratore dall'elenco e clicca su Modifica utente.
- Fai clic sulla scheda Ruolo REST nella barra laterale sinistra.
- Fai clic sul pulsante di opzione per assegnare il nuovo ruolo di amministratore REST al tuo utente.
- Clicca su Salva utente.
Ora hai abilitato l’API REST per il tuo negozio Magento.
Se non sei sicuro che la tua API REST sia configurata correttamente, consulta i passaggi descritti nella nostra risorsa sulla risoluzione dei problemi dei coupon per Magento 1x.
Genera le credenziali REST in Magento
Per abilitare la funzionalità coupon di Magento in Klaviyo, genera prima le credenziali API REST dal tuo store Magento utilizzando l'account amministratore REST che hai appena creato, quindi incollale nel tuo account Klaviyo.
- Accedi come utente amministratore REST che hai creato nella sezione "Attiva l'API REST" sopra
- Fai clic su System > Configuration e poi fai clic su Klaviyo nella sezione Customers.
- Clicca su Genera token OAuth.
Verranno compilati Consumer Key, Consumer Secret, Authorization Token e Authorization Secret. Nel passaggio successivo copierai e incollerai questi valori nel tuo account Klaviyo.
Configura i coupon Magento in Klaviyo
- Dal tuo account Klaviyo, vai alle tue integrazioni Magento.
- Fai clic sulla freccia Opzioni avanzate per espandere le Impostazioni del coupon.
- Incolla le credenziali REST che hai creato sopra.
Il tuo server Magento deve supportare le firme HMAC-SHA1 per l’autenticazione OAuth.
- Clicca su Aggiorna impostazioni Magento.
Klaviyo convaliderà le tue credenziali REST e potrai iniziare a creare coupon con la scheda Coupon del tuo account.
Crea un coupon Magento in Klaviyo
Quando accedi per la prima volta a la scheda coupon nel tuo account Klaviyo dopo aver fornito le credenziali REST, vedrai il messaggio: "Non hai ancora aggiunto coupon."
Prima di creare un nuovo coupon, devi prima definire una regola di prezzo in Magento che includa tutte le specifiche per il coupon. Le regole di prezzo non possono essere create all’interno di Klaviyo. Un nuovo coupon creato in Klaviyo deve fare riferimento a una regola di prezzo già esistente in Magento.
Quando crei una regola di prezzo in Magento, tieni presente che l’opzione per associare una nuova regola di prezzo a un coupon specifico deve rimanere impostata su coupon specifico e devi selezionare la casella di controllo Use Auto Generation.
- Clicca su Aggiungi coupon per creare un nuovo coupon.
- Inserisci le seguenti informazioni: Nome coupon e ID regola Magento.
- Nome coupon: il nome specificato può essere composto solo da lettere, numeri e trattini bassi e può essere lungo fino a 32 caratteri
- ID regola Magento: crea prima una regola in Magento e incolla qui l’ID di tale regola per associarla a questo coupon
Tutti i coupon creati verranno mostrati con i seguenti dettagli di riepilogo:
- Nome del coupon: nome del coupon
- Periodo di attività: sono disponibili le seguenti opzioni:
- Attivo, nessuna scadenza
- Data A - Nessuna scadenza
- Data A - Data B
- Attivo, data di scadenza B
- Data di creazione: data in cui è stato creato il coupon
- Data ultimo aggiornamento: data dell'ultimo aggiornamento del coupon
I coupon possono essere modificati ed eliminati da questa scheda tramite il menu a discesa sul lato destro.
Usa un coupon Magento in un'e-mail del flusso
Una volta creato un coupon, puoi inserirlo in un'e-mail del flusso utilizzando la seguente variabile segnaposto. Puoi aggiungere un solo codice coupon per e-mail. Puoi mostrare lo stesso codice coupon in più punti, ma non puoi usare più codici.
{% coupon_code 'CouponName' %}Sostituisci CouponName con il nome del tuo coupon. Per esempio:
Usa i coupon univoci nei messaggi SMS del flusso
I coupon univoci sono disponibili anche per i tuoi messaggi SMS/MMS nei flussi. Genera i codici proprio come faresti per le e-mail. Poi, usa il tag modello qui sotto per aggiungere il codice coupon al tuo messaggio SMS o MMS:
{% coupon_code 'CouponName' %}.
Nello snippet, sostituisci CouponName con il nome del coupon che desideri e aggiungilo al messaggio (nel flusso o nella campagna).
A differenza delle e-mail, puoi utilizzare solo un codice coupon per messaggio SMS. Con l'e-mail, hai accesso a blocchi nascosti per inviare coupon diversi in base a dove vive qualcuno o a cosa ha fatto. Se provi ad aggiungere più coupon a un messaggio SMS, vedrai un messaggio di errore.
Risoluzione dei problemi relativi agli errori
Messaggio di errore: "Impossibile connettersi all'API REST con le credenziali REST specificate. " Verifica che queste credenziali siano valide nel pannello di amministrazione di Magento."
Se visualizzi questo messaggio di errore in Klaviyo, le cause principali probabili sono due:
- Il tuo server Magento non è configurato per supportare le firme HMAC-SHA1 per l'autenticazione OAuth.
- Potresti non aver abilitato l'accesso completo ai ruoli per l'API REST.
Per risolvere il problema, abilita le firme HMAC-SHA1 per l'autenticazione OAuth sul tuo server Magento. Poi completa i seguenti passaggi per aggiornare le autorizzazioni REST:
- Rimuovi il commento o aggiungi la regola di riscrittura nel tuo file .htaccess . Questa è la riga che ti consigliamo di assicurarti che sia decommentata:
RewriteRule ^api/rest api.php?type=rest [QSA,L] - Verifica di nuovo che il tuo ruolo REST sia configurato correttamente
Trovi le istruzioni nel nostro guida alla configurazione dei coupon per Magento nella sezione collegata qui. - Un'altra causa comune è che vari moduli Apache possono rimuovere l'intestazione “Authorization: Basic base64 (user:password)”.
Consulta questo post per maggiori informazioni
I codici coupon inseriti nelle e-mail da Klaviyo non sono univoci: sembra che tuttə i destinatari ricevano lo stesso codice.
Quando crei una regola di prezzo in Magento, l'opzione per associare una nuova regola di prezzo a un coupon specifico deve rimanere impostata su coupon specifico e devi selezionare la casella di controllo “Use Auto Generation”.
Fai clic sulla regola prezzo in Magento e, in Informazioni generali, scorri verso il basso fino all'opzione di riga "coupon" e modifica questa impostazione in "coupon specifico". Quindi seleziona la casella per la generazione automatica qui. Questo dovrebbe risolvere il problema e consentirci di generare un nuovo codice coupon univoco per ogni destinatario dell'e-mail.