HubEngine Adapter: Evalanche Send Mailing

In diesem Tutorial zeigen wir dir, wie Trigger-Mailings in Evalanche über den API-Endpunkt Send Mailing ausgelöst werden. Wir nutzen als Beispiel die Integration der DataEngine mit Evalanche. Es können jedoch auch weitere Systeme, wie beispielsweise SAP C4C, MS Dynamics oder Salesforce, über die HubEngine angebunden werden (Liste aller Systeme).

Schematische Darstellung:

Evalanche Trigger Mailing - Diagram
The endpoint "Contacts" of the DataEngine is bidirectionally synchronized with the API endpoint "Send Mailing" of Evalanche to trigger Mailings from the DataEngine via the HubEngine.

Bevor wir loslegen, werfen wir noch einen kurzen Blick auf die Möglichkeiten, die uns Evalanche für den Versand von Mailings bietet. Es stehen drei Mailing-Typen zur Verfügung.

  1. Newsletter werden per Hand versendet.
  2. Event-Mailings werden zeitgesteuert versendet.
  3. Trigger-Mailings werden über ein Formular oder über die API ausgelöst.

In Marketing-Automation-Prozessen sind die Event-Mailings und die Trigger-Mailings im Einsatz. Die Event-Mailings werden in Evalanche jedoch nur alle 15 Minuten ausgelöst. Für einen Interessenten, der beispielsweise etwas im Webshop bestellt hat oder auf die Bestätigung seiner Webinar-Registrierung wartet, ist das zu lang. Insbesondere Transaktions-Mails müssen schnell versendet werden. Der Endpunkt „Send Mailing“ des Evalanche Adapters ermöglicht uns genau das: Den Versand von individualisierten Mailings ohne Verzögerung.

Los geht’s.

Anleitung

1. Auswahl des HubEngine-Plans

In diesem Anwendungsfall werden die Systeme DataEngine und Evalanche eingesetzt.

Evalanche Trigger Mailing - Choose Plan
Choose the DataEngine and Evalanche in the plan search.

2. Auswahl des API-Endpunkts Send Mailing

  • DataEngine Adapter: Der jeweils gewünschte Endpunkt, an dem die Änderung erfasst wird. Im Beispiel einer Profiländerung eines Kontaktes also der Endpunkt „Contacts“
  • Evalanche Adapter: Send Mailing
Evalanche Trigger Mailing - Select Endpoints
Select the respective endpoints "contacts" and "send mailing".

3. Eingabe der Zugangsdaten

    •  DataEngine
      • Client ID
      • Client Secret
      • URL der DataEngine
    • Evalanche
      • Hostname (bspw. scnem.com, scnem2.com)
      • Benutzername
      • Passwort

4. Auswahl der Identifier

  • DataEngine
    • Identifier Field: id
    • Update Field: date_modified
  • Evalanche – Send Mailing
    • Identifier Field: ID
    • Update Field: keine Auswahl
Evalanche Trigger Mailing - Set Identifier
Set the primary identifiers of the DataEngine and Evalanche.

5. Trigger einrichten

Über die HubEngine-Trigger wird die Synchronisation ausgelößt.

Da wir hier schnell sein wollen, müssen wir den Webhook nutzen. Die Trigger-URL kannst du dann in der DataEngine über einen Workflow aktivieren. So kann beispielsweise bei einer Profiländerung die Synchronisation in Echtzeit ausgelößt werden.

Wenn das System, das du anbindest, keinen Aufruf der Trigger-URL unterstützt, kannst du alternativ die Zeitsteuerung (Frequenz) nutzen. Die kleinste Einheit der Taktung liegt bei einer Minute.

Tipp: Zum Testen des Plans empfiehlt sich zusätzlich der manuelle Trigger.

Evalanche Trigger Mailing - Set Plan Trigger
You can choose a manual, scheduled or webhook trigger to trigger your mailings. Optimally you choose webhook since it is fastest.

6. Mapping und Actions einrichten

Mapping: Es muss die in der DataEngine hinterlegte Evalanche-ID mit dem Feld Profile-ID gemappt werden

Evalanche Trigger Mailing - Create Connections
Create the necessary connections.

Action: In der Action wird die Mailing-ID des Mailings ausgewählt, welches durch den Plan versendet werden soll.

In den Bedingungen wird festgelegt, unter welcher Voraussetzung das Mailing versendet werden soll. Im Beispiel-Case also nur, wenn ein bestimmtes Attribut im jeweiligen Kontakt gesetzt ist, z.B. eine bestimmte Bestellung angelegt wurde oder eine bestimmte Information geändert wurde.

Evalanche Trigger Mailing - Set Actions
The action is configured to set the field MAILING_ID equal to 25240886.