Bloomreach verbinden

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.

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.