So funktionieren Integrationen

Eine Integration sendet die Menschen, die sich in Ihren Kampagnen anmelden, an ein anderes Tool, etwa an Ihr Newsletter-System oder CRM. Das funktioniert in zwei Schritten: Zuerst verbinden Sie das Tool mit Ihrem Scratcher-Konto, dann aktivieren Sie es in jeder Kampagne, in der Sie es nutzen möchten.

Jedes Tool hat eine eigene Seite mit den genauen Schritten, auch dazu, wo Sie den API-Schlüssel im Tool finden und welche Berechtigungen er braucht. Siehe Alle Integrationen.

Schritt 1: Das Tool mit Ihrem Konto verbinden

1. Gehen Sie zu Einstellungen > Integrationen (unter Entwickler). Suchen Sie nach dem Tool, oder zeigen Sie mit Nach Typ nur Newsletter-Systeme, E-Commerce oder CRM-Tools an.
2. Klicken Sie auf das Tool. Der Dialog hat die Tabs Installation und Funktionen (was die Integration kann).
3. Füllen Sie aus, wonach das Tool fragt. Es gibt zwei Arten von Tools:
   • Tools, bei denen Sie sich anmelden, etwa Mailchimp, HubSpot und Drip. Im Dialog steht „Sie werden sicher zu ... weitergeleitet, um den Zugriff zu autorisieren. Es sind keine API-Schlüssel oder manuellen Zugangsdaten erforderlich.“
   • Tools, die einen API-Schlüssel oder andere Zugangsdaten brauchen, etwa Klaviyo oder ActiveCampaign. Fügen Sie diese in die Felder ein. Das Feld Einrichtungsanleitung im Dialog sagt Ihnen, wo Sie sie finden, sofern das Tool eine Anleitung hat.
4. Klicken Sie auf Integration installieren. Scratcher prüft die Zugangsdaten sofort. Funktionieren sie nicht, sehen Sie „Einige oder alle Felder sind ungültig. Die Integration konnte die Felder nicht validieren.“

Wenn es klappt, sehen Sie „Die Integration wurde installiert.“ Durch das Verbinden des Tools werden noch keine Leads gesendet.

Sie können ein Tool auch direkt in einer Kampagne installieren (Schritt 2). Dann wird es gleichzeitig für diese Kampagne aktiviert.

Schritt 2: In einer Kampagne aktivieren

1. Öffnen Sie die Kampagne im Editor und gehen Sie zu Verbinden > Integrationen. Tippen Sie in das Suchfeld (Zum Suchen tippen …), um das Tool zu finden. Tools, die für diese Kampagne aktiv sind, tragen das Kennzeichen Aktiv.
2. Klicken Sie auf das Tool und dann auf Aktivieren. Im Panel steht „Die Integration ist aktiv.“
3. Wenn Sie mehr als ein Konto des Tools verbunden haben, wählen Sie es unter Konto auswählen. Klicken Sie auf (+ neu hinzufügen), um ein weiteres Konto zu verbinden.
4. Wählen Sie unter Externe Liste die Liste oder Zielgruppe, der die Menschen hinzugefügt werden sollen. Manche Tools haben keine Listen; dann wird dieses Feld nicht angezeigt.
5. Klicken Sie unter Feldzuordnungen für jede Angabe, die Sie senden möchten, auf Feldzuordnung hinzufügen. Siehe „Felder zuordnen“ weiter unten.
6. Wählen Sie unter Nach Einwilligungen filtern (optional) Ihre Checkbox für die Marketing-Einwilligung, damit nur Menschen gesendet werden, die sie angehakt haben. Siehe „Nur Menschen senden, die zugestimmt haben“ weiter unten.
7. Füllen Sie weitere Einstellungen des Tools aus, etwa Tags.
8. Klicken Sie auf Speichern. Sie sehen „Die Integration wurde aktualisiert.“
9. Klicken Sie auf Testen, um einen Test-Lead zu senden. Siehe „Die Integration testen“ weiter unten.

Felder zuordnen

Die Feldzuordnung legt fest, welche Scratcher-Daten in welches Feld des anderen Tools kommen. Die Kopfzeile zeigt, wie viele Felder zugeordnet sind, zum Beispiel „3 zugeordnet“.

1. Klicken Sie auf Feldzuordnung hinzufügen. Eine neue Zeile erscheint, links mit einem Scratcher-Feld und rechts mit einem Zielfeld.
2. Wählen Sie unter Feld auswählen die Scratcher-Daten, die gesendet werden sollen. Die Felder sind gruppiert:
   • Lead: die Felder Ihres Formulars (zum Beispiel „Lead - Vorname“), ID, Telefonnummer, Erstellt am und Teilgenommen am. Für jede Einwilligungs-Checkbox gibt es außerdem Angenommen, Inhalt (der Text, dem die Person zugestimmt hat), Datum und IP-Adresse.
   • Kampagne: ID und Name.
   • Teilnehmer: Kanal (woher die Person kam).
   • Quiz: die Antworten auf benannte Quizfragen, wenn die Kampagne ein Quiz hat.
   • Gewinn: ID, Name, Wert, Gutscheincode und Gewonnen am, für Gewinner.
3. Um für alle denselben festen Text zu senden, wählen Sie Benutzerdefinierten Wert verwenden und geben Sie den Text ein, zum Beispiel den Namen der Kampagne oder „Scratcher“. Mit Scratcher-Feld verwenden wechseln Sie zurück zu einem Feld.
4. Wählen Sie unter Zielfeld das Feld im anderen Tool. Die Liste stammt aus Ihrem eigenen Konto in diesem Tool, Ihre eigenen Felder sind also auch dabei. Bei einigen Tools geben Sie den Namen stattdessen ein (Name des externen Felds).
5. Klicken Sie auf das Zahnrad (Einstellungen anzeigen) für weitere Optionen:
   • Feld überspringen, wenn leer: „Dadurch wird das Feld nicht an die Integration gesendet, wenn die zu sendenden Daten leer sind.“ Nutzen Sie das, damit leere Antworten keine Daten überschreiben, die das Tool bereits hat.
   • Format (nur Telefonnummern): Mit + und Ländervorwahl (z. B. +4512345678), Mit Ländervorwahl (z. B. 4512345678) oder Ohne Ländervorwahl (z. B. 12345678). Wählen Sie, was das andere Tool erwartet.
6. Klicken Sie auf den Papierkorb (Zuordnung löschen), um eine Zeile zu entfernen.

Gut zu wissen: Die E-Mail-Adresse wird immer gesendet, und die meisten Tools erhalten auch die Telefonnummer automatisch. Auf der Seite des jeweiligen Tools steht, welche Felder für Sie ausgefüllt werden.

Nur Menschen senden, die zugestimmt haben

Nach Einwilligungen filtern (optional) listet die Einwilligungs-Checkboxen Ihrer Kampagne auf. „Wählen Sie die Einwilligungen, nach denen die Leads gefiltert werden sollen. Hat ein Lead nicht allen ausgewählten Einwilligungen zugestimmt, wird er nicht an die Integration gesendet.“

• Lassen Sie das Feld leer („Leer lassen, um alle Leads zu senden“), um alle zu senden.
• Wählen Sie Ihre Checkbox für die Marketing-Einwilligung, um nur Menschen zu senden, die sie angehakt haben. Wählen Sie mehrere, müssen alle angehakt sein.

Wer herausgefiltert wird, wird nicht gesendet und erscheint nicht unter Zustellstatus. Viele Tools fügen die gesendeten Menschen als Abonnenten hinzu. Nutzen Sie den Filter also immer, wenn Ihre Marketing-Checkbox freiwillig ist. Siehe Einwilligungen und Berechtigungen.

Die Integration testen

1. Speichern Sie die Integration zuerst, damit im Test alle Felder verfügbar sind.
2. Klicken Sie auf Testen. Das Panel Integration testen öffnet sich.
3. Wählen Sie die Liste unter Liste auswählen (bei Tools mit Listen), geben Sie eine E-Mail ein und füllen Sie für jedes zugeordnete Feld einen Wert aus.
4. Klicken Sie auf Test senden. Sie sehen „Die Daten wurden erfolgreich übermittelt“ oder die Fehlermeldung des anderen Tools.
5. Prüfen Sie, ob die Testperson im anderen Tool angekommen ist, und löschen Sie sie dort anschließend.

Der Test wird an das andere Tool gesendet, auch wenn Sie Nach Einwilligungen filtern nutzen. Sehen Sie „Sie müssen in alle Felder einen Wert eingeben“, füllen Sie jedes Feld aus.

Wann werden Leads gesendet?

• Scratcher prüft jede Minute auf neue Anmeldungen und sendet sie im Hintergrund. Neue Leads kommen also innerhalb von ein, zwei Minuten an.
• Wenn Sie eine Integration in einer Kampagne aktivieren, die bereits Leads hat, werden auch diese Leads gesendet.
• Nimmt jemand erneut teil, werden die Daten erneut gesendet, damit das Tool die neuesten Antworten hat.
• Bei Tools mit Liste wird nichts gesendet, bevor Sie eine Liste gewählt haben. Tools ohne Liste beginnen zu senden, sobald Sie auf Aktivieren klicken.

Gut zu wissen: Richten Sie die Feldzuordnungen und den Einwilligungsfilter ein, bevor die Kampagne live geht. Bereits gesendete Leads werden nicht erneut gesendet, wenn Sie die Zuordnungen später ändern. Sie können sie unter Zustellstatus erneut senden.

Prüfen, ob es funktioniert

Einstellungen > Integrationen > Zustellstatus zeigt jeden Lead, der an Ihre Tools gesendet wurde, ob es ein neuer oder bestehender Kontakt war, und den Fehler, falls es nicht geklappt hat. Siehe Den Zustellstatus prüfen und Leads erneut senden.

Verbundene Konten verwalten

Klicken Sie unter Einstellungen > Integrationen auf ein installiertes Tool. Der Tab Übersicht erinnert Sie daran, es in Ihren Kampagnen zu aktivieren. Der Tab Konten („Ihre verbundenen Konten“) listet die Konten auf, die Sie verbunden haben:

• Geben Sie einem Konto über das Menü Aktionen (...) und Umbenennen einen Namen, den Sie wiedererkennen, zum Beispiel „Newsletter DE“. Tragen Sie ihn im Dialog Konto umbenennen unter Name ein und klicken Sie auf Speichern.
• Löschen trennt das Konto: „Dadurch werden alle laufenden Integrationen deaktiviert, die dieses Konto verwenden“.
• Neues Konto hinzufügen verbindet ein weiteres Konto desselben Tools, zum Beispiel ein zweites Mailchimp-Konto.

Deaktivieren

• Öffnen Sie die Integration in der Kampagne und klicken Sie auf Deaktivieren. Aus dieser Kampagne wird dann nichts mehr gesendet.
• Um das Tool aus Ihrem Konto und allen Kampagnen zu entfernen, öffnen Sie es unter Einstellungen > Integrationen und klicken Sie auf Deinstallieren. „Möchten Sie diese Integration wirklich deinstallieren? Dadurch wird die Integration auch aus allen Kampagnen entfernt.“

Wer kann Integrationen nutzen?

• Integrationen sind in den bezahlten Plänen enthalten. HubSpot und Salesforce Marketing Cloud brauchen einen Plan, der alle nativen Integrationen enthält. Ist ein Tool gesperrt, siehe Ihre Testphase, die Pläne und was nach dem Ende der Testphase passiert.
• Benutzer mit der Rolle Inhaber, Admin oder Manager können Integrationen installieren und einrichten. Benutzer mit der Rolle Analyst können das nicht.