Konfiguration

Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Microsoft Dynamics.

Dieses Kapitel beschreibt die Konfiguration der Microsoft-Dynamics-CRM-Integration, wenn Sie diese mit Optimizely Campaign verwenden.

Die Konfiguration besteht aus den folgenden Schritten:

SOAP-API-Benutzerdaten eingeben.
Mandanten-IDs eingeben.
Response-Daten-Workflows starten.
Optimizely Campaign Testlisten zuweisen
Werbeeinverständnisse erstellen und mit den Mandanten Arbeitsumgebung von Optimizely Campaign. Ein Mandant ist ein eigenständiges und in sich geschlossenes System zur Organisation Ihrer Mailings. Sie können einen oder mehrere Mandanten verwenden. verbinden.

Um Felder zu übertragen, die nicht in der Standardkonfiguration enthalten sind, müssen Sie zudem die zusätzlichen Felder für Ihre Optimizely Campaign Empfängerliste konfigurieren.

SOAP-API-Benutzerdaten eingeben

Die Kommunikation und der Datenaustausch zwischen Microsoft Dynamics und Optimizely Campaign erfolgt gesichert über die SOAP-API Steht für „Application Programming Interface“, auch Programmierschnittstelle. Die API gibt an, wie Softwarekomponenten miteinander interagieren sollen, z. B. wenn auf Datenbanken oder Computerhardware zugegriffen wird. Sie vereinfacht außerdem die Programmierung von grafischen Benutzeroberflächen. APIs haben oft die Form von Bibliotheken mit Angaben zu Routinen, Datenstrukturen, Objektklassen und Variablen.. Um Ihr CRM mit Optimizely Campaign über die Schnittstelle zu verbinden, müssen Sie Ihre SOAP-API-Benutzerdaten in Microsoft Dynamics eingeben.

Falls Sie kein SOAP-API-Benutzerkonto besitzen, wenden Sie sich an die Kundenbetreuung

Melden Sie sich in Microsoft Dynamics mit Administrator-Rechten an.
Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > API-Daten.
Die Integration fügt Ihren CRM-Einstellungen den Bereich Episerver Campaign hinzu.
Klicken Sie auf Neu.
Geben Sie unter API-Benutzer Ihren SOAP-API-Benutzernamen ein.
Geben Sie unter API-Passwort Ihr SOAP-API-Passwort ein.
Klicken Sie auf Speichern und Schließen.

Mandanten-IDs eingeben

Um Kampagnen Eine Kampagne in Smart Campaigns oder in einer Marketing Automation. Beinhaltet den kompletten Kampagnen-Bauplan mitsamt aller darin enthaltenen Elemente, Knoten und Abzweigungen sowie deren Beziehungen zueinander. zu versenden, müssen Sie in Ihrem Microsoft Dynamics CRM angeben, über welche Optimizely Campaign Mandanten diese versendet werden sollen.

Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Mandanten.
Klicken Sie auf Neu.
Geben Sie unter Mandanten-ID die ID des Mandanten ein, über den Sie Kampagnen versenden möchten.
Sie finden die Mandanten-ID im Optimizely Campaign Menü unter API-Übersicht > REST API.
Geben Sie unter Beschreibung den Namen des Mandanten ein.
Der Name des Mandanten wird Ihnen in Optimizely Campaign rechts oben in der Menüleiste angezeigt.
Wählen Sie unter API Benutzer Ihren SOAP-API-Benutzer aus. Siehe SOAP-API-Benutzerdaten hinterlegen.
Klicken Sie auf Speichern und Schließen. Um weitere Mandanten hinzuzufügen, wiederholen Sie die Schritte für jeden weiteren Mandanten

Response-Daten-Workflows starten

Um nach dem Kampagnen-Versand die Response-Daten Ihrer Kontakte und Leads von Optimizely Campaign ins CRM zu übertragen, müssen Sie die Response-Daten-Workflows für die einzelnen Mandanten starten. Mit den Workflows werden die Response-Daten Ihrer Empfänger in 60-minütigen Intervallen abgefragt und in Ihr Microsoft Dynamics CRM importiert.

Folgende Workflows stehen für die einzelnen Response-Typen zur Verfügung:

Workflow	Response-Typ
Optimizely: Get opens	Öffnung des Mailings
Optimizely: Get clicks	Klick auf einen Link im Mailing
Optimizely: Get responses	direkte Antwort auf das Mailing
Optimizely: Get unsubscribes	Abbestellung des Newsletters
Optimizely: Get outbounces	Outbounce (der Empfänger hat das Bounce-Limit überschritten)

Um die Workflows zu starten, führen Sie die folgenden Schritte aus:

Markieren Sie den Mandanten, für den Sie die Workflows starten möchten. Falls das Fenster mit der Mandanten-Liste nicht geöffnet sein sollte, wählen Sie Einstellungen > Mandanten.
Klicken Sie auf Workflow ausführen.
Markieren Sie einen Workflow und klicken Sie auf Hinzufügen.
Klicken Sie auf OK.
Wiederholen Sie nacheinander für jeden einzelnen Workflow die Schritte 1–4.

Die Aktivität der Workflows können Sie in der Informationen-Ansicht der Mandanten einsehen. Um diese zu öffnen, klicken Sie in der Mandantenliste auf die entsprechende Mandanten-ID. In dem sich öffnenden Fenster, unterhalb der Zugangsdaten, finden Sie die Zeitpunkte der letzten Ausführung und die Zeitstempel der zuletzt importierten Daten.

Optimizely Campaign Testlisten zuweisen

Um die Mailings Ihrer Kampagnen vorab zu überprüfen, können Sie diese an eine Optimizely Campaign Testliste senden. Sie müssen dafür die Optimizely Campaign Testliste in Microsoft Dynamics CRM zuweisen. Gehen Sie wie folgt vor:

Wählen Sie Einstellungen > Mandanten.
Klicken Sie auf Mandant.
Klicken Sie auf Fügen Sie den Datensatz Testliste hinzu..
Geben Sie einen Namen für die Testliste ein.
Geben Sie die Empfängerlisten-ID der Testliste ein. Die Empfängerlisten-ID finden Sie im Optimizely Campaign Menü unter Verwaltung > API-Übersicht > Empfängerlisten.
Sollte die ID-Spalte fehlen, klicken Sie oben rechts im Tabellenkopf auf den Pfeil nach unten v und aktivieren Sie das Kontrollkästchen ID.
Klicken Sie auf Speichern und schließen Sie das Fenster.

Um weitere Testlisten zuzuweisen, wiederholen Sie die Schritte für jede weitere Testliste.

Werbeeinverständnisse anlegen und mit Mandanten verbinden

Sie benötigen stets die Einwilligung Ihrer Kontakte und Leads, Ihnen Mailings zusenden zu dürfen. Siehe Opt-In. Die Integration prüft für jeden einzelnen Kontakt beziehungsweise Lead, ob ein Werbeeinverständnis gegeben beziehungsweise zurückgezogen wurde und überträgt keine Empfänger, von denen Sie kein Werbeeinverständnis haben.

Zusätzlich müssen Sie den Bounce-Status für den Kontakt, Lead oder Firmen erfassen, der eine Aussage über die Funktionsfähigkeit des Werbeeinverständnis trifft.

Gehen Sie wie folgt vor:

Bounce-Status-Feld erstellen
Bounce-Status-Feld zum Formular hinzufügen
Werbeeinverständnis erstellen und Bounce-Status-Feld zuweisen

Bounce-Status-Feld erstellen

Melden Sie sich in Microsoft Dynamics CRM mit Administratorrechten an.
Wählen Sie unter Einstellungen > Anpassungen.
Klicken Sie auf System anpassen.
Wählen Sie in der linken Seitennavigation Komponenten > Entitäten > Kontakt oder Lead oder Firma > Felder.
Klicken Sie auf Neu.
Definieren Sie die folgenden Felder:
- Anzeigename. Geben Sie einen aussagekräftigen Namen ein, z. B. EpiOutbounce E-Mail.
- Name. Klicken Sie in ein beliebiges anderes Feld. Ihr Eintrag wird im Feld Name automatisch übernommen (gekürzt um Leerzeichen und Sonderzeichen) und das Präfix new_ vorangestellt. Ändern Sie den automatisch erzeugten Eintrag im Feld Name, zum Beispiel in new_epioutbounceemail. Verwenden Sie keine Leerzeichen oder Sonderzeichen.
- Feldanforderung. Wählen Sie Optional.
- Durchsuchbar. Wählen Sie Ja.
- Feldsicherheit. Wählen Sie Deaktivieren.
- Überwachung. Wählen Sie Aktivieren.
- Beschreibung. Optional: Geben Sie eine Feldbeschreibung ein.
- Datentyp. Wählen Sie Zwei Optionen. Ein Feld mit den Optionen Nein und Ja wird eingeblendet.
- Feldtyp. Wählen Sie Einfach.
Klicken Sie auf Speichern und schließen.

Bounce-Status-Feld zum Formular hinzufügen

Wählen Sie in der linken Seitennavigation Komponenten > Entitäten > Kontakt oder Lead oder Firma > Formulare.
Klicken Sie auf das Formular, dem Sie das Bounce-Status-Feld hinzufügen möchten.
Klicken Sie in den Bereich, in dem das Feld angezeigt werden soll, z. B. Marketing. Wenn der Bereich markiert ist, ändert sich die Umrandung des Bereichs von einer gestrichelten zu einer durchgezogenen Linie.
Öffnen Sie rechts den Feld-Explorer und suchen Sie in der Liste das von Ihnen erstellte Bounce-Status-Feld.
Verwenden Sie die Filteroptionen, um die Anzahl der angezeigten Felder zu begrenzen.
Doppelklicken Sie auf das Feld, um es dem markierten Bereich hinzuzufügen.
Klicken Sie auf Speichern.
Klicken Sie auf Publizieren.

Werbeeinverständnis erstellen und Bounce-Status-Feld zuweisen

Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Werbeeinverständnisse.
Klicken Sie auf Neu.
Vergeben Sie unter Opt-In-ID eine eindeutige Kennung. Verwenden Sie keine Umlaute und Sonderzeichen. Die Opt-In-ID sollte aussagekräftig sein, zum Beispiel OptinProduktnewsletterEmailKontakt. Die Opt-In-ID wird später unter anderem bei der Auswahl des Werbeeinverständnisses beim Versand einer Kampagnenaktivität angezeigt.
Optional: Geben Sie unter Beschreibung eine Beschreibung für das Werbeeinverständnis ein.
Wählen Sie unter Typ den Kommunikationskanal (E-Mail, Print oder SMS) aus, für den das Werbeeinverständnis gilt.
Wählen Sie unter Entität den Kunden-Typ aus (Kontakt, Lead oder Firma), für den das Werbeeinverständnis genutzt wird.
Geben Sie unter Referenzfeld Bounces den Feldnamen ein. Das ist der Name, dem das Präfix new_ beim Anlegen des Feldes automatisch vorangestellt wurde.
Wählen Sie unter Episerver Campaign Mandant den Mandanten aus, über den der Versand für dieses Werbeeinverständnis erfolgen soll, indem Sie auf das Lupensymbol klicken.
Sie können die Zuordnung eines Mandanten zu einem Werbeeinverständnis nicht nachträglich ändern.
Klicken Sie auf Speichern und schließen. Das neue Werbeeinverständnis erscheint in der Übersicht.

Wenn Sie weitere Werbeeinverständnisse des gleichen Kanals erstellen möchten, wiederholen Sie die Schritte 1–9. Greifen Sie dabei für alle weiteren Werbeeinverständnisse auf das eine, bereits erstellte Bounce-Status-Feld zurück. Dieses gilt stets für einen gesamten Kanal, z. B. für den gesamten Kanal E-Mail.

Sie haben erfolgreich ein Werbeeinverständnis angelegt. Unabhängig davon, ob die Werbeeinverständnisse durch einen Opt-In-Prozess in Optimizely Campaign oder aus einer anderen Quelle eingeholt werden, finden Sie die Zuordnung der Werbeeinverständnisse zu den einzelnen Kontakten, Leads oder Firmen unter dem Menüpunkt Opt-In-Historien.

In der Übersicht Zugeordnete Ansicht: Opt-In-Historie sehen Sie die akzeptierten Werbeeinverständnisse. Wird das Werbeeinverständnis wieder entzogen, kann der Eintrag gelöscht werden oder es wird anhand der Unsubscribe-Response-Daten ein Eintrag vom Typ Opt-out erstellt. In diesem Fall erkennt das CRM anhand des Zeitstempels den aktuellen Status für das entzogene Werbeeinverständnis. In beiden Fällen werden mit diesem Datensatz keine Mailings mehr versendet, die das entsprechende Werbeeinverständnis erfordern.

Werbeeinverständnis mit einem Optimizely Campaign Opt-In-Prozess verbinden

Auf der Konfigurationsseite des Werbeeinverständnisses finden Sie einen weiteren Bereich Opt-In, in dem Sie das angelegte Werbeeinverständnis mit einem Opt-In-Prozess in Optimizely Campaign verknüpfen können. Dadurch können Sie Opt-In-Mailings mit einem Bestätigungslink über Optimizely Campaign versenden.

Voraussetzungen:

Sie haben die Konfiguration der Integration, inklusive eines Werbeeinverständnisses, abgeschlossen.
Sie haben in Optimizely Campaign einen Opt-In-Prozess angelegt. Sie benötigen die ID des Opt-In-Prozesses sowie die ID der im Prozess verwendeten Opt-In-Empfängerliste.

Um das Werbeeinverständnis mit einem Double Opt-In Verfahren, bei dem der Empfänger vor dem Erhalt von Werbe-Mailings seine Einwilligung zum Empfang von E-Mails gibt. Der Empfänger erhält daraufhin eine E-Mail mit Double-Opt-In-Link, den er als Bestätigung klicken muss. Prozess in Optimizely Campaign zu verknüpfen, führen Sie folgende Schritte aus:

Wählen Sie im Bereich Opt-In im Feld Synchronisiere Double Opt-In die Option Ja.
Tragen Sie im Feld Opt-In Empfängerlisten-ID die ID der im Opt-In-Prozess verwendeten Empfängerliste ein. Die Empfängerlisten-ID finden Sie im Optimizely Campaign Menü unter Verwaltung > API-Übersicht > Empfängerlisten.
Tragen Sie im Feld Opt-In Prozess-ID die ID des Opt-In Prozesses aus Optimizely Campaignein. Die Opt-In-ID finden Sie im Optimizely Campaign Menü unter Verwaltung > API-Übersicht > Opt-In-Prozesse.
Optional: Im Feld Konfiguration DOI tragen Sie eine XML-Konfiguration ein, in der Informationen aus den Kontaktfeldern den Empfängerlistenfeldern in der Opt-In-Empfängerliste zuordnet werden.
Der Eintrag in <optinsource> ist frei konfigurierbar. Der Knoten Element, das festlegt, wann ein Empfänger eine Kampagne durchläuft und welchen Weg er dabei einschlägt. Sie können Knoten miteinander verbinden und so den Ablauf Ihrer Kampagne bestimmen. Der Pfeil am Ende jeder Verbindung zeigt jeweils auf den Nachfolgeknoten und die damit verbundene Aktion.<root> muss hier <episerver> heißen.
Klicken Sie auf Speichern und Schließen.

Sie haben erfolgreich ein Werbeeinverständnis im CRM mit einem Opt-In-Prozess in Optimizely Campaign verbunden. Über die Schaltfläche Opt-In Mail versenden in der jeweiligen Entität können Sie den Versand eines Opt-In-Mailings über Optimizely Campaign auslösen.

Formular für die Kampagnenaktivität anpassen

Passen Sie zum Abschluss der Konfiguration das Formular für die Kampagnenaktivität an und fügen Sie die 13 Felder der Microsoft-Dynamics-Integration hinzu. In der Regel werden die 13 Felder bereits mit der Installation der Integration dem Formular für die Kampagnenaktivität hinzugefügt. Je nach Ihrer individuellen CRM-Konfiguration kann dieser Schritt jedoch bei der Installation übersprungen worden sein.

Die Integration hat folgende Felder:

Nr.	Feldname
1	Empfänger an Optimizely Campaign übermittelt
2	Erfolgreich versendet
3	Erzeugte Empfängerpakete
4	Mailing-Beschreibung
5	Mailing-ID
6	Mailing-ID aus Welle-ID
7	Mailing-Name
8	Mailing-Status
9	Optimizely Campaign Mandant
10	Versendete Empfängerpakete
11	Vorbereitete Empfänger
12	Welle-ID
13	Werbeeinverständnis

Führen Sie die folgenden Schritte aus:

Öffnen Sie in Microsoft Dynamics die Einstellungen und rufen Sie unter Anpassung den Menüpunkt Anpassungen auf.
Klicken Sie auf System anpassen.
Wählen Sie links in der Seitennavigation Komponenten > Entitäten > Kampagnenaktivität > Formulare.
Öffnen Sie das Formular Kampagnenaktivität, indem Sie in der Liste auf Kampagnenaktivität klicken.
Wählen Sie im Feldexplorer aus der Drop-down-Liste Filter die Option Benutzerdefinierte Felder aus und entfernen Sie den Haken aus dem Kontrollkästchen Nur unbenutzte Felder anzeigen. Ihnen werden die 13 Felder der Microsoft-Dynamics-Integration angezeigt.
Ziehen Sie die 13 Felder in den Bereich Episerver Campaign in der Strukturansicht des Formulars.
Klicken Sie auf Speichern und schließen.

Datenfeldern übertragen

Bei der Übertragung von Datenfeldern vom CRM zu Optimizely Campaign wird zwischen standardmäßig übertragenen Feldern und zusätzlichen optionalen Feldern unterschieden, welche für die Übertragung konfiguriert werden müssen.

Die Integration übermittelt alle Werte als String, unabhängig davon, welcher Datentyp im CRM angelegt ist.

Standardmäßig übertragene Datenfelder

In den Standardeinstellungen überträgt die Integration folgende Daten aus Microsoft Dynamics an Optimizely Campaign:

Feldname	Datentyp	Beschreibung
entityType	String	Angabe, ob es sich um einen Lead oder Kontakt handelt
salutation	String	Anrede
firstname	String	Vorname
lastname	String	Nachname
fullname	String	Vor- und Zuname
mobile	String	Mobilnummer (notwendig für SMS-Kampagnen)
email	String	E-Mail (notwendig für E-Mail-Kampagnen)
street	String	Straße
city	String	Stadt
state	String	Bundesland/Staat
zip	String	Postleitzahl
country	String	Land

Zusätzliche Felder für die Empfängerliste konfigurieren

Die Konfiguration von zusätzlichen Feldern gilt sowohl für die Kampagnensteuerung als auch die Synchronisierung der Empfängerlisten über alle Werbeeinverständnisse (Mandanten) hinweg. Beachten Sie dies bei Ihrer Planung, um kostenintensive Rekonfigurationen und Nacharbeiten zu vermeiden. Die Konfigurationen der Felder müssen für Leads und Kontakte identisch sein. Wenn Sie Änderungen lediglich an einem Typen vornehmen, schlägt der Versand des anderen fehl.

Für die individuelle Konfiguration Ihrer Empfängerliste stehen zwei Möglichkeiten zur Verfügung:

Sie remappen ein individuelles CRM-Feld und schreiben es in ein bereits vorhandenes Standard-Feld Ihrer Empfängerliste.
Sie übertragen das individuelle CRM-Feld in ein zusätzliches Feld Ihrer Empfängerliste, das nicht in der Standard-Konfiguration enthalten ist.

CRM-Felder remappen

Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Zuordnungen.
Klicken Sie auf Neu.
Wählen Sie unter Entität den Typ Kontakt aus.
Geben Sie im Feld Zuordnen von den Namen des Feldes in Ihrem CRM ein.
Wählen Sie unter Zuordnen zu das Standard-Feld der Empfängerliste aus, in das der Wert des CRM-Feldes geschrieben werden soll. Wenn Sie z. B. das Feld new_custom_country erstellt haben, können Sie den enthaltenen Wert in das Feld Land der Empfängerliste übertragen. Das standardmäßig definierte CRM-Feld country wird nicht mehr an Optimizely Campaign übertragen.
Klicken Sie auf Speichern.
Wiederholen Sie die Schritte 1–6 für den Typ Lead (wählen Sie bei 3. entsprechend Lead unter Entität aus).

CRM-Felder übertragen

Sie müssen die Erweiterung Ihrer Empfängerliste bei der Kundenbetreuung im Vorfeld beauftragen. Wenn Sie neue Felder beauftragen, nummerieren Sie die Felder von 1 an aufsteigend durch. Notieren Sie sich die gewählte Nummerierung und die Feldnamen dauerhaft und verändern Sie diese nicht. Sie benötigen die Informationen zur Konfiguration.

Wenn die Felder hinzugefügt sind, führen Sie die folgenden Schritte aus.

Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Zuordnungen.
Klicken Sie auf Neu.
Wählen Sie unter Entität > Kontakt aus.
Geben Sie im Feld Zuordnen von den Namen des CRM-Feldes ein.
Wählen Sie unter Zuordnen zu die Option Benutzerdefiniert aus.
Geben Sie unter Feld den Namen des zusätzlich beauftragten Empfängerlistenfeldes ein.
Geben Sie unter Position die Positionsnummer des zusätzlichen Empfängerlistenfeldes ein. Die Positionsnummern orientieren sich an der Reihenfolge der zusätzlich beauftragten Empfängerlistenfelder.
Falls das Feld Map From vom Typ OptionSet ist, wählen Sie unter OptionSet-Sprache die Sprache aus, die für die Übertragung der Werte gewählt werden soll.
Klicken Sie auf Speichern.
Wiederholen Sie die Schritte 2–10 für den Typ Lead (wählen Sie bei 4. entsprechend Lead unter Entität aus).