Klaviyo verbinden

Mit der Klaviyo-Integration wird jede Person, die sich anmeldet, in Klaviyo als Profil angelegt oder aktualisiert, der gewählten Liste hinzugefügt und für E-Mail-Marketing angemeldet.

Was Sie brauchen

• Ein Klaviyo-Konto. Der kostenlose Plan funktioniert.
• Einen Klaviyo-Benutzer, der private API-Schlüssel erstellen darf (in Klaviyo meist ein Owner, Admin oder Manager).

Schritt 1: Einen privaten API-Schlüssel in Klaviyo erstellen

1. Gehen Sie in Scratcher zu Einstellungen > Integrationen, klicken Sie auf Klaviyo und sehen Sie sich die Einrichtungsanleitung an: „Privaten API-Schlüssel erstellen. Die richtigen Berechtigungen sind bereits vorausgewählt.“
2. Klicken Sie auf den Link Privaten API-Schlüssel erstellen. Klaviyo öffnet sich mit den richtigen, bereits ausgewählten Berechtigungen. Melden Sie sich an, wenn Klaviyo Sie dazu auffordert.
3. Geben Sie dem Schlüssel einen Namen, den Sie wiedererkennen, zum Beispiel „Scratcher“.
4. Prüfen Sie die Berechtigungen (siehe Liste unten) und erstellen Sie den Schlüssel.
5. Kopieren Sie den Schlüssel. Er beginnt mit „pk_“. Klaviyo zeigt den vollständigen Schlüssel nur einmal. Lassen Sie den Tab also offen, bis Sie ihn eingefügt haben.

Wenn Sie den Schlüssel lieber selbst anlegen: Öffnen Sie in Klaviyo das Menü unter Ihrem Kontonamen, gehen Sie zu Settings > API keys und klicken Sie auf Create Private API Key. Wählen Sie Custom Key und setzen Sie die Berechtigungen unten.

Berechtigungen, die der Schlüssel braucht

Der Schlüssel braucht genau diese Berechtigungen (der Hilfetext in Scratcher: „Der API-Schlüssel benötigt Lese- und Schreibzugriff auf „Lists“ und „Profiles“ sowie Schreibzugriff auf „Subscriptions““).

• Lists: Lesen und Schreiben. Um Ihre Listen anzuzeigen und Menschen hinzuzufügen.
• Profiles: Lesen und Schreiben. Um Profile anzulegen und zu aktualisieren.
• Subscriptions: Schreiben. Um Menschen für E-Mail-Marketing anzumelden.

Alle anderen Berechtigungen können auf No Access bleiben.

Schritt 2: Klaviyo mit Scratcher verbinden

1. Fügen Sie den Schlüssel im Klaviyo-Dialog in Scratcher unter Private API Key ein. Das Feld Zugriffsberechtigungen zeigt, was Scratcher darf: „Lese- und Schreibzugriff auf Kontakte & Listen“ und „Automatische Hintergrundsynchronisierung der Kampagnenteilnehmer“.
2. Klicken Sie auf Integration installieren. Scratcher prüft, ob der Schlüssel Ihre Listen lesen kann.

Schritt 3: In einer Kampagne aktivieren

1. Gehen Sie im Editor zu Verbinden > Integrationen > Klaviyo und klicken Sie auf Aktivieren.
2. Wenn Sie mehr als ein Klaviyo-Konto verbunden haben, wählen Sie es unter Konto auswählen.
3. Wählen Sie unter Externe Liste die Klaviyo-Liste.
4. Fügen Sie unter Feldzuordnungen die zusätzlichen Daten hinzu, die Sie im Profil haben möchten. Hier geben Sie den Namen der Eigenschaft in Klaviyo selbst ein (Name des externen Felds), zum Beispiel „favourite_product“ oder „Campaign“.
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

• E-Mail, Telefonnummer, Vorname und Nachname werden automatisch an die Profilfelder von Klaviyo gesendet. Sie müssen sie nicht zuordnen.
• Alles, was Sie zuordnen, wird als eigene Eigenschaft (Custom Property) im Profil gespeichert, mit dem Namen, den Sie eingegeben haben. Gibt es die Eigenschaft noch nicht, legt Klaviyo sie an.
• Klaviyo akzeptiert Telefonnummern nur mit + und Ländervorwahl. Achten Sie darauf, dass das Telefonfeld Ihres Formulars eine Ländervorwahl hat.

Einwilligung

Scratcher meldet alle, die es sendet, in Klaviyo für E-Mail-Marketing an, mit „Scratcher“ als Quelle. Deshalb ist der Einwilligungsfilter wichtig: Wählen Sie Ihre Marketing-Checkbox unter Nach Einwilligungen filtern (optional), wenn sie in Ihrem Formular freiwillig ist.

Nutzt Ihre Klaviyo-Liste Double-Opt-in, sendet Klaviyo eine eigene Bestätigungs-E-Mail, und die Menschen werden erst angemeldet, wenn sie bestätigen. Anschließend können Sie in Klaviyo einen Willkommens-Flow starten, sobald Menschen der Liste hinzugefügt werden.

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 das Profil aktualisiert.

Fehlerbehebung

Fehlgeschlagene Zustellungen sehen Sie unter Einstellungen > Integrationen > Zustellstatus.

• „The API key used does not have the correct API Scopes.“: Dem Schlüssel fehlt eine der Berechtigungen oben. Bearbeiten Sie den Schlüssel in Klaviyo, oder erstellen Sie über den Einrichtungslink einen neuen und verbinden Sie ihn mit Neues Konto hinzufügen.
• „Conflict: Duplicate profile detected.“: Klaviyo hat zwei passende Profile gefunden, zum Beispiel eines mit der E-Mail und ein anderes mit derselben Telefonnummer. Führen Sie die Profile in Klaviyo zusammen oder korrigieren Sie sie, und senden Sie erneut.
• Eine Telefonnummer wird abgelehnt: Der Nummer fehlt die Ländervorwahl. Ergänzen Sie das Telefonfeld Ihres Formulars um eine Länderauswahl.
• Nach der Installation kommt nichts an: Prüfen Sie, ob in der Kampagne unter Externe Liste eine Liste gewählt ist und ob Sie auf Speichern geklickt haben.