Skip to content

Transaktions-E-Mails tracken

Diese Seite beschreibt, wie Sie Realtime-Tracking für Transaktions-E-Mail-Campaigns einrichten. Weitere Informationen zum Endpunkt selbst finden Sie unter Transaktions-E-Mails über API-getriggerte Zustellung senden.

Wenn Sie Transaktions-E-Mails versenden – wie Bestellbestätigungen oder Passwort-Zurücksetzungen – ist es wichtig zu wissen, ob diese Ihre Kund:innen erreichen. Mit den transaktionalen HTTP-Event-Postbacks von Braze erhalten Sie Realtime-Insights zum Status jeder Transaktions-E-Mail, sodass Sie bei Problemen schnell reagieren können.

Nutzen Sie dieses Feature, um:

  • Ihre E-Mails in Realtime zu überwachen: Sehen Sie sofort, ob Nachrichten gesendet, verarbeitet, zugestellt wurden oder auf Probleme stoßen.
  • Proaktiv zu reagieren: Senden Sie Nachrichten erneut, wechseln Sie zu einem anderen Kanal wie SMS oder nutzen Sie Fallback-Systeme, um sicherzustellen, dass Ihre Kommunikation zugestellt wird.

Ihre Transaktions-E-Mails tracken

Alle Transaktions-E-Mails werden durch Ereignisstatus-Postbacks ergänzt, die als HTTP-Anfrage an die von Ihnen angegebene URL zurückgesendet werden. So können Sie den Status der Nachricht in Realtime auswerten und Maßnahmen ergreifen, um Nutzer:innen auf einem anderen Kanal zu erreichen, wenn die Nachricht nicht zugestellt wurde, oder auf ein internes System als Fallback zurückgreifen, wenn Braze eine Latenz aufweist.

Sie können diese Updates über eindeutige Bezeichner mit einzelnen Nachrichten verknüpfen:

  • dispatch_id: Eine eindeutige ID, die Braze automatisch für jede Nachricht generiert.
  • external_send_id: Ein angepasster Bezeichner, den Sie angeben, z. B. eine Bestellnummer, um Updates mit Ihren internen Systemen abzugleichen.

Wenn Sie beispielsweise external_send_id: 1234 in die Anfrage beim Versenden einer Bestellbestätigungs-E-Mail aufnehmen, enthalten alle nachfolgenden Ereignis-Postbacks für diese E-Mail – wie Sent oder Delivered – den Wert external_send_id: 1234. Damit können Sie bestätigen, ob die Kund:in für Bestellung #1234 die Bestellbestätigungs-E-Mail erhalten hat.

Einrichten von Postbacks

In Ihrem Braze-Dashboard:

  1. Gehen Sie zu Einstellungen > E-Mail-Präferenzen.
  2. Geben Sie unter Transactional Event Status Postback die URL ein, an die Braze Status-Updates für Ihre Transaktions-E-Mails senden soll.
  3. Testen Sie das Postback.

Postback-Body

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

{
  "dispatch_id": (string, a randomly-generated unique ID of the instance of this send),
  "status": (string, Current status of message from the following message status table,
  "metadata" : (object, additional information relating to the execution of an event)
   {
     "external_send_id" : (string, If provided at the time of the request, Braze will pass your internal identifier for this send for all postbacks),
     "campaign_api_id" : (string, API identifier of this transactional campaign),
     "received_at": (ISO 8601 DateTime string, Timestamp of when the request was received by Braze, only included for events with "sent" status),
     "enqueued_at": (ISO 8601 DateTime string, Timestamp of when the request was enqueued by Braze, only included for events with "sent" status),
     "executed_at": (ISO 8601 DateTime string, Timestamp of when the request was processed by Braze, only included for events with "sent" status),
     "sent_at": (ISO 8601 DateTime string, Timestamp of when the request was sent to the ESP by Braze, only included for events with "sent" status),
     "processed_at" : (ISO 8601 DateTime string, Timestamp the event was processed by the ESP, only included for events with "processed" status),
     "delivered_at" : (ISO 8601 DateTime string, Timestamp the event was delivered to the user's inbox provider, only included for events with "processed" status),
     "bounced_at" : (ISO 8601 DateTime string, Timestamp the event was bounced by the user's inbox provider, only included for events with "bounced" status),
     "aborted_at" : (ISO 8601 DateTime string, Timestamp the event was Aborted by Braze, only included for events with "aborted" status),
     "reason" : (string, The reason Braze or the Inbox provider was unable to process this message to the user, only included for events with "aborted" or "bounced" status),
   }
}

Nachrichtenstatus

Status Beschreibung
sent Nachricht wurde erfolgreich an einen E-Mail-Versandpartner von Braze übergeben
processed Der E-Mail-Versandpartner hat die Nachricht erfolgreich empfangen und für den Versand an den Posteingang-Anbieter der Nutzer:innen vorbereitet
aborted Braze konnte die Nachricht nicht erfolgreich versenden, da die Nutzer:innen keine gültige E-Mail-Adresse haben oder die Liquid-Abbruchlogik im Nachrichtentext aufgerufen wurde. Alle abgebrochenen Ereignisse enthalten ein Feld reason im Metadaten-Objekt, das angibt, warum die Nachricht abgebrochen wurde
delivered Nachricht wurde vom Posteingang-Anbieter der Nutzer:innen akzeptiert
bounced Nachricht wurde vom Posteingang-Anbieter der Nutzer:innen abgelehnt. Alle Bounce-Ereignisse enthalten ein Feld reason im Metadaten-Objekt, das den vom Posteingang-Anbieter bereitgestellten Bounce-Fehlercode wiedergibt

Beispiel-Postback

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61


// Sent Event
{
    "dispatch_id": "acf471119f7449d579e8089032003ded",
    "status": "sent",
    "metadata": {
      "received_at": "2020-08-31T18:58:41.000+00:00",
      "enqueued_at": "2020-08-31T18:58:41.000+00:00",
      "executed_at": "2020-08-31T18:58:41.000+00:00",
      "sent_at": "2020-08-31T18:58:42.000+00:00",
      "campaign_api_id": "417220e4-5a2a-b634-7f7d-9ec891532368",
      "external_send_id" : "34a2ceb3cf6184132f3d816e9984269a"
    }
}

// Processed Event
{
    "dispatch_id": "acf471119f7449d579e8089032003ded",
    "status": "processed",
    "metadata": {
      "processed_at": "2020-08-31T18:58:42.000+00:00",
      "campaign_api_id": "417220e4-5a2a-b634-7f7d-9ec891532368",
      "external_send_id" : "34a2ceb3cf6184132f3d816e9984269a"
    }
}

// Aborted
{
    "dispatch_id": "acf471119f7449d579e8089032003ded",
    "status": "aborted",
    "metadata": {
      "reason": "User not emailable",
      "aborted_at": "2020-08-31T19:04:51.000+00:00",
      "campaign_api_id": "417220e4-5a2a-b634-7f7d-9ec891532368",
      "external_send_id" : "34a2ceb3cf6184132f3d816e9984269a"
    }
}

// Delivered Event
{
    "dispatch_id": "acf471119f7449d579e8089032003ded",
    "status": "delivered",
    "metadata": {
      "delivered_at": "2020-08-31T18:27:32.000+00:00",
      "campaign_api_id": "417220e4-5a2a-b634-7f7d-9ec891532368",
      "external_send_id" : "34a2ceb3cf6184132f3d816e9984269a"
    }
}

// Bounced Event
{
    "dispatch_id": "acf471119f7449d579e8089032003ded",
    "status": "bounced",
    "metadata": {
      "bounced_at": "2020-08-31T18:58:43.000+00:00",
      "reason": "550 5.1.1 The email account that you tried to reach does not exist",
      "campaign_api_id": "417220e4-5a2a-b634-7f7d-9ec891532368",
      "external_send_id" : "34a2ceb3cf6184132f3d816e9984269a"
    }
}
New Stuff!