Iterable verbinden

Mit der Iterable-Integration wird jede Person, die sich anmeldet, in Iterable als Benutzer angelegt oder aktualisiert, erkannt an der E-Mail-Adresse, und für die gewählte Iterable-Liste angemeldet.

Was Sie brauchen

• Ein Iterable-Projekt, das die E-Mail-Adresse als Benutzerkennung nutzt, und einen Benutzer mit der Berechtigung, API-Schlüssel zu verwalten (meist ein Org-Admin oder Projekt-Admin).
• Die Information, ob Ihr Iterable-Projekt im US- oder im EU-Rechenzentrum liegt.

Schritt 1: Einen API-Schlüssel in Iterable erstellen

1. Gehen Sie in Iterable zu Integrations > API Keys.
2. Klicken Sie auf New API Key.
3. Geben Sie ihm einen Namen, zum Beispiel „Scratcher“, und wählen Sie den Typ Standard (serverseitig).
4. Erstellen Sie den Schlüssel und kopieren Sie ihn. Iterable zeigt den vollständigen Schlüssel nur einmal.

Wofür der Schlüssel genutzt wird

Ein Standard-Schlüssel (serverseitig) kann alles, was Scratcher braucht:

• Ihre Listen und Benutzerfelder lesen, damit Sie sie in der Kampagne auswählen können;
• Benutzer anlegen und aktualisieren;
• Benutzer für Listen anmelden.

Nutzen Sie keinen JavaScript-, Mobile- oder Nur-Lese-Schlüssel: Damit lassen sich keine Benutzer von einem Server aus hinzufügen.

Schritt 2: Iterable mit Scratcher verbinden

1. Gehen Sie in Scratcher zu Einstellungen > Integrationen und klicken Sie auf Iterable.
2. Wählen Sie das Rechenzentrum (US oder EU) und fügen Sie den API-Schlüssel ein.
3. Klicken Sie auf Integration installieren. Scratcher prüft, ob es Ihre Listen lesen kann.

Schritt 3: In einer Kampagne aktivieren

1. Gehen Sie im Editor zu Verbinden > Integrationen > Iterable und klicken Sie auf Aktivieren.
2. Wenn Sie mehr als ein Projekt verbunden haben, wählen Sie es unter Konto auswählen.
3. Wählen Sie unter Externe Liste die Iterable-Liste. Nur statische Listen können gewählt werden.
4. Klicken Sie unter Feldzuordnungen auf Feldzuordnung hinzufügen und ordnen Sie jedes Scratcher-Feld einem Iterable-Benutzerfeld zu, zum Beispiel „Lead - Vorname“ zu firstName.
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

• Die E-Mail-Adresse wird immer gesendet und identifiziert den Benutzer. Sie müssen sie nicht zuordnen.
• Die Liste unter Zielfeld zeigt die Benutzerfelder in Ihrem Projekt. Gibt es ein Feld noch nicht, legen Sie es zuerst in Iterable an, damit es den richtigen Typ bekommt.
• Für Telefonnummern nutzen Sie Format mit + und Ländervorwahl, wie Iterable es für SMS erwartet.

Einwilligung

Allein durch die Aufnahme in eine Liste werden Personen nicht für Ihre Nachrichtentypen angemeldet: Dafür nutzt Iterable eigene Abonnement-Einstellungen. Senden Sie nur Personen, die zugestimmt haben, indem Sie Ihre Marketing-Checkbox unter Nach Einwilligungen filtern (optional) wählen. Sie können auch die Felder Angenommen und Datum einer Einwilligung Benutzerfeldern zuordnen, damit Sie in Iterable einen Nachweis der Einwilligung haben.

Was wann gesendet wird

Neue Anmeldungen werden innerhalb von ein, zwei Minuten gesendet, und die bestehenden Leads der Kampagne werden gesendet, wenn Sie die Integration aktivieren. Nimmt jemand erneut teil, wird der Benutzer aktualisiert. Nutzen Sie die Liste als Start einer Journey in Iterable, um eine Willkommensnachricht zu senden. Jede Zustellung sehen Sie unter Einstellungen > Integrationen > Zustellstatus.

Fehlerbehebung

• „All or some of the fields are invalid...“ bei der Installation: Der Schlüssel ist falsch oder kein Standard-Schlüssel, oder Sie haben das falsche Rechenzentrum gewählt.
• Ein Feld wird abgelehnt: Der Wert passt nicht zum Typ des Benutzerfelds in Iterable, zum Beispiel Text in einem Datumsfeld. Prüfen Sie die Zuordnung.
• Die Liste fehlt: Dynamische Listen können keine Benutzer aufnehmen. Legen Sie in Iterable eine statische Liste an.