--- title: "Bloomreach verbinden" description: "Erstellen Sie in Bloomreach Engagement einen API-Schlüssel, verbinden Sie ihn und legen Sie Kunden mit ihren Einwilligungen an oder aktualisieren Sie sie." url: https://scratcher.io/de/help/integrations/bloomreach language: de --- 1. [Hilfe-Center](https://scratcher.io/de/help) 2. [Integrationen](https://scratcher.io/de/help/integrations) 3. Bloomreach verbinden # Bloomreach verbinden Erstellen Sie in Bloomreach Engagement einen API-Schlüssel, verbinden Sie ihn und legen Sie Kunden mit ihren Einwilligungen an oder aktualisieren Sie sie. Mit der Bloomreach-Integration wird jede Person, die sich anmeldet, in Ihrem Bloomreach-Engagement-Projekt als Kunde angelegt oder aktualisiert, erkannt an der E-Mail-Adresse. Sie können ihr außerdem eine Bloomreach-Einwilligung geben, damit Sie ihr Marketing senden dürfen. ## Was Sie brauchen - Ein Bloomreach-Engagement-Projekt und einen Benutzer, der in den Projekteinstellungen den API-Zugriff verwalten darf (meist eine Projektadministratorin oder ein Projektadministrator). ## Schritt 1: Einen API-Schlüssel in Bloomreach erstellen 1. Öffnen Sie in Bloomreach Engagement das Projekt und gehen Sie zu **Project settings** > **Access management** > **API**. 2. Kopieren Sie den **Project token** und die **API base URL**, die auf der Seite angezeigt werden. 3. Legen Sie unter den API-Gruppen eine neue Gruppe mit **Private access** an und nennen Sie sie zum Beispiel „Scratcher“. 4. Erstellen Sie in der Gruppe einen neuen API-Schlüssel. Kopieren Sie die **API key ID** und das **API secret**. Das Secret wird nur einmal angezeigt. 5. Geben Sie der Gruppe die Berechtigungen unten und speichern Sie. ## Berechtigungen, die der Schlüssel braucht Erlauben Sie in den Berechtigungen der Gruppe: - **Customer properties**: get und set, um Kunden zu finden, sie anzulegen oder zu aktualisieren und Ihre Kundeneigenschaften in der Feldzuordnung anzuzeigen. - **Events**: set, für das Event `consent`, damit Scratcher Einwilligungen festhalten kann. Mehr ist nicht nötig. Ohne die set-Berechtigungen schlagen Zustellungen mit der Zugriffsfehlermeldung von Bloomreach fehl. ## Schritt 2: Bloomreach mit Scratcher verbinden 1. Gehen Sie in Scratcher zu **Einstellungen** > **Integrationen** und klicken Sie auf **Bloomreach**. 2. Fügen Sie die API base URL, den Project token, die API key ID und das API secret in die passenden Felder ein. 3. Klicken Sie auf **Integration installieren**. Scratcher prüft die Angaben bei Bloomreach. ## Schritt 3: In einer Kampagne aktivieren 1. Gehen Sie im Editor zu **Verbinden** > **Integrationen** > **Bloomreach** und klicken Sie auf **Aktivieren**. 2. Wenn Sie mehr als ein Projekt verbunden haben, wählen Sie es unter **Konto auswählen**. 3. Klicken Sie unter **Feldzuordnungen** auf **Feldzuordnung hinzufügen** und ordnen Sie jedes **Scratcher-Feld** einer Bloomreach-Kundeneigenschaft zu, zum Beispiel „Lead - Vorname“ zu **first\_name**. 4. Wählen Sie die Einwilligungskategorie, die die Personen erhalten sollen, zum Beispiel „newsletter“, oder keine. 5. Wählen Sie unter **Nach Einwilligungen filtern (optional)** Ihre Checkbox für die Marketing-Einwilligung, damit nur Personen gesendet werden, die sie angehakt haben. 6. Klicken Sie auf **Speichern** und dann auf **Testen**. > Gut zu wissen: Bloomreach hat keine Listen. Alle landen im Projekt, und Sie gruppieren sie in Bloomreach mit Segmenten. Scratcher beginnt deshalb mit dem Senden, sobald Sie auf **Aktivieren** klicken. Aktivieren Sie die Integration, bevor die Kampagne live geht, oder richten Sie sie gleich vollständig ein. ## Feldzuordnung - Die E-Mail-Adresse wird immer gesendet und dient dazu, den Kunden zu finden. Sie müssen sie nicht zuordnen. - Die Liste unter **Zielfeld** zeigt die Kundeneigenschaften in Ihrem Projekt. Fehlt eine Eigenschaft, legen Sie sie zuerst in Bloomreach an. - Um zu kennzeichnen, woher Kunden kommen, wählen Sie **Benutzerdefinierten Wert verwenden** mit einem Text wie „Scratcher Sommerspiel“ und ordnen Sie ihn einer Eigenschaft zu, die Sie für die Quelle nutzen. ## Einwilligung Wenn Sie eine Einwilligungskategorie wählen, hält Scratcher ein `consent`-Event mit der Aktion accept und dem Namen der Kampagne als Quelle fest. Die Kategorie muss in Bloomreach existieren (in den Einwilligungseinstellungen unter **Project settings**). Nutzen Sie **Nach Einwilligungen filtern (optional)**, damit nur Personen, die Ihre Marketing-Checkbox angehakt haben, die Einwilligung erhalten. ## Was wann gesendet wird Neue Anmeldungen werden innerhalb von ein, zwei Minuten gesendet. Wenn Sie die Integration aktivieren, werden auch die bestehenden Leads der Kampagne gesendet. Nimmt jemand erneut teil, wird der Kunde aktualisiert. Jede Zustellung können Sie unter **Einstellungen** > **Integrationen** > **Zustellstatus** prüfen. Siehe [Den Zustellstatus prüfen und Leads erneut senden](https://scratcher.io/de/help/integrations/delivery-status). ## Fehlerbehebung - „All or some of the fields are invalid...“ bei der Installation: Prüfen Sie die API base URL und den Project token, und kopieren Sie Key ID und Secret noch einmal. - Zustellungen schlagen mit einem Zugriffsfehler fehl: Der API-Gruppe fehlt eine der Berechtigungen oben. Bearbeiten Sie sie in Bloomreach. - Die Einwilligung erscheint nicht beim Kunden: Die Einwilligungskategorie existiert in Bloomreach nicht oder ist anders geschrieben. - Bloomreach hat eigene Anleitungen für API-Schlüssel. Suchen Sie in der Bloomreach-Dokumentation nach „API access management“, wenn die Menüs anders aussehen. Integrationen - [So funktionieren Integrationen](https://scratcher.io/de/help/integrations/how-integrations-work) - [Alle Integrationen](https://scratcher.io/de/help/integrations/other-integrations) - [Den Zustellstatus prüfen und Leads erneut senden](https://scratcher.io/de/help/integrations/delivery-status) - [HubSpot verbinden](https://scratcher.io/de/help/integrations/hubspot) - [Salesforce Marketing Cloud verbinden](https://scratcher.io/de/help/integrations/salesforce-marketing-cloud) - [Microsoft Dynamics 365 mit Zapier verbinden](https://scratcher.io/de/help/integrations/microsoft-dynamics-365) - [Emarsys verbinden](https://scratcher.io/de/help/integrations/emarsys) - [Klaviyo verbinden](https://scratcher.io/de/help/integrations/klaviyo) - [Mailchimp verbinden](https://scratcher.io/de/help/integrations/mailchimp) - [ActiveCampaign verbinden](https://scratcher.io/de/help/integrations/activecampaign) - [Apsis One verbinden](https://scratcher.io/de/help/integrations/apsis-one) - [Drip verbinden](https://scratcher.io/de/help/integrations/drip) - [HeyLoyalty verbinden](https://scratcher.io/de/help/integrations/heyloyalty) - [Peytz verbinden](https://scratcher.io/de/help/integrations/peytz) - [Marketingplatform verbinden](https://scratcher.io/de/help/integrations/marketingplatform) - [Campaign Monitor mit Zapier verbinden](https://scratcher.io/de/help/integrations/campaign-monitor) - [ActiveTrail mit Zapier verbinden](https://scratcher.io/de/help/integrations/activetrail) - [Bloomreach verbinden](https://scratcher.io/de/help/integrations/bloomreach) - [Iterable verbinden](https://scratcher.io/de/help/integrations/iterable) - [Mapp verbinden](https://scratcher.io/de/help/integrations/mapp) - [Agillic verbinden](https://scratcher.io/de/help/integrations/agillic) - [Ortto verbinden](https://scratcher.io/de/help/integrations/ortto) - [Emarketeer verbinden](https://scratcher.io/de/help/integrations/emarketeer) - [Shopify verbinden](https://scratcher.io/de/help/integrations/shopify) - [Hello Retail verbinden](https://scratcher.io/de/help/integrations/hello-retail) - [Über 8.000 Apps mit Zapier verbinden](https://scratcher.io/de/help/integrations/zapier) - [monday.com mit Zapier verbinden](https://scratcher.io/de/help/integrations/monday-com) - [Asana mit Zapier verbinden](https://scratcher.io/de/help/integrations/asana) - [Podio mit Zapier verbinden](https://scratcher.io/de/help/integrations/podio) - [Intercom mit Zapier verbinden](https://scratcher.io/de/help/integrations/intercom) ## Ähnliche Artikel - [So funktionieren Integrationen](https://scratcher.io/de/help/integrations/how-integrations-work): Verbinden Sie Ihr E-Mail-Tool oder CRM einmal, aktivieren Sie es in jeder Kampagne, wählen Sie eine Liste, ordnen Sie Ihre Felder zu und senden Sie nur Menschen, die eingewilligt haben. - [Den Zustellstatus prüfen und Leads erneut senden](https://scratcher.io/de/help/integrations/delivery-status): Sehen Sie, welche Leads an Ihre Tools gesendet wurden, verstehen Sie die Fehlermeldungen, beheben Sie das Problem und senden Sie die Leads erneut. - [Einwilligungen einholen und Teilnahmebedingungen hinzufügen](https://scratcher.io/de/help/forms/consent-and-permissions): Fügen Sie Einwilligungs-Checkboxen für Newsletter hinzu, verlinken Sie Ihre Teilnahmebedingungen, wählen Sie, welche Checkbox zum Abonnement führt, und senden Sie nur Menschen, die zugestimmt haben, an Ihr E-Mail-Tool. ## Brauchen Sie noch Hilfe? Echte Menschen helfen Ihnen gern. Wenn Sie Scratcher bereits nutzen, ist der Chat in der Plattform der schnellste Weg. - **[Chatten Sie mit uns](https://platform.scratcher.io/login)** Melden Sie sich an und klicken Sie unten rechts auf den Chat-Button. Rex antwortet sofort, und unser Team ist nur einen Klick entfernt. - **[Termin buchen](https://scratcher.io/de/book-a-meeting)** Ein kostenloser 30-minütiger Videocall mit unserem Team: eine Tour, Kampagnenideen oder Hilfe bei Ihrer Einrichtung. - **[Schreiben Sie uns](mailto:kontakt@scratcher.io)** Schreiben Sie an kontakt@scratcher.io, und wir melden uns bei Ihnen.