Apsis One verbinden

Mit der Apsis-One-Integration wird jede Person, die sich anmeldet, in Apsis One im gewählten Bereich (Section) als Profil angelegt oder aktualisiert und kann für eines Ihrer Apsis-One-Abonnements angemeldet werden.

Was Sie brauchen

• Ein Apsis-One-Konto und einen Benutzer, der API-Schlüssel verwalten darf (meist ein Administrator).
• Die Information, ob Ihr Apsis-One-Konto in der Region Europa oder Asien liegt. Die meisten Konten liegen in Europa.

Schritt 1: Einen API-Schlüssel in Apsis One erstellen

1. Öffnen Sie in Apsis One die Account settings und gehen Sie zu API keys (unter den Integrationen).
2. Erstellen Sie einen neuen API-Schlüssel. Geben Sie ihm einen Namen, den Sie wiedererkennen, zum Beispiel „Scratcher“.
3. Geben Sie dem Schlüssel mit den unten genannten Berechtigungen Zugriff auf den Bereich oder die Bereiche, an die Scratcher Profile senden soll.
4. Speichern Sie und kopieren Sie Client ID und Client secret. Das Secret wird nur einmal angezeigt.

Apsis hat dafür eine eigene Schritt-für-Schritt-Anleitung. Sie ist im Installationsdialog in Scratcher unter Einrichtungsanleitung verlinkt („Folgen Sie zur Installation der Integration dieser Anleitung“).

Berechtigungen, die der Schlüssel braucht

Scratcher nutzt den Schlüssel, um:

• Ihre Bereiche und die darin enthaltenen Attribute, Abonnements (Consent-Themen) und Events zu lesen, damit Sie sie in der Kampagne auswählen können;
• Profile anzulegen und ihre Attribute zu aktualisieren;
• Profilen Einwilligungen (Opt-ins) hinzuzufügen;
• Profilen Events hinzuzufügen.

Der Schlüssel braucht also Lesezugriff auf Bereiche und Schreibzugriff auf Profile, Einwilligungen und Events in den Bereichen, die Sie nutzen. Ohne Schreibzugriff schlagen Zustellungen mit der Fehlermeldung von Apsis One fehl.

Schritt 2: Apsis One mit Scratcher verbinden

1. Gehen Sie in Scratcher zu Einstellungen > Integrationen und klicken Sie auf Apsis One.
2. Wählen Sie die API-Region: Europa oder Asien.
3. Fügen Sie Client ID und Client secret ein.
4. Klicken Sie auf Integration installieren. Scratcher meldet sich bei Apsis One an, um die Angaben zu prüfen.

Schritt 3: In einer Kampagne aktivieren

1. Gehen Sie im Editor zu Verbinden > Integrationen > Apsis One und klicken Sie auf Aktivieren.
2. Wenn Sie mehr als ein Apsis-One-Konto verbunden haben, wählen Sie es unter Konto auswählen.
3. Wählen Sie unter Apsis-Bereich den Bereich (Bereich auswählen).
4. Klicken Sie unter Feldzuordnungen für jedes Feld auf Feldzuordnung hinzufügen und ordnen Sie das Scratcher-Feld unter Zielfeld dem Apsis-One-Attribut zu. Die Liste zeigt die Attribute des gewählten Bereichs, auch Ihre eigenen.
5. Wählen Sie unter Abonnements (Einwilligungen) das Abonnement, für das die Menschen angemeldet werden sollen, oder Keine. „Wählen Sie ein Abonnement, für das der Teilnehmer angemeldet werden soll.“
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.
7. Klicken Sie auf Speichern und dann auf Testen, um ein Testprofil zu senden.

Feldzuordnung

• Die E-Mail-Adresse wird immer gesendet und dient zur Identifizierung des Profils. Sie müssen sie nicht zuordnen.
• Für Telefonnummern nutzen Sie die Einstellung Format, um die Nummer so zu senden, wie Ihr Attribut sie erwartet.
• Ja/Nein-Attribute erhalten true oder false. Ordnen Sie also das Feld Angenommen einer Einwilligung einem Ja/Nein-Attribut zu.

Einwilligung

Wenn Sie ein Abonnement wählen, wird jede Person mit dem Grund „Subscribed via“ plus Kampagnenname und der Quelle „Scratcher“ dafür angemeldet. Ist die Person bereits angemeldet, ändert sich nichts. Nutzen Sie Nach Einwilligungen filtern, damit nur Menschen angemeldet werden, die Ihre Marketing-Checkbox angehakt haben.

Hat Ihr Bereich das Consent-Form-Event von Apsis One, erfasst Scratcher die Anmeldung zusätzlich als Event im Profil, mit der Adresse der Kampagne.

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. Prüfen Sie jede Zustellung unter Einstellungen > Integrationen > Zustellstatus; dort sehen Sie auch, ob das Profil neu war oder schon existierte. Siehe Den Zustellstatus prüfen und Leads erneut senden.

Fehlerbehebung

• „Einige oder alle Felder sind ungültig ...“ bei der Installation: Prüfen Sie die Region und kopieren Sie Client-ID und Secret erneut.
• Zustellungen schlagen mit einem Zugriffsfehler von Apsis One fehl: Der Schlüssel hat keinen Zugriff auf den Bereich oder es fehlen Schreibrechte. Bearbeiten Sie den Schlüssel in Apsis One.
• Abonnements (Einwilligungen) ist leer: Der Bereich hat noch keine Abonnements. Legen Sie eines in Apsis One an und öffnen Sie die Integration erneut.