Mage Loyalty aiuta i negozi Shopify a gestire premi in punti o credito del negozio, livelli VIP, referral e liste dei desideri. Collega Mage Loyalty a Omnisend per utilizzare le informazioni sulla fedeltà in segmenti e messaggi e avviare flussi automatizzati dall'attività di fedeltà.
Vantaggi
Crea audience in base ai punti disponibili o al credito del negozio e al livello VIP.
Personalizza campagne e automazioni con il saldo fedeltà attuale di un cliente.
Segui quando i clienti guadagnano premi o riscattano uno sconto.
Utilizza eventi di referral, compleanno e lista dei desideri opzionali quando configurati in Mage.
Prima di iniziare
Installa Mage Loyalty nel tuo negozio Shopify e configura il tuo programma di fedeltà.
Hai bisogno del piano Essenziale di Mage o superiore per l'integrazione con Omnisend.
Hai bisogno di accesso al negozio Shopify e al marchio Omnisend che desideri collegare.
Processo di Configurazione
Passaggio 1. Crea una chiave API di Omnisend
In Omnisend, seleziona il marchio che desideri collegare.Vai a Impostazioni del negozio API Chiavi API e crea una chiave dedicata con permessi Contatti: lettura e scrittura e Eventi: lettura e scrittura.Copia la chiave completa e conservala privata.
Passo 2. Collega Mage Loyalty
Nel tuo admin Shopify, apri App Mage Loyalty Integrazioni Omnisend.Incolla la chiave in Chiave API Omnisend e fai clic su Salva chiave API.Controlla che l'integrazione mostri Connesso.
1 Per le istruzioni di configurazione di Mage, vedi Come configurare l'integrazione con Omnisend.
Passaggio 3. Scegli i tuoi eventi
Nella pagina Omnisend di Mage, rivedi Impostazioni eventi e seleziona gli eventi che desideri utilizzare.Le modifiche vengono salvate automaticamente.I programmi di credito del negozio utilizzano Credito del negozio assegnato, Credito del negozio in attesa e Credito del negozio in scadenza al posto degli eventi corrispondenti ai punti.
Gli eventi di referral e lista dei desideri richiedono le relative funzionalità di Mage e impostazioni degli eventi.Gli avvisi della lista dei desideri richiedono anche che il fornitore di avvisi della lista dei desideri sia impostato su Omnisend.Abilita solo gli eventi che intendi utilizzare.
Passaggio 4. Controlla la connessione
Utilizza Invia evento di test in Mage con un indirizzo email che controlli per inviare dati di esempio.
In Omnisend, vai a Audience Contatti, trova quell'indirizzo email e apri l'evento sotto Attività contatto Dettagli evento.Successivamente, guadagna credito o riscatta un premio attraverso il tuo negozio utilizzando un cliente di prova.Controlla che il saldo del contatto si aggiorni e che l'evento corrispondente appaia.
Se la Modalità di test di Mage è abilitata, solo i clienti di prova elencati generano eventi.Rivedi la guida alla modalità di test di Mage prima di testare.
Quali dati vengono inviati
Mage abbina i clienti per indirizzo email e scrive le proprie proprietà di fedeltà nei contatti di Omnisend.Le proprietà si aggiornano quando cambiano i punti, il livello o i premi di un cliente.
Proprietà del contatto
Programmi a punti: magePointsBalance,mageLifetimePoints, emageRedeemedPoints.
Programmi di credito del negozio: mageStoreCreditBalance (valuta formattata),mageStoreCreditBalanceValue (numero),mageLifetimeStoreCredit, e mageRedeemedStoreCredit.
Informazioni VIP: mageVipTierName,mageNextVipTierName, emageAmountToNextVipTier.
Data: iscrizione, ultima sincronizzazione e compleanno dove fornito.
Alcune proprietà dipendono dalla configurazione del tuo programma o dal piano di Mage.Vedi il riferimento completo a proprietà ed eventi di Mage per i campi disponibili.
Eventi di fedeltà
Punti assegnati / Credito del negozio assegnato: un'azione di guadagno approvata. I premi in credito del negozio includono Credito assegnato, Valore del credito assegnato, Regola di guadagno e Stato.
Premio riscattato: un cliente spende punti o credito del negozio per un premio. I dettagli includono Nome del premio, Tipo di sconto, Codice sconto dove emesso e il saldo dopo il riscatto. Per i programmi di credito del negozio, il Credito speso è formattato nella valuta del tuo negozio, mentre i Punti spesi contengono l'importo in centesimi. Ad esempio, un riscatto di $1.00 invia Credito speso $1.00 e Punti spesi 100.
Livello VIP cambiato: il livello cambia quando i livelli VIP sono abilitati; consulta il riferimento di Mage per il comportamento e i campi di attivazione supportati.
Eventi opzionali: premi in attesa o in scadenza, referral, compleanni, benvenuto, cashback, sfide fotografiche, promemoria di regali e avvisi della lista dei desideri, a seconda delle funzionalità abilitate.
Utilizza i dati di fedeltà in Omnisend
Crea un segmento di fedeltà
Vai a Audience Segmenti e utilizza una proprietà personalizzata di Mage come filtro.Ad esempio, targetizza un livello VIP con mageVipTierName, o clienti con credito disponibile utilizzando il numerico mageStoreCreditBalanceValue.
📝 Scopri di più: Contatto Proprietà Personalizzate.
Personalizza un Messaggio
Nella tua campagna o messaggio di flusso automatizzato, scegli un campo Mage sotto Personalizzazione → Proprietà personalizzate.
Ad esempio, usa [[contact.custom_properties.mageStoreCreditBalance]] per un saldo formattato o [[contact.custom_properties.mageVipTierName]] per il livello attuale.Aggiungi un fallback per i contatti la cui proprietà è vuota.
🔁 Segui Usa la Personalizzazione in Omnisend.
Crea Automazione attivata da Eventi
Usa eventi Mage per inviare messaggi quando un cliente guadagna credito negozio o riscatta una ricompensa.
Vai a Flusso automatizzato → Crea flusso → Crea da zero e seleziona l'evento Mage che desideri attivare per il flusso (l'evento diventa disponibile dopo che Omnisend lo riceve per la prima volta).
Aggiungi un'email al flusso, poi usa Personalizzazione → Evento per includere dettagli da quell'evento.Ad esempio:
Negozio Credito Assegnato: includiCredito Assegnato per dire ai clienti quanto credito hanno guadagnato.
Ricompensa Riscattato: includiRicompensa Nome eSconto Codice affinché i clienti possano utilizzare la loro ricompensa. Per i programmi di credito negozio, puoi anche includereCredito Speso.
Questi dettagli dell'evento sono disponibili solo nei flussi attivati dall'evento corrispondente.Per personalizzare una campagna regolare con il saldo o il livello di fedeltà attuale di un cliente, usa invece le loro proprietà di contatto sincronizzate.
📝 Per ulteriori informazioni su come impostare i trigger degli eventi e utilizzare i campi degli eventi, vedi Crea e Gestisci Eventi Personalizzati in Omnisend.
Domande frequenti
Perché mancano le proprietà di fedeltà?
I clienti senza attività di fedeltà dalla connessione potrebbero non avere ancora proprietà Mage.Controlla l'email del cliente, il marchio connesso e i permessi della chiave API, poi ispeziona un cambiamento di fedeltà supportato.
Un evento di fedeltà crea o aggiorna il contatto in Omnisend.I nuovi contatti vengono aggiunti come non iscritti.Un aggiornamento solo di proprietà richiede che il contatto esista già in Omnisend.
Posso sincronizzare i membri di fedeltà esistenti?
Non assumere che la connessione importi automaticamente tutti i dati storici di fedeltà.La guida attuale all'importazione CSV di Mage descrive la sincronizzazione di massa assistita dal fornitore in Omnisend.Contatta Mage se hai bisogno di una sincronizzazione di massa per membri esistenti.
Perché un evento appare senza un'email?
Controlla che il flusso Omnisend corrispondente sia attivo e che il suo trigger, i filtri del pubblico e le impostazioni del messaggio consentano al contatto di entrare e ricevere il messaggio.In Mage, conferma anche che l'evento sia abilitato.Per un'assegnazione manuale di credito, seleziona Invia notifica di credito negozio guadagnato quando intendi attivare la notifica configurata.
Come faccio a disconnettermi?
Apri Mage Loyalty → Integrazioni → Omnisend e clicca Disconnetti per fermare la sincronizzazione futura.
Per impostazioni del programma Mage, importazioni o domande sulla connessione, contatta supporto Mage.Per assistenza con contatti, segmenti o flussi Omnisend, contatta il nostro team di supporto tramite la chat in-app o a [email protected].Siamo disponibili 24/7.

