Met de integratie voor Bloomreach wordt iedereen die zich aanmeldt als klant (customer) aangemaakt of bijgewerkt in je Bloomreach Engagement-project, herkend aan het e-mailadres. Je kunt ze ook een toestemming (consent) in Bloomreach geven, zodat je ze marketing mag sturen.
Wat je nodig hebt
- Een Bloomreach Engagement-project en een gebruiker die API-toegang in de projectinstellingen kan beheren (meestal een projectbeheerder).
Stap 1: Een API-sleutel maken in Bloomreach
- Open in Bloomreach Engagement het project en ga naar Project settings > Access management > API.
- Kopieer het Project token en de API base URL die op de pagina staan.
- Maak onder de API-groepen een nieuwe groep met Private access en noem die bijvoorbeeld "Scratcher".
- Maak in de groep een nieuwe API-sleutel aan. Kopieer de API key ID en het API secret. Het secret wordt maar één keer getoond.
- Geef de groep de rechten hieronder en sla op.
Rechten die de sleutel nodig heeft
Sta bij de rechten van de groep het volgende toe:
- Customer properties: get en set, om klanten te vinden, aan te maken of bij te werken, en om je klanteigenschappen in de veldkoppeling te tonen.
- Events: set, voor het event
consent, zodat Scratcher toestemmingen kan vastleggen.
Meer is niet nodig. Zonder de set-rechten mislukken leveringen met een eigen toegangsfout van Bloomreach.
Stap 2: Bloomreach koppelen aan Scratcher
- Ga in Scratcher naar Instellingen > Integraties en klik op Bloomreach.
- Plak de API base URL, het project token, de API key ID en het API secret in de bijbehorende velden.
- Klik op Integratie installeren. Scratcher controleert de gegevens bij Bloomreach.
Stap 3: Aanzetten in een campagne
- Open in de editor Koppelen > Integraties > Bloomreach en klik op Activeren.
- Heb je meer dan één project gekoppeld, kies het dan onder Account selecteren.
- Klik onder Veldkoppelingen op Veldkoppeling toevoegen en koppel elk Scratcher-veld aan een klanteigenschap in Bloomreach, bijvoorbeeld "Lead - Voornaam" aan first_name.
- Kies de toestemmingscategorie die mensen moeten krijgen, bijvoorbeeld "newsletter", of geen.
- Kies onder Filteren op toestemmingen (optioneel) je toestemmingsvakje voor marketing, zodat alleen mensen die het hebben aangevinkt worden verstuurd.
- Klik op Opslaan en daarna op Testen.
Goed om te weten: Bloomreach heeft geen lijsten. Iedereen komt in het project terecht, en je groepeert ze met segmenten in Bloomreach. Scratcher begint dus te versturen zodra je op Activeren klikt. Activeer de integratie voordat de campagne live gaat, of stel hem meteen helemaal in.
Velden koppelen
- Het e-mailadres wordt altijd verstuurd en wordt gebruikt om de klant te vinden. Je hoeft het niet te koppelen.
- De lijst Doelveld toont de klanteigenschappen in je project. Ontbreekt er een, maak die dan eerst aan in Bloomreach.
- Wil je vastleggen waar klanten vandaan komen, koppel dan een Aangepaste waarde gebruiken zoals "Scratcher summer game" aan een eigenschap die je voor de bron gebruikt.
Toestemming
Kies je een toestemmingscategorie, dan legt Scratcher een event consent vast met de actie accept en de naam van de campagne als bron. De categorie moet bestaan in Bloomreach (onder de toestemmingsinstellingen in Project settings). Gebruik Filteren op toestemmingen zodat alleen mensen die je toestemmingsvakje voor marketing hebben aangevinkt de toestemming krijgen.
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 de klant bijgewerkt. Controleer elke levering onder Instellingen > Integraties > Leveringsstatus. Zie De leveringsstatus controleren en leads opnieuw verzenden.
Problemen oplossen
- "Sommige of alle velden zijn ongeldig..." bij het installeren: controleer de API base URL en het project token, en kopieer de key ID en het secret opnieuw.
- Leveringen mislukken met een toegangsfout: de API-groep mist een van de rechten hierboven. Pas die aan in Bloomreach.
- De toestemming verschijnt niet bij de klant: de toestemmingscategorie bestaat niet in Bloomreach, of is anders gespeld.
- Bloomreach heeft eigen handleidingen voor API-sleutels. Zoek in de documentatie van Bloomreach op "API access management" als de menu's er anders uitzien.