Journey-Ereignisse

Wenn Sie eine Journey veröffentlichen, kann Amazon Pinpoint Ereignisdaten über die Journey streamen. Dies schließt Ereignisdaten für alle E-Mail-, SMS-, Push- oder benutzerdefinierten Nachrichten ein, die Sie von der Journey senden. Bevor Sie Ihre Ereignisse ansehen können, müssen Sie das Event-Streaming einrichten, sieheEinrichten von Ereignis-Streaming. Beim Einrichten des Event-Streamings geben Sie ein Ziel an, an dem Ihre Veranstaltungsdaten gespeichert werden sollen. Anschließend können Sie das Ziel verwenden, um Ihre Veranstaltungsdaten zur Ansicht abzurufen.

Im Folgenden finden Sie Informationen zu den Daten, die Amazon Pinpoint streamt:

• Informationen zu E-Mail-Nachrichten finden Sie unter E-Mail-Ereignisse.

• Informationen zu SMS-Nachrichten finden Sie unter SMS-Ereignisse.

Beispielereignis

Das JSON-Objekt für ein Journey-Ereignis enthält die im folgenden Beispiel gezeigten Daten.

{
   "event_type":"_journey.send",
   "event_timestamp":1572989078843,
   "arrival_timestamp":1572989078843,
   "event_version":"3.1",
   "application":{
      "app_id":"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
      "sdk":{

      }
   },
   "client":{
      "client_id":"d8dcf7c5-e81a-48ae-8313-f540cexample"
   },
   "device":{
      "platform":{

      }
   },
   "session":{

   },
   "attributes":{
      "journey_run_id":"edc9a0b577164d1daf72ebd15example",
      "journey_send_status":"SUCCESS",
      "journey_id":"546401670c5547b08811ac6a9example",
      "journey_activity_id":"0yKexample",
      "journey_activity_type": "EMAIL",
      "journey_send_status_message": "200", 
      "journey_send_status_code": "200"
   },
   "client_context":{
      "custom":{
         "endpoint":"{\"ChannelType\":\"EMAIL\",\"EndpointStatus\":\"ACTIVE\",\"OptOut\":\"NONE\",\"Demographic\":{\"Timezone\":\"America/Los_Angeles\"}}"
      }
   },
   "awsAccountId":"123456789012"
}

Journey-Ereignisattribute

In diesem Abschnitt werden die Attribute definiert, die in den Ereignis-Stream-Daten enthalten sind, die Amazon Pinpoint für eine Journey generiert.

Attribut	Beschreibung
event_type	Der Ereignistyp. Bei Journey-Ereignissen ist der Wert für dieses Attribut immer _journey.send, was angibt, dass Amazon Pinpoint die Reise ausgeführt hat.
event_timestamp	Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden.
arrival_timestamp	De Zeitpunkt, zu dem das Ereignis von Amazon Pinpoint empfangen wurde, angezeigt als Unix-Zeit in Millisekunden.
event_version	Die Version des Ereignis-JSON-Schemas. Tipp Prüfen Sie diese Version in der Anwendung, mit der Ihr Ereignis verarbeitet wird, damit Sie wissen, wann die Anwendung infolge eines Schema-Updates aktualisiert werden soll.
application	Informationen über das Amazon-Pinpoint-Projekt, das dem Ereignis zugeordnet ist. Weitere Informationen finden Sie in der Tabelle Application (Anwendung).
client	Informationen über den Endpunkt, dem das Ereignis zugeordnet ist. Weitere Informationen finden Sie in der Tabelle Client.
device	Informationen über das Gerät, das das Ereignis gemeldet hat. Bei Journeys ist dieses Objekt leer.
session	Informationen über die Sitzung, die das Ereignis generiert hat. Bei Journeys ist dieses Objekt leer.
attributes	Attribute, die der Journey und der Journey-Aktivität zugeordnet sind, die das Ereignis generiert hat. Weitere Informationen finden Sie in der Tabelle Attributes (Attribute).
client_context	Enthält ein custom-Objekt, das eine endpoint-Eigenschaft enthält. Die endpoint-Eigenschaft enthält den Inhalt des Endpunktdatensatzes für den Endpunkt, der dem Ereignis zugeordnet ist.
awsAccountId	Die ID des AWS Kontos, das zur Ausführung der Reise verwendet wurde.

Anwendung

Enthält Informationen über das Amazon-Pinpoint-Projekt, dem das Ereignis zugeordnet ist.

Attribut	Beschreibung
app_id	Die eindeutige ID des Amazon-Pinpoint-Projekts, das das Ereignis gemeldet hat.
sdk	Das SDK, das zum Melden des Ereignisses verwendet wurde.

Client

Enthält Informationen über den Endpunkt, mit dem das Ereignis verknüpft ist.

Attribut	Beschreibung
client_id	Die ID des Endpunkts.

Attribute

Enthält Informationen über die Journey, die das Ereignis generiert hat.

Attribut	Beschreibung
journey_run_id	Die eindeutige ID des Journeylaufs, der das Ereignis generiert hat. Amazon Pinpoint generiert diese ID automatisch und weist sie jedem neuen Lauf einer Journey zu.
journey_send_status	Gibt den Zustellungsstatus der Nachricht an, die dem Ereignis zugeordnet ist. Mögliche Werte sind: SUCCESS: Die Nachricht wurde erfolgreich an den Endpunkt gesendet. FAILURE: Die Nachricht wurde nicht an den Endpunkt gesendet, da ein Fehler aufgetreten ist. CUSTOM_DELIVERY_FAILURE: Die benutzerdefinierte Bereitstellung ist fehlgeschlagen. FAILURE_PERMANENT: Beim Senden an den Endpunkt ist ein permanenter Fehler aufgetreten. Tipp Sie können nach Ereignissen mit dem Status FAILURE_PERMANENT filtern und diese auf 403 journey_send_status_code setzen, um festzustellen, ob eine Zugriffsrichtlinie und eine Rollenverletzung vorliegt. Bei ausgehenden Kampagnen mit Spracheingabe sind diese Ausnahmen typisch für Fälle, in denen die Connect-Kampagnenausführungsrolle, die Amazon Pinpoint Pinpoint-Journeys Amazon Connect Connect-Kampagnen verknüpft, versehentlich für die Ausführung von Reisen während des Fluges gelöscht wird. THROTTLED: Das Senden wurde gedrosselt. UNSUPPORTED_CHANNEL: Kanal wird nicht unterstützt. DAILY_CAP: Die Nachricht wurde nicht an den Endpunkt gesendet, da das Senden der Nachricht die maximale Anzahl von Nachrichten überschreiten würde, die die Journey oder das Projekt während eines 24-Stunden-Zeitraums an einen einzelnen Endpunkt senden kann. QUIET_TIME: Die Nachricht wurde aufgrund von Beschränkungen für die Journey oder das Projekt nicht gesendet. QUIET_TIME_MISSING_TIMEZONE: Die Nachricht wurde nicht gesendet, da die Zeitzonenschätzung keine Zeitzone für den Endpunkt schätzen konnte und die Ruhezeit aktiviert ist.
journey_id	Die eindeutige ID der Journey, die das Ereignis generiert hat.
journey_activity_id	Die eindeutige ID der Journey-Aktivität, die das Ereignis generiert hat.
journey_activity_type	Der Journey-Aktivitätstyp des Ereignisses. Dies kann EMAIL, SMS, PUSH, CONTACT_CENTER oder CUSTOM sein. Anmerkung VOICE ist kein unterstützter Journey-Aktivitätstyp.
journey_send_status_message	Die Beschreibung des Status des Sendeereignisses.
journey_send_status_code	Der HTTP-Statuscode der Anfrage.