Met de integratie voor Mapp wordt iedereen die zich aanmeldt als contact in Mapp Engage aangemaakt of bijgewerkt en toegevoegd aan de groep (lijst) die jij kiest.
Wat je nodig hebt
- Een Mapp Engage-account en een gebruiker die systeemgebruikers kan aanmaken (meestal een beheerder).
- Het API-adres van je Mapp Engage. Dat is het adres van je Mapp Engage-systeem met het API-pad. Je vindt het in de API-documentatie van Mapp voor jouw systeem, of je vraagt het aan de support van Mapp.
Stap 1: Een API-gebruiker maken in Mapp Engage
Mapp Engage gebruikt een aparte gebruiker voor de API, met een gebruikersnaam en wachtwoord.
- Ga in Mapp Engage naar Administration > System Users.
- Maak een nieuwe systeemgebruiker aan en noem die bijvoorbeeld "Scratcher".
- Geef de gebruiker de API-rol (API-toegang), met de rechten hieronder.
- Stel een sterk wachtwoord in en sla op. Kopieer de gebruikersnaam en het wachtwoord.
Rechten die de API-gebruiker nodig heeft
Scratcher gebruikt de gebruiker om:
- je groepen te lezen, zodat je er een in de campagne kunt kiezen;
- je contactattributen te lezen, zodat je velden eraan kunt koppelen;
- contacten aan te maken en bij te werken;
- contacten aan groepen toe te voegen (ze aan te melden).
De gebruiker heeft geen toegang nodig tot berichten, rapporten of iets anders.
Stap 2: Mapp koppelen aan Scratcher
- Ga in Scratcher naar Instellingen > Integraties en klik op Mapp.
- Plak het API-adres, de gebruikersnaam en het wachtwoord in de bijbehorende velden.
- Klik op Integratie installeren. Scratcher controleert of het je groepen kan lezen.
Stap 3: Aanzetten in een campagne
- Open in de editor Koppelen > Integraties > Mapp en klik op Activeren.
- Heb je meer dan één account gekoppeld, kies het dan onder Account selecteren.
- Kies onder Externe lijst de Mapp-groep.
- Klik onder Veldkoppelingen op Veldkoppeling toevoegen en koppel elk Scratcher-veld aan een attribuut in Mapp, bijvoorbeeld "Lead - Voornaam" aan FirstName.
- Kies onder Filteren op toestemmingen (optioneel) je toestemmingsvakje voor marketing.
- Klik op Opslaan en daarna op Testen.
Velden koppelen
- Het e-mailadres wordt altijd verstuurd en herkent het contact. Je hoeft het niet te koppelen.
- De lijst Doelveld toont de standaard- en aangepaste attributen in je Mapp-systeem. Maak aangepaste attributen eerst aan in Mapp.
- Gebruik voor mobiele nummers de instelling Format. Mapp verwacht meestal + en landcode.
Toestemming
Contacten worden aangemeld voor de groep die je kiest. Gebruikt de groep double opt-in in Mapp, dan stuurt Mapp zijn eigen bevestigingsmail, en worden mensen pas aangemeld als ze bevestigen. Gebruik Filteren op toestemmingen zodat alleen mensen die je toestemmingsvakje voor marketing hebben aangevinkt worden toegevoegd.
Wat wordt er verstuurd en wanneer
Nieuwe aanmeldingen worden binnen een minuut of twee verstuurd. Als je de integratie activeert, worden ook de bestaande leads van de campagne verstuurd. Doet iemand opnieuw mee, dan wordt het contact bijgewerkt. Controleer elke levering onder Instellingen > Integraties > Leveringsstatus.
Problemen oplossen
- "Sommige of alle velden zijn ongeldig..." bij het installeren: controleer het API-adres, en of de systeemgebruiker de API-rol heeft en niet geblokkeerd is.
- Leveringen mislukken met een toegangsfout: de systeemgebruiker mist een van de rechten hierboven.
- Het wachtwoord is verlopen: sommige Mapp-systemen laten wachtwoorden verlopen. Stel een nieuw wachtwoord in in Mapp en koppel opnieuw met Nieuw account toevoegen.