Emarsys verbinden

Mit der Emarsys-Integration wird jede Person, die sich anmeldet, in Emarsys als Kontakt angelegt oder aktualisiert und der gewählten Kontaktliste hinzugefügt.

Was Sie brauchen

• Ein Emarsys-Konto und einen Benutzer, der API-Zugangsdaten verwalten darf (unter Management > Security Settings).

Schritt 1: API-Zugangsdaten in Emarsys erstellen

1. Gehen Sie in Emarsys zu Management > Security Settings > API Credentials.
2. Klicken Sie auf Create API Credentials und achten Sie darauf, OpenID Connect auszuwählen.
3. Schalten Sie unter Permissions diese vier ein: contact.create, contact.update, contactlist.list und field.list.
4. Speichern Sie und kopieren Sie Client ID und Client Secret. Sie brauchen beide in Scratcher.

Berechtigungen, die die Zugangsdaten brauchen

• contact.create und contact.update: um neue Kontakte anzulegen und bestehende zu aktualisieren.
• contactlist.list: um Ihre Kontaktlisten in der Kampagne anzuzeigen.
• field.list: um Ihre Emarsys-Felder in der Feldzuordnung anzuzeigen.

Weitere Berechtigungen sind nicht nötig.

Schritt 2: Emarsys mit Scratcher verbinden

1. Gehen Sie in Scratcher zu Einstellungen > Integrationen und klicken Sie auf Emarsys. Die Einrichtungsanleitung im Dialog wiederholt die Schritte oben.
2. Fügen Sie Client ID und Client secret ein.
3. Klicken Sie auf Integration installieren. Scratcher prüft, ob es Ihre Kontaktlisten lesen kann.

Schritt 3: In einer Kampagne aktivieren

1. Gehen Sie im Editor zu Verbinden > Integrationen > Emarsys und klicken Sie auf Aktivieren.
2. Wenn Sie mehr als ein Konto verbunden haben, wählen Sie es unter Konto auswählen.
3. Wählen Sie unter Externe Liste die Kontaktliste.
4. Ordnen Sie unter Feldzuordnungen mindestens „Lead - E-Mail“ dem Emarsys-Feld Email zu und dann Ihre weiteren Felder, zum Beispiel First Name und Last Name. Die Emarsys-Felder werden mit Namen aufgeführt.
5. Wählen Sie unter Nach Einwilligungen filtern (optional) Ihre Checkbox für die Marketing-Einwilligung.
6. Klicken Sie auf Speichern und dann auf Testen.

Feldzuordnung

• Ordnen Sie die E-Mail-Adresse selbst zu. Emarsys nutzt sie, um bestehende Kontakte zu finden. Ein Kontakt ohne E-Mail kann also nicht zugeordnet werden.
• Nur die Felder, die Sie zuordnen, werden gesendet.
• Einige Systemfelder von Emarsys, etwa Opt-in, Registrierungsdatum und Newsletter, werden nicht angeboten, weil Emarsys sie selbst setzt.

Einwilligung

Scratcher setzt das Opt-in-Feld des Kontakts in Emarsys für alle, die es sendet, auf „true“. Nutzen Sie also immer Nach Einwilligungen filtern (optional) mit Ihrer Checkbox für die Marketing-Einwilligung, wenn diese in Ihrem Formular freiwillig ist.

Was wann gesendet wird

Neue Anmeldungen werden innerhalb von ein, zwei Minuten gesendet, die bestehenden Leads der Kampagne beim Aktivieren. Existiert der Kontakt bereits, wird er aktualisiert und der Liste hinzugefügt.

Fehlerbehebung

• „Einige oder alle Felder sind ungültig ...“ bei der Installation: Client-ID oder Secret ist falsch, oder die Zugangsdaten nutzen nicht OpenID Connect.
• Zustellungen schlagen fehl, oder die Auswahllisten für Liste oder Felder sind leer: Den Zugangsdaten fehlt eine der vier Berechtigungen. Bearbeiten Sie sie in Emarsys.
• Kontakte werden doppelt angelegt: „Lead - E-Mail“ ist nicht dem Feld Email zugeordnet.