Konfiguration

  • Aktualisiert

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:

  1. SOAP-API-Benutzerdaten eingeben.
  2. Mandanten-IDs eingeben.
  3. Response-Daten-Workflows starten.
  4. Optimizely Campaign Testlisten zuweisen
  5. Werbeeinverständnisse erstellen und mit den Mandanten 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. 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

  1. Melden Sie sich in Microsoft Dynamics mit Administrator-Rechten an.
  2. Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > API-Daten.

    Die Integration fügt Ihren CRM-Einstellungen den Bereich Episerver Campaign hinzu.

    Bild: API-Daten

  3. Klicken Sie auf Neu.
  4. Geben Sie unter API-Benutzer Ihren SOAP-API-Benutzernamen ein.

    Bild: API-Benutzer

  5. Geben Sie unter API-Passwort Ihr SOAP-API-Passwort ein.

    Bild: API-Passwort

  6. Klicken Sie auf Speichern und Schließen.

Mandanten-IDs eingeben

Um Kampagnen zu versenden, müssen Sie in Ihrem Microsoft Dynamics CRM angeben, über welche Optimizely Campaign Mandanten diese versendet werden sollen.

  1. Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Mandanten.

    Bild: Mandanten

  2. Klicken Sie auf Neu.
  3. Geben Sie unter Mandanten-ID die ID des Mandanten ein, über den Sie Kampagnen versenden möchten.

    Bild: Mandanten-ID

    Sie finden die Mandanten-ID im Optimizely Campaign Menü unter API-Übersicht > REST API.

  4. Geben Sie unter Beschreibung den Namen des Mandanten ein.

    Bild: Beschreibung

    Der Name des Mandanten wird Ihnen in Optimizely Campaign rechts oben in der Menüleiste angezeigt.

  5. Wählen Sie unter API Benutzer Ihren SOAP-API-Benutzer aus. Siehe SOAP-API-Benutzerdaten hinterlegen.

    Bild: API Benutzer

  6. 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:

  1. 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.

    Bild: Mandanten

  2. Klicken Sie auf Workflow ausführen.

    Bild: Workflow ausführen

  3. Markieren Sie einen Workflow und klicken Sie auf Hinzufügen.

    Bild: Workflow hinzufügen

  4. Klicken Sie auf OK.
  5. 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:

  1. Wählen Sie Einstellungen > Mandanten.
  2. Klicken Sie auf Mandant.
  3. Klicken Sie auf Fügen Sie den Datensatz Testliste hinzu..

    Bild: Testliste hinzufügen

  4. Geben Sie einen Namen für die Testliste ein.

    Bild: Testlisten-Name

  5. 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.

    Bild: Testlisten-ID

  6. Klicken Sie auf Speichern und schließen Sie das Fenster.

    Bild: Speichern

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:

  1. Bounce-Status-Feld erstellen
  2. Bounce-Status-Feld zum Formular hinzufügen
  3. Werbeeinverständnis erstellen und Bounce-Status-Feld zuweisen

Bounce-Status-Feld erstellen

  1. Melden Sie sich in Microsoft Dynamics CRM mit Administratorrechten an.
  2. Wählen Sie unter Einstellungen > Anpassungen.

    Bild: Anpassungen

  3. Klicken Sie auf System anpassen.

    Bild: System anpassen

  4. Wählen Sie in der linken Seitennavigation Komponenten > Entitäten > Kontakt oder Lead oder Firma > Felder.

    Bild: Felder

  5. Klicken Sie auf Neu.

    Bild: Neues Feld

  6. Definieren Sie die folgenden Felder:

    Bild: Felder definieren

      • 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.

    Bild: Feld "Name"

      • 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.

    Bild: Datentyp

    • Feldtyp. Wählen Sie Einfach.
  7. Klicken Sie auf Speichern und schließen.

    Bild: Speichern und schließen

Bounce-Status-Feld zum Formular hinzufügen

  1. Wählen Sie in der linken Seitennavigation Komponenten > Entitäten > Kontakt oder Lead oder Firma > Formulare.

    Bild: Formulare

  2. Klicken Sie auf das Formular, dem Sie das Bounce-Status-Feld hinzufügen möchten.

    Bild: Feld auswählen

  3. 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.

    Bild: Bereich auswählen

  4. Ö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.

    Bild: Feld-Explorer

  5. Doppelklicken Sie auf das Feld, um es dem markierten Bereich hinzuzufügen.

    Bild: Feld hinzufügen

  6. Klicken Sie auf Speichern.
  7. Klicken Sie auf Publizieren.

Werbeeinverständnis erstellen und Bounce-Status-Feld zuweisen

  1. Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Werbeeinverständnisse.

    Bild: Werbeeinverständnisse

  2. Klicken Sie auf Neu.

    Bild: Neues Werbeeinverständnis

  3. 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.

    Bild: Opt-In-ID

  4. Optional: Geben Sie unter Beschreibung eine Beschreibung für das Werbeeinverständnis ein.
  5. Wählen Sie unter Typ den Kommunikationskanal (E-Mail, Print oder SMS) aus, für den das Werbeeinverständnis gilt.

    Bild: Typ

  6. Wählen Sie unter Entität den Kunden-Typ aus (Kontakt, Lead oder Firma), für den das Werbeeinverständnis genutzt wird.

    Bild: Entität

  7. Geben Sie unter Referenzfeld Bounces den Feldnamen ein. Das ist der Name, dem das Präfix new_ beim Anlegen des Feldes automatisch vorangestellt wurde.

    Bild: Referenzfeld Bounces

  8. 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.

    Bild: Mandanten auswählen

  9. Klicken Sie auf Speichern und schließen. Das neue Werbeeinverständnis erscheint in der Übersicht.

    Bild: Neu angelegtes Werbeeinverständnis

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.

Bild: 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.

Bild: Zugeordnete Ansicht: Opt-In-Historie

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 Prozess in Optimizely Campaign zu verknüpfen, führen Sie folgende Schritte aus:

  1. Wählen Sie im Bereich Opt-In im Feld Synchronisiere Double Opt-In die Option Ja.

    Bild: Feld: Synchronisiere Double Opt-In

  2. 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.

    Bild: Feld: Opt-In Empfängerlisten-ID

  3. 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.

    Bild: Feld: Opt-In Prozess-ID

  4. 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 <root> muss hier <episerver> heißen.

    Bild: Feld: Konfiguration DOI

  5. Klicken Sie auf Speichern und Schließen.

    Bild: 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:

  1. Öffnen Sie in Microsoft Dynamics die Einstellungen und rufen Sie unter Anpassung den Menüpunkt Anpassungen auf.
  2. Klicken Sie auf System anpassen.
  3. Wählen Sie links in der Seitennavigation Komponenten > Entitäten > Kampagnenaktivität > Formulare.

    Bild: Formulare auswählen

  4. Öffnen Sie das Formular Kampagnenaktivität, indem Sie in der Liste auf Kampagnenaktivität klicken.
  5. 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.

    Bild: Filter für benutzerdefinierte Felder

  6. Ziehen Sie die 13 Felder in den Bereich Episerver Campaign in der Strukturansicht des Formulars.

    Bild: Felder hinzufügen

  7. 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

  1. Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Zuordnungen.

    Bild: Zuordnungen

  2. Klicken Sie auf Neu.
  3. Wählen Sie unter Entität den Typ Kontakt aus.

    Bild: Entität auswählen

  4. Geben Sie im Feld Zuordnen von den Namen des Feldes in Ihrem CRM ein.
  5. 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.

    Bild: Feld zuordnen

  6. Klicken Sie auf Speichern.
  7. 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.

  1. Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Zuordnungen.
  2. Klicken Sie auf Neu.
  3. Wählen Sie unter EntitätKontakt aus.
  4. Geben Sie im Feld Zuordnen von den Namen des CRM-Feldes ein.

    Bild: Zuordnen (Quelle)

  5. Wählen Sie unter Zuordnen zu die Option Benutzerdefiniert aus.

    Bild: Zuordnen (Ziel)

  6. Geben Sie unter Feld den Namen des zusätzlich beauftragten Empfängerlistenfeldes ein.

    Bild: Empfängerlistenfeld auswählen

  7. 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.

    Bild: Positionsnummer eingeben

  8. 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.

    Bild: Sprache einstellen

  9. Klicken Sie auf Speichern.
  10. Wiederholen Sie die Schritte 2–10 für den Typ Lead (wählen Sie bei 4. entsprechend Lead unter Entität aus).