Transaktions-Mails versenden
Note
Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Microsoft Dynamics.
Dieses Kapitel beschreibt, wie Sie direkt aus Ihrem Microsoft Dynamics CRM heraus Transaktions-Mails in Optimizely Campaign versenden – mithilfe eines Workflows in Ihrem CRM. Nach dem Versand werden die Response-Daten (Öffnungen und Klicks) automatisch von Optimizely Campaign in Ihr CRM überspielt.
Voraussetzungen
- Konfiguration der Integration vollständig abgeschlossen. Siehe Konfiguration.
- Kampagnen-Mailing in Optimizely Campaign vorbereitet.
- ID des zu versendenden Kampagnen-Mailings. Sie finden die ID in Optimizely Campaign im Bereich Transaktions-Mails. Wählen Sie die Spalte ID rechts in der Drop-down-Liste aus.
- Sie kennen den Authorisierungs-Code der im Transaktions-Mailing verwendeten Empfängerliste.
Transaktions-Mails und Workflows konfigurieren
Bevor Sie über Optimizely Campaign ein Transaktions-Mailing versenden, müssen Sie in Microsoft Dynamics CRM das zu versendende Transaktions-Mailing konfigurieren. Sie können dieses Mailing an Kontakte, Benutzerkonten oder Leads auch ohne Werbeeinverständnis senden. Sie müssen zudem einen Workflow für das zu versendende Transaktions-Mailing definieren.
Transaktions-Mail konfigurieren
- Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Konfigurationen.
- Klicken Sie auf Neu.
- Vergeben Sie einen Namen für die Konfiguration.
- Definieren Sie im Feld Wert die Konfiguration über ein XML-Format.Die Felder <authCode> und <bmMailingId> sind obligatorisch. Tragen Sie im Feld <authCode> den Authorisierungs-Code der Empfängerliste der Transaktions-Mail ein. Tragen Sie im Feld <bmMailingId> die Mailing-ID der Transaktions-Mail ein. Weitere Felder können optional verknüpft werden, soweit die Informationen im CRM vorhanden sind.
<root><authCode>Authorisierungs-Code</authCode><bmMailingId>Mailing-ID</bmMailingId><firstname>object.firstname</firstname><lastname>object.lastname</lastname><salutation>object.salutation</salutation></root>Beim Versand aus einer anderen Entität außer Kontakt, Lead oder Account wird über ein Lookup auf die verbundene bmRecipientId referenziert. Weiterhin werden über Lookups Datenfelder in Kontakt, Lead oder Account eingebunden.
<root><authCode> Authorisierungs-Code </authCode><bmMailingId> Mailing-ID </bmMailingId><bmRecipientId>object.new_exampleentityfor.emailaddress1</bmRecipientId><dynamicsId>object.new_exampleentityfor.contactid</dynamicsId><first_name>object.new_exampleentityfor.firstname</first_name><last_name>object.new_exampleentityfor.lastname</last_name></root>Die Bezeichnung des Lookup-Elements, das zwischen object. und dem Feldnamen (z. B. contactid) eingefügt wird, finden Sie in der Übersicht Fields. Suchen Sie dort nach der Bezeichnung des Feldes, in welchem der Lookup nach Kontakt, Lead oder Account erfolgt. Im Beispiel lautet der Name new_exampleentityfor.
- Klicken Sie auf Speichern und Schließen.
Note
Sie können die Konfiguration im Nachhinein ändern und speichern.
Workflow konfigurieren
- Wählen Sie in Microsoft Dynamics CRM unter Einstellungen > Prozesse.
- Klicken Sie auf Neu.
- Geben Sie unter Prozessname eine Bezeichnung ein.
- Wählen Sie als Kategorie Workflow.
- Unter Entität wählen Sie Kontakt, Lead oder Firma.
- Behalten Sie die Auswahl Diesen Workflow im Hintergrund ausführen bei.
- Wenn Sie keinen vorhandenen Workflow als Vorlage benutzen möchten, wählen Sie als Typ Neuer leerer Prozess.
- Klicken Sie auf OK.
- Wählen Sie unter Aktivieren als, ob der Workflow als Prozess oder als Vorlage angelegt werden soll.
- Wählen Sie im Bereich Zur Ausführung verfügbar die Abhängigkeiten des Prozesses. Setzen Sie zum Beispiel zum manuellen Starten den Haken bei Als bedarfsabhängiger Prozess.
- Wählen Sie im Bereich Beibehaltung von Workflowaufträgen, ob die Aufträge nach Ausführung gelöscht werden können oder nicht.
- Wählen Sie unter Optionen für automatische Prozesse, wer den Prozess starten kann.
- Definieren Sie über die Checkboxen unter Starten bei, durch welche Aktion der Versand der Transaktions-Mail automatisch ausgelöst werden soll. Ist keine Checkbox aktiviert, wird der Versand manuell im CRM gestartet.
- Klicken Sie im unteren Bereich auf Schritt hinzufügen > Episerver Campaign > Send Transaction Mail.
- Klicken Sie auf Eigenschaften festlegen.
- Suchen und wählen Sie in der Spalte Wert die vorher erstellte Konfiguration für das Transaktions-Mailing aus.
- Klicken Sie auf Speichern und schließen.
Rückgabewerte des Prozesses überprüfen
Sie sollten weitere Schritte hinzufügen, die zur Fehlerbehandlung bei falsch versendeten Transaktions-Mails beitragen. Der Versand der Transaktions-Mail erfolgt über die Operation sendtransactionmail der HTTP-API. Nachfolgend ein Beispiel für einen Prozess-Abbruch, wenn der Versand nicht erfolgreich war:
- Klicken Sie in Microsoft Dynamics CRM im Prozess-Fenster auf Schritt hinzufügen > Überprüfungsbedingungen.
- Klicken Sie im neu angefügten Schritt auf <Bedingung> (zum Konfigurieren klicken). Das Fenster Bedingung angeben öffnet sich.
- Klicken Sie auf Auswählen.
- Klicken Sie auf Send Transaction Mail.
- Klicken Sie auf Service Response in der nun angefügten zweiten Drop-down-Liste.
- Klicken Sie auf Beginnt nicht mit in der nun angefügten dritten Drop-down-Liste.
- Klicken Sie auf Wert eingeben und geben Sie den Rückgabewert enqueued ein.
- Klicken Sie auf Speichern und schließen.
- Klicken Sie auf Wählen Sie diese Zeile aus und klicken Sie auf 'Schritt hinzufügen'.
- Klicken Sie auf Schritt hinzufügen > Workflow beenden.
- Wählen Sie in der Status-Drop-down-Liste Abgebrochen.
- Klicken Sie auf Eigenschaften festlegen.
- Klicken Sie in das freie Feld der Spalte Wert.
- Wählen Sie rechts in der Drop-down-Liste Suchen nach > Send Transaction Mail.
- Wählen Sie in der darunterliegenden Drop-down-Liste Service Response.
- Klicken Sie auf Hinzufügen.
- Klicken Sie auf OK.
- Klicken Sie auf Speichern und schließen.
- Klicken Sie im Prozess-Fenster in der oberen Leiste auf In einen Echtzeitworkflow konvertieren.
- Klicken Sie auf Aktivieren und klicken Sie im Dialogfeld Bestätigung der Aktivierung von 'Prozess' auf Aktivieren.
- Klicken Sie im Prozess-Fenster auf Schließen.
Transaktions-Mails versenden
Der Workflow ist jetzt vollständig angelegt, aktiviert und wird je nach vorkonfigurierter Aktion gestartet oder kann manuell ausgelöst werden. Der manuelle Start eines Transaktions-Mailings erfolgt aus der im Prozess angegebenen Entität.
- Wählen Sie in der Entität Workflow ausführen.
- Das Dialogfeld Suchdatensatz öffnet sich. Wählen Sie den Workflow des zu versendeten Transaktions-Mailing und klicken Sie auf Hinzufügen.
- Das Dialogfeld Anwendung des Workflows bestätigen öffnet sich. Klicken Sie auf OK.