Met de integratie voor Emarsys wordt iedereen die zich aanmeldt als contact in Emarsys aangemaakt of bijgewerkt en toegevoegd aan de contactlijst die jij kiest.
Wat je nodig hebt
- Een Emarsys-account en een gebruiker die API-gegevens kan beheren (onder Management > Security Settings).
Stap 1: API-gegevens maken in Emarsys
- Ga in Emarsys naar Management > Security Settings > API Credentials.
- Klik op Create API Credentials en zorg dat je OpenID Connect selecteert.
- Zet onder Permissions deze vier aan:
contact.create,contact.update,contactlist.listenfield.list. - Sla op en kopieer de Client ID en het Client Secret. Je hebt ze allebei nodig in Scratcher.
Rechten die de gegevens nodig hebben
contact.createencontact.update: om nieuwe contacten aan te maken en bestaande bij te werken.contactlist.list: om je contactlijsten in de campagne te tonen.field.list: om je Emarsys-velden in de veldkoppeling te tonen.
Andere rechten zijn niet nodig.
Stap 2: Emarsys koppelen aan Scratcher
- Ga in Scratcher naar Instellingen > Integraties en klik op Emarsys. De Installatiehandleiding in het venster herhaalt de stappen hierboven.
- Plak de Client-ID en het Client secret.
- Klik op Integratie installeren. Scratcher controleert of het je contactlijsten kan lezen.
Stap 3: Aanzetten in een campagne
- Open in de editor Koppelen > Integraties > Emarsys en klik op Activeren.
- Heb je meer dan één account gekoppeld, kies het dan onder Account selecteren.
- Kies onder Externe lijst de contactlijst.
- Koppel onder Veldkoppelingen minstens "Lead - E-mail" aan het veld Email in Emarsys, en daarna je andere velden, bijvoorbeeld First Name en Last Name. Emarsys-velden worden op naam getoond.
- Kies onder Filteren op toestemmingen (optioneel) je toestemmingsvakje voor marketing.
- Klik op Opslaan en daarna op Testen.
Velden koppelen
- Koppel het e-mailadres zelf. Emarsys gebruikt het om bestaande contacten te vinden, dus een contact zonder e-mailadres kan niet worden gematcht.
- Alleen de velden die je koppelt, worden verstuurd.
- Sommige systeemvelden van Emarsys, zoals opt-in, registratiedatum en nieuwsbrief, worden niet aangeboden, omdat Emarsys die zelf invult.
Toestemming
Scratcher zet het opt-in-veld van het contact in Emarsys op "true" voor iedereen die het verstuurt. Gebruik dus altijd Filteren op toestemmingen (optioneel) met je toestemmingsvakje voor marketing, als dat vakje op je formulier optioneel is.
Wat wordt er verstuurd en wanneer
Nieuwe aanmeldingen worden binnen een minuut of twee verstuurd, en de bestaande leads van de campagne worden verstuurd zodra je de integratie activeert. Bestaat het contact al, dan wordt het bijgewerkt en aan de lijst toegevoegd.
Problemen oplossen
- "Sommige of alle velden zijn ongeldig..." bij het installeren: de client-ID of het secret klopt niet, of de gegevens gebruiken geen OpenID Connect.
- Leveringen mislukken, of de keuzelijsten voor lijst of velden zijn leeg: de gegevens missen een van de vier rechten. Pas ze aan in Emarsys.
- Contacten worden dubbel aangemaakt: "Lead - E-mail" is niet gekoppeld aan het veld Email.