Emarsys

Durch die Anbindung von PAQATO an Emarsys nutzt du dein gewohntes Customer Engagement Tool, um hochgradig personalisierte Post Purchase E-Mails über das Emarsys Automation Center zu versenden. Dies sichert ein konsistentes Markenerlebnis und bündelt deine Kommunikation an einem zentralen Ort.

1. Voraussetzungen in Emarsys

Bevor du mit der Einrichtung startest, stelle sicher, dass in deinem Emarsys-Account folgendes vorbereitet ist:

API-User: Ein Benutzerprofil mit API-Zugriffsrechten.
Berechtigungen: Der User muss die Berechtigung besitzen, externe Ereignisse (External Events) auszulösen.
Zugangsdaten: Halte den Username, das Secret und die key_id bereit.

2. Einrichtung

Add-on aktivieren: Navigiere in der PAQATO WebApp zum Bereich Integrationen. Falls das Add-on "Emarsys" noch nicht aktiv ist, kannst du es dort hinzufügen und buchen.
Konfiguration starten: Klicke auf Integration starten.
Authentifizierung: Hinterlege deine Emarsys-Zugangsdaten: Username, Secret, Key-ID.
Shop-Auswahl: Wähle die Shops aus, für welche die Emarsys-Integration aktiviert werden soll. Und klicke auf Speicher.

Ereignis-Auswahl: Wähle aus der Liste der verfügbaren Versandereignisse diejenigen aus, die zukünftig in Emarsys ausgelöst werden sollen (z. B. "Versandbestätigung", "Paket versendet", "In Zustellung").
Mapping in Emarsys: Erstelle für jedes gewählte Ereignis ein entsprechendes externes Ereignis in Emarsys (siehe Abschnitt 5: Einrichtung in Emarsys).
Finalisierung: Nach erfolgreicher Speicherung wird sich ein PAQATO-Mitarbeiter bei dir melden. Übermittle ihm die in Emarsys generierten Event-IDs, damit das Mapping intern finalisiert werden kann.
- Beispiel: Wenn du in Emarsys das Ereignis „Im Zustellfahrzeug“ anlegst, generiert das System eine eindeutige ID. PAQATO verknüpft diese ID mit dem internen Status, sodass die Nachricht zum exakt richtigen Zeitpunkt getriggert wird.

3. Funktionsweise

PAQATO triggert bei Statusänderungen ein External Event in Emarsys. Dabei wird ein umfassender Datensatz (Payload) übergeben, der alle Informationen zur Bestellung, zum Paket und zum aktuellen Lieferstatus enthält.

4. Der Daten-Payload (Variablen)

Unser Payload ist bewusst redundant (doppelt) aufgebaut. Das bedeutet, dass viele Informationen in verschiedenen Formaten vorliegen, um mit all deinen bestehenden oder neuen E-Mail-Templates kompatibel zu sein.

So greifst du auf die Daten zu

In Emarsys verwendest du die Syntax {{ event.variable }}. Alles, was sich im data-Objekt des Payloads befindet, steht dir als Variable zur Verfügung.

Beispiel der Daten, die an Emarsys übermittelt werden
{
    "key_id": "3",
    "external_id": "[email protected]",
    "data": {
        "order": {
            "orderNumber": "123456789",
            "customerNumber": "123456789",
            "language": "de",
            "shipping": {
                "cost": null,
                "currency": null
            },
            "deliveryAddress": {
                "lastName": "Mustermann",
                "street": "Musterstraße 1a",
                "postalCode": "12345",
                "city": "Musterstadt",
                "country": "DE",
                "company": null,
                "department": null,
                "salutation": null,
                "firstName": "Max",
                "addition1": null,
                "addition2": null,
                "addition3": null,
                "email": "[email protected]",
                "name": "Max"
            },
            "fullyShipped": 1,
            "requestedDeliveryDate": {
                "from": "2024-12-30T00:00:00+01:00",
                "to": "2025-01-06T00:00:00+01:00"
            },
            "confirmedDeliveryDate": {
                "from": "2024-12-30T00:00:00+01:00",
                "to": "2025-01-06T00:00:00+01:00"
            },
            "orderNumberInternal": null,
            "orderDate": "2024-12-20T18:20:07+01:00",
            "paymentType": null,
            "billingAddress": null,
            "data": [],
            "items": [],
            "statuses": [],
            "shipments": [
                {
                    "trackingCode": "123456789123456789",
                    "carrier": "DHL",
                    "shippingDate": "2024-12-30T08:06:19+01:00",
                    "trackingLinks": {
                        "carrier": "https://www.dhl.de/de/privatkunden.html?piececode=123456789123456789",
                        "paqato": "https://tracking.paqato.com/DE~123456~123456789123456789~12345~123456789"
                    },
                    "items": []
                }
            ]
        },
        "shipment": {
            "trackingCode": "123456789123456789",
            "carrier": "DHL",
            "shippingDate": "2024-12-30T08:06:19+01:00",
            "trackingLinks": {
                "carrier": "https://www.dhl.de/de/privatkunden.html?piececode=123456789123456789",
                "paqato": "https://tracking.paqato.com/DE~123456~123456789123456789~12345~123456789"
            },
            "items": []
        },
        "trigger": {
            "scanTime": "2024-12-31T12:31:00+01:00",
            "expected": null,
            "place": null,
            "recipient": {
                "name": "Ablageort",
                "street": "Musterstraße 2b",
                "postalCode": "123456",
                "city": "Musterstadt",
                "country": "DE"
            },
            "openingHours": []
        },
        "internalOrderNumber": null,
        "purchaseOrderNumber": null,
        "language": "de",
        "orderNumber": "123456789",
        "orderPackageCount": 1,
        "billingAddress": null,
        "deliveryAddress": {
            "lastName": "Mustermann",
            "street": "Musterstraße 1a",
            "postalCode": "12345",
            "city": "Musterstadt",
            "country": "DE",
            "company": null,
            "department": null,
            "salutation": null,
            "firstName": "Max",
            "addition1": null,
            "addition2": null,
            "addition3": null,
            "email": "[email protected]",
            "name": "Max"
        },
        "carrier": "DHL",
        "carrierPortalLink": "https://www.dhl.de/de/privatkunden.html?piececode=123456789123456789",
        "carrierTrackingLink": "https://www.dhl.de/de/privatkunden.html?piececode=123456789123456789",
        "consignmentNumber": null,
        "customDues": 0,
        "customsPortal": null,
        "eventDateTime": "2024-12-31T12:31:00+01:00",
        "expected": null,
        "isCashOnDelivery": false,
        "isGroup": false,
        "isHazardGood": false,
        "isMeasurementCargo": false,
        "openingHours": [],
        "packages": [
            {
                "trackingCode": "123456789123456789",
                "carrier": "DHL",
                "shippingDate": "2024-12-30T08:06:19+01:00",
                "trackingLinks": {
                    "carrier": "https://www.dhl.de/de/privatkunden.html?piececode=123456789123456789",
                    "paqato": "https://tracking.paqato.com/DE~123456~123456789123456789~12345~123456789"
                },
                "items": []
            }
        ],
        "paqatoTrackingLink": "https://tracking.paqato.com/DE~123456~123456789123456789~12345~123456789",
        "recipient": {
            "lastName": "Mustermann",
            "street": "Musterstraße 1a",
            "postalCode": "12345",
            "city": "Musterstadt",
            "country": "DE",
            "company": null,
            "department": null,
            "salutation": null,
            "firstName": "Max",
            "addition1": null,
            "addition2": null,
            "addition3": null,
            "email": "[email protected]",
            "name": "Max"
        },
        "shop": null,
        "shopMapImage": null,
        "shopMapLink": null,
        "hasShopMap": false,
        "subRecipient": {
            "name": "Ablageort",
            "street": "Musterstraße 2b",
            "postalCode": "123456",
            "city": "Musterstadt",
            "country": "DE"
        },
        "trackingCode": "123456789123456789",
        "hasShop": false,
        "hasSubRecipient": true
    },
    "attachments": []
}

Wichtigste Variablen-Beispiele

Information	Primärer Pfad (Einfach)	Verschachtelter Pfad (Detail)
Bestellnummer	`{{ event.orderNumber }}`	`{{ event.order.orderNumber }}`
Tracking-Code	`{{ event.trackingCode }}`	`{{ event.shipment.trackingCode }}`
Versanddienstleister	`{{ event.carrier }}`	`{{ event.shipment.carrier }}`
Vorname	`{{ event.deliveryAddress.firstName }}`	`{{ event.order.deliveryAddress.firstName }}`
Nachname	`{{ event.deliveryAddress.lastName }}`	`{{ event.order.deliveryAddress.lastName }}`
Stadt	`{{ event.deliveryAddress.city }}`	`{{ event.order.deliveryAddress.city }}`
PAQATO Link	`{{ event.paqatoTrackingLink }}`	`{{ event.shipment.trackingLinks.paqato }}`
Status-Zeit	`{{ event.eventDateTime }}`	`{{ event.trigger.scanTime }}`

5. Einrichtung in Emarsys

📘
Hinweis: Die nachfolgenden Schritte können abweichen, sofern in Emarsys etwas im User Flow geändert wird.

Schritt 1: External Event erstellen

Navigiere in Emarsys zu Admin > External Events.
Erstelle ein neues Event (z. B. paqato_paket_zugestellt).
Notiere dir die ID des Events — diese wird im Rahmen der Finalisierung (siehe Abschnitt 2) an PAQATO übermittelt.

Schritt 2: Automation-Programm anlegen

Öffne das Automation Center und erstelle ein neues Programm.
Wähle als Startpunkt External Event und selektiere dein zuvor erstelltes Event.
Verbinde den Startknoten mit dem Knoten E-Mail senden.

Schritt 3: E-Mail personalisieren

Verwende im Emarsys VCE (Visual Content Editor) oder via ESL (Emarsys Scripting Language) die oben genannten Platzhalter.

1. Voraussetzungen in Emarsys

2. Einrichtung

3. Funktionsweise

4. Der Daten-Payload (Variablen)

So greifst du auf die Daten zu

Wichtigste Variablen-Beispiele

5. Einrichtung in Emarsys

Schritt 1: External Event erstellen

Schritt 2: Automation-Programm anlegen

Schritt 3: E-Mail personalisieren

What’s Next