Met de integratie voor Iterable wordt iedereen die zich aanmeldt als gebruiker (user) in Iterable aangemaakt of bijgewerkt, herkend aan het e-mailadres, en aangemeld voor de Iterable-lijst die jij kiest.
Wat je nodig hebt
- Een Iterable-project dat e-mail als gebruikers-ID gebruikt, en een gebruiker die API-sleutels mag beheren (meestal een org admin of project admin).
- Weten of je Iterable-project in het Amerikaanse (US) of het Europese (EU) datacenter staat.
Stap 1: Een API-sleutel maken in Iterable
- Ga in Iterable naar Integrations > API Keys.
- Klik op New API Key.
- Noem de sleutel bijvoorbeeld "Scratcher" en kies het type Standard (server-side).
- Klik om de sleutel aan te maken en kopieer hem. Iterable toont de hele sleutel maar één keer.
Waarvoor de sleutel wordt gebruikt
Een standaardsleutel (server-side) kan wat Scratcher nodig heeft:
- je lijsten en gebruikersvelden lezen, zodat je ze in de campagne kunt kiezen;
- gebruikers aanmaken en bijwerken;
- gebruikers aanmelden voor lijsten.
Gebruik geen JavaScript-, mobiele of alleen-lezen-sleutel: die kunnen geen gebruikers toevoegen vanaf een server.
Stap 2: Iterable koppelen aan Scratcher
- Ga in Scratcher naar Instellingen > Integraties en klik op Iterable.
- Kies het datacenter (US of EU) en plak de API-sleutel.
- Klik op Integratie installeren. Scratcher controleert of het je lijsten kan lezen.
Stap 3: Aanzetten in een campagne
- Open in de editor Koppelen > Integraties > Iterable en klik op Activeren.
- Heb je meer dan één project gekoppeld, kies het dan onder Account selecteren.
- Kies onder Externe lijst de Iterable-lijst. Alleen statische lijsten kunnen worden gekozen.
- Klik onder Veldkoppelingen op Veldkoppeling toevoegen en koppel elk Scratcher-veld aan een gebruikersveld in Iterable, 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 de gebruiker. Je hoeft het niet te koppelen.
- De lijst Doelveld toont de gebruikersvelden in je project. Bestaat een veld nog niet, maak het dan eerst aan in Iterable, zodat het het juiste type krijgt.
- Gebruik voor telefoonnummers Format met + en landcode, zoals Iterable dat voor sms verwacht.
Toestemming
Op een lijst staan meldt mensen niet vanzelf aan voor je berichttypes: Iterable gebruikt daarvoor zijn eigen abonnementsinstellingen. Stuur alleen mensen die ja zeiden, door je toestemmingsvakje voor marketing te kiezen onder Filteren op toestemmingen (optioneel). Je kunt ook de velden Geaccepteerd en Datum van een toestemming aan gebruikersvelden koppelen, zodat je in Iterable bewijs van de toestemming hebt.
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. Doet iemand opnieuw mee, dan wordt de gebruiker bijgewerkt. Gebruik de lijst als start van een journey in Iterable om een welkomstbericht te sturen. Elke levering zie je onder Instellingen > Integraties > Leveringsstatus.
Problemen oplossen
- "Sommige of alle velden zijn ongeldig..." bij het installeren: de sleutel klopt niet of is geen standaardsleutel, of je hebt het verkeerde datacenter gekozen.
- Een veld wordt geweigerd: de waarde past niet bij het type van het gebruikersveld in Iterable, bijvoorbeeld tekst in een datumveld. Controleer de koppeling.
- De lijst ontbreekt: dynamische lijsten kunnen geen gebruikers ontvangen. Maak een statische lijst aan in Iterable.