Con l'integrazione Emarsys, chiunque si iscriva viene creato o aggiornato come contatto in Emarsys e aggiunto alla lista di contatti che scegli.
Cosa ti serve
- Un account Emarsys e un utente che possa gestire le credenziali API (in Management > Security Settings).
Passaggio 1: crea le credenziali API in Emarsys
- In Emarsys, vai su Management > Security Settings > API Credentials.
- Clicca su Create API Credentials e assicurati di selezionare OpenID Connect.
- In Permissions, attiva questi quattro:
contact.create,contact.update,contactlist.listefield.list. - Salva e copia il Client ID e il Client Secret. Ti servono entrambi in Scratcher.
I permessi di cui hanno bisogno le credenziali
contact.createecontact.update: per creare nuovi contatti e aggiornare quelli esistenti.contactlist.list: per mostrare le tue liste di contatti nella campagna.field.list: per mostrare i tuoi campi di Emarsys nella mappatura dei campi.
Non servono altri permessi.
Passaggio 2: collega Emarsys a Scratcher
- In Scratcher, vai su Impostazioni > Integrazioni e clicca su Emarsys. La Guida alla configurazione nella finestra ripete i passaggi qui sopra.
- Incolla l'ID client e il Client secret.
- Clicca su Installa integrazione. Scratcher controlla di poter leggere le tue liste di contatti.
Passaggio 3: attivalo in una campagna
- Nell'editor, vai su Collega > Integrazioni > Emarsys e clicca su Attiva.
- Se hai collegato più di un account, sceglilo in Seleziona account.
- In Lista esterna, scegli la lista di contatti.
- In Mappature dei campi, mappa almeno "Lead - Email" sul campo Email di Emarsys, e poi gli altri campi, per esempio First Name e Last Name. I campi di Emarsys sono elencati per nome.
- In Filtra per consensi (facoltativo), scegli la tua casella di consenso al marketing.
- Clicca su Salva e poi su Test.
Mappatura dei campi
- L'indirizzo email devi mapparlo tu. Emarsys lo usa per trovare i contatti esistenti, quindi un contatto senza email non può essere abbinato.
- Vengono inviati solo i campi che mappi.
- Alcuni campi di sistema di Emarsys, come opt-in, data di registrazione e newsletter, non sono disponibili, perché li imposta Emarsys stesso.
Consenso
Scratcher imposta su "true" il campo opt-in del contatto in Emarsys per tutte le persone che invia. Per questo usa sempre Filtra per consensi (facoltativo) con la tua casella di consenso al marketing, se nel tuo modulo è facoltativa.
Cosa viene inviato e quando
I nuovi iscritti vengono inviati entro un paio di minuti, e i lead già presenti nella campagna vengono inviati quando attivi l'integrazione. Se il contatto esiste già, viene aggiornato e aggiunto alla lista.
Risoluzione dei problemi
- "All or some of the fields are invalid..." durante l'installazione: il client ID o il secret è sbagliato, oppure le credenziali non usano OpenID Connect.
- Le consegne non riescono, oppure gli elenchi a tendina di liste o campi sono vuoti: alle credenziali manca uno dei quattro permessi. Modificale in Emarsys.
- I contatti vengono creati due volte: "Lead - Email" non è mappato sul campo Email.