Con l'integrazione Mapp, chiunque si iscriva viene creato o aggiornato come contatto in Mapp Engage e aggiunto al gruppo (lista) che scegli.
Cosa ti serve
- Un account Mapp Engage e un utente che possa creare utenti di sistema (di solito un amministratore).
- L'indirizzo API di Mapp Engage. È l'indirizzo del tuo sistema Mapp Engage con il percorso dell'API: lo trovi nella documentazione API di Mapp per il tuo sistema, oppure chiedendolo al supporto di Mapp.
Passaggio 1: crea un utente API in Mapp Engage
Mapp Engage usa un utente separato per l'API, con nome utente e password.
- In Mapp Engage, vai su Administration > System Users.
- Crea un nuovo utente di sistema e chiamalo per esempio "Scratcher".
- Dai all'utente il ruolo API (accesso API), con i diritti indicati qui sotto.
- Imposta una password sicura e salva. Copia il nome utente e la password.
I diritti di cui ha bisogno l'utente API
Scratcher usa l'utente per:
- leggere i tuoi gruppi, così puoi sceglierne uno nella campagna;
- leggere gli attributi dei contatti, così puoi mappare i campi su di essi;
- creare e aggiornare contatti;
- aggiungere contatti ai gruppi (iscriverli).
L'utente non ha bisogno di accedere a messaggi, report o altro.
Passaggio 2: collega Mapp a Scratcher
- In Scratcher, vai su Impostazioni > Integrazioni e clicca su Mapp.
- Incolla l'indirizzo API, il nome utente e la password nei campi corrispondenti.
- Clicca su Installa integrazione. Scratcher controlla di poter leggere i tuoi gruppi.
Passaggio 3: attivalo in una campagna
- Nell'editor, vai su Collega > Integrazioni > Mapp e clicca su Attiva.
- Se hai collegato più di un account, sceglilo in Seleziona account.
- In Lista esterna, scegli il gruppo di Mapp.
- In Mappature dei campi, clicca su Aggiungi mappatura dei campi e abbina ogni Campo Scratcher a un attributo di Mapp, per esempio "Lead - Nome" a FirstName.
- 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 viene sempre inviato e identifica il contatto. Non devi mapparlo.
- L'elenco Campo di destinazione mostra gli attributi standard e personalizzati del tuo sistema Mapp. Crea prima gli attributi personalizzati in Mapp.
- Per i numeri di cellulare, usa l'impostazione Formato. Di solito Mapp si aspetta + e prefisso internazionale.
Consenso
I contatti vengono iscritti al gruppo che scegli. Se il gruppo usa il double opt-in in Mapp, Mapp invia la propria email di conferma e le persone vengono iscritte solo quando confermano. Usa Filtra per consensi così vengono aggiunte solo le persone che hanno spuntato la tua casella per il marketing.
Cosa viene inviato e quando
I nuovi iscritti vengono inviati entro un paio di minuti. Quando attivi l'integrazione, vengono inviati anche i lead già presenti nella campagna. Quando qualcuno partecipa di nuovo, il contatto viene aggiornato. Controlla ogni consegna in Impostazioni > Integrazioni > Stato della consegna.
Risoluzione dei problemi
- "All or some of the fields are invalid..." durante l'installazione: controlla l'indirizzo API e che l'utente di sistema abbia il ruolo API e non sia bloccato.
- Le consegne non riescono con un errore di accesso: all'utente di sistema manca uno dei diritti indicati sopra.
- La password è scaduta: alcuni sistemi Mapp fanno scadere le password. Imposta una nuova password in Mapp e collegati di nuovo con Aggiungi nuovo account.