---
title: "Bloomreach koppelen"
description: "Maak een API-sleutel in Bloomreach Engagement, koppel die, en maak of werk klanten bij met hun toestemmingen."
url: https://scratcher.io/nl/help/integrations/bloomreach
language: nl
---

1. [Helpcentrum](https://scratcher.io/nl/help)
2. [Integraties](https://scratcher.io/nl/help/integrations)
3. Bloomreach koppelen

# Bloomreach koppelen

Maak een API-sleutel in Bloomreach Engagement, koppel die, en maak of werk klanten bij met hun toestemmingen.

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

1. Open in Bloomreach Engagement het project en ga naar **Project settings** > **Access management** > **API**.
2. Kopieer het **Project token** en de **API base URL** die op de pagina staan.
3. Maak onder de API-groepen een nieuwe groep met **Private access** en noem die bijvoorbeeld "Scratcher".
4. 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.
5. 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

1. Ga in Scratcher naar **Instellingen** > **Integraties** en klik op **Bloomreach**.
2. Plak de API base URL, het project token, de API key ID en het API secret in de bijbehorende velden.
3. Klik op **Integratie installeren**. Scratcher controleert de gegevens bij Bloomreach.

## Stap 3: Aanzetten in een campagne

1. Open in de editor **Koppelen** > **Integraties** > **Bloomreach** en klik op **Activeren**.
2. Heb je meer dan één project gekoppeld, kies het dan onder **Account selecteren**.
3. Klik onder **Veldkoppelingen** op **Veldkoppeling toevoegen** en koppel elk **Scratcher-veld** aan een klanteigenschap in Bloomreach, bijvoorbeeld "Lead - Voornaam" aan **first\_name**.
4. Kies de toestemmingscategorie die mensen moeten krijgen, bijvoorbeeld "newsletter", of geen.
5. Kies onder **Filteren op toestemmingen (optioneel)** je toestemmingsvakje voor marketing, zodat alleen mensen die het hebben aangevinkt worden verstuurd.
6. 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](https://scratcher.io/nl/help/integrations/delivery-status).

## 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.

Integraties

- [Hoe integraties werken](https://scratcher.io/nl/help/integrations/how-integrations-work)
- [Alle integraties](https://scratcher.io/nl/help/integrations/other-integrations)
- [De leveringsstatus controleren en leads opnieuw verzenden](https://scratcher.io/nl/help/integrations/delivery-status)
- [HubSpot koppelen](https://scratcher.io/nl/help/integrations/hubspot)
- [Salesforce Marketing Cloud koppelen](https://scratcher.io/nl/help/integrations/salesforce-marketing-cloud)
- [Microsoft Dynamics 365 koppelen met Zapier](https://scratcher.io/nl/help/integrations/microsoft-dynamics-365)
- [Emarsys koppelen](https://scratcher.io/nl/help/integrations/emarsys)
- [Klaviyo koppelen](https://scratcher.io/nl/help/integrations/klaviyo)
- [Mailchimp koppelen](https://scratcher.io/nl/help/integrations/mailchimp)
- [ActiveCampaign koppelen](https://scratcher.io/nl/help/integrations/activecampaign)
- [Apsis One koppelen](https://scratcher.io/nl/help/integrations/apsis-one)
- [Drip koppelen](https://scratcher.io/nl/help/integrations/drip)
- [HeyLoyalty koppelen](https://scratcher.io/nl/help/integrations/heyloyalty)
- [Peytz koppelen](https://scratcher.io/nl/help/integrations/peytz)
- [Marketingplatform koppelen](https://scratcher.io/nl/help/integrations/marketingplatform)
- [Campaign Monitor koppelen met Zapier](https://scratcher.io/nl/help/integrations/campaign-monitor)
- [ActiveTrail koppelen met Zapier](https://scratcher.io/nl/help/integrations/activetrail)
- [Bloomreach koppelen](https://scratcher.io/nl/help/integrations/bloomreach)
- [Iterable koppelen](https://scratcher.io/nl/help/integrations/iterable)
- [Mapp koppelen](https://scratcher.io/nl/help/integrations/mapp)
- [Agillic koppelen](https://scratcher.io/nl/help/integrations/agillic)
- [Ortto koppelen](https://scratcher.io/nl/help/integrations/ortto)
- [Emarketeer koppelen](https://scratcher.io/nl/help/integrations/emarketeer)
- [Shopify koppelen](https://scratcher.io/nl/help/integrations/shopify)
- [Hello Retail koppelen](https://scratcher.io/nl/help/integrations/hello-retail)
- [Meer dan 8.000 apps koppelen met Zapier](https://scratcher.io/nl/help/integrations/zapier)
- [monday.com koppelen met Zapier](https://scratcher.io/nl/help/integrations/monday-com)
- [Asana koppelen met Zapier](https://scratcher.io/nl/help/integrations/asana)
- [Podio koppelen met Zapier](https://scratcher.io/nl/help/integrations/podio)
- [Intercom koppelen met Zapier](https://scratcher.io/nl/help/integrations/intercom)

Meer leren

## Gerelateerde artikelen

- [Hoe integraties werken](https://scratcher.io/nl/help/integrations/how-integrations-work): Koppel je e-mailtool of CRM één keer, zet hem aan in elke campagne, kies een lijst, koppel je velden en stuur alleen mensen door die toestemming gaven.
- [De leveringsstatus controleren en leads opnieuw verzenden](https://scratcher.io/nl/help/integrations/delivery-status): Zie welke leads naar je tools zijn gestuurd, begrijp de foutmeldingen, los het probleem op en verstuur ze opnieuw.
- [Toestemming vragen en algemene voorwaarden toevoegen](https://scratcher.io/nl/help/forms/consent-and-permissions): Voeg selectievakjes voor toestemming toe, link je voorwaarden, kies welk vakje mensen aanmeldt voor e-mails en stuur alleen mensen die ja zeiden door naar je e-mailtool.

Hulp nodig?

## Nog steeds hulp nodig?

Echte mensen staan klaar om je te helpen. Gebruik je Scratcher al? Dan is de chat in het platform de snelste weg.

- **[Chat met ons](https://platform.scratcher.io/nl/login)**

    Log in en klik op de chatknop rechtsonder. Rex antwoordt meteen, en ons team is maar één klik verwijderd.
- **[Plan een gesprek](https://scratcher.io/nl/book-a-meeting)**

    Een gratis videogesprek van 30 minuten met ons team: een rondleiding, campagne-ideeën of hulp bij je opzet.
- **[Mail ons](mailto:contact@scratcher.io)**

    Schrijf naar contact@scratcher.io en we nemen contact met je op.
