Mit der Mapp-Integration wird jede Person, die sich anmeldet, in Mapp Engage als Kontakt angelegt oder aktualisiert und der gewählten Gruppe (Liste) hinzugefügt.
Was Sie brauchen
- Ein Mapp-Engage-Konto und einen Benutzer, der Systembenutzer anlegen darf (meist eine Administratorin oder ein Administrator).
- Die API-Adresse Ihres Mapp-Engage-Systems. Das ist die Adresse Ihres Mapp-Engage-Systems mit dem API-Pfad. Sie finden sie in der API-Dokumentation von Mapp für Ihr System, oder Sie fragen den Mapp-Support.
Schritt 1: Einen API-Benutzer in Mapp Engage erstellen
Mapp Engage nutzt für die API einen eigenen Benutzer mit Benutzername und Passwort.
- Gehen Sie in Mapp Engage zu Administration > System Users.
- Legen Sie einen neuen Systembenutzer an und nennen Sie ihn zum Beispiel „Scratcher“.
- Geben Sie dem Benutzer die API-Rolle (API-Zugriff) mit den Rechten unten.
- Legen Sie ein sicheres Passwort fest und speichern Sie. Kopieren Sie Benutzername und Passwort.
Rechte, die der API-Benutzer braucht
Scratcher nutzt den Benutzer, um:
- Ihre Gruppen zu lesen, damit Sie in der Kampagne eine auswählen können;
- Ihre Kontaktattribute zu lesen, damit Sie ihnen Felder zuordnen können;
- Kontakte anzulegen und zu aktualisieren;
- Kontakte zu Gruppen hinzuzufügen (sie anzumelden).
Zugriff auf Nachrichten, Berichte oder andere Bereiche braucht der Benutzer nicht.
Schritt 2: Mapp mit Scratcher verbinden
- Gehen Sie in Scratcher zu Einstellungen > Integrationen und klicken Sie auf Mapp.
- Fügen Sie API-Adresse, Benutzername und Passwort in die passenden Felder ein.
- Klicken Sie auf Integration installieren. Scratcher prüft, ob es Ihre Gruppen lesen kann.
Schritt 3: In einer Kampagne aktivieren
- Gehen Sie im Editor zu Verbinden > Integrationen > Mapp und klicken Sie auf Aktivieren.
- Wenn Sie mehr als ein Konto verbunden haben, wählen Sie es unter Konto auswählen.
- Wählen Sie unter Externe Liste die Mapp-Gruppe.
- Klicken Sie unter Feldzuordnungen auf Feldzuordnung hinzufügen und ordnen Sie jedes Scratcher-Feld einem Mapp-Attribut zu, zum Beispiel „Lead - Vorname“ zu FirstName.
- Wählen Sie unter Nach Einwilligungen filtern (optional) Ihre Checkbox für die Marketing-Einwilligung.
- Klicken Sie auf Speichern und dann auf Testen.
Feldzuordnung
- Die E-Mail-Adresse wird immer gesendet und identifiziert den Kontakt. Sie müssen sie nicht zuordnen.
- Die Liste unter Zielfeld zeigt die Standard- und eigenen Attribute in Ihrem Mapp-System. Legen Sie eigene Attribute zuerst in Mapp an.
- Für Mobilnummern nutzen Sie die Einstellung Format. Mapp erwartet meist + und Ländervorwahl.
Einwilligung
Kontakte werden für die gewählte Gruppe angemeldet. Nutzt die Gruppe in Mapp Double-Opt-in, sendet Mapp eine eigene Bestätigungs-E-Mail, und die Personen werden erst angemeldet, wenn sie bestätigen. Nutzen Sie Nach Einwilligungen filtern (optional), damit nur Personen hinzugefügt werden, die Ihre Marketing-Checkbox angehakt haben.
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 der Kontakt aktualisiert. Jede Zustellung können Sie unter Einstellungen > Integrationen > Zustellstatus prüfen.
Fehlerbehebung
- „All or some of the fields are invalid...“ bei der Installation: Prüfen Sie die API-Adresse und ob der Systembenutzer die API-Rolle hat und nicht gesperrt ist.
- Zustellungen schlagen mit einem Zugriffsfehler fehl: Dem Systembenutzer fehlt eines der Rechte oben.
- Das Passwort ist abgelaufen: In manchen Mapp-Systemen laufen Passwörter ab. Legen Sie in Mapp ein neues Passwort fest und verbinden Sie erneut mit Neues Konto hinzufügen.