**Hinweis zum Ende des Supports:** Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon-Pinpoint-Konsole oder die Amazon-Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analytik) zugreifen. Weitere Informationen finden Sie unter [Ende des Amazon-Pinpoint-Supports](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Hinweis:** APIs für SMS, Telefonie, mobile Push, OTP und Überprüfung von Telefonnummern sind von dieser Änderung nicht betroffen und werden von End User Messaging unterstützt. AWS Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Datenstream zu Kampagnenereignissen von Amazon Pinpoint Wenn Sie Amazon Pinpoint verwenden, um Kampagnen über einen Kanal zu versenden, kann Amazon Pinpoint Ereignisdaten zu diesen Kampagnen streamen. Nachdem Sie das Event-Streaming eingerichtet haben, ruft Amazon Pinpoint die Eventdaten Ihrer App für E-Mail- oder SMS-Nachrichten ab, die Sie aus einer Kampagne von dem Ziel senden, das Sie bei der Einrichtung angegeben haben, damit Sie sie sich ansehen können. Ausführliche Informationen zu den Daten, die Amazon Pinpoint für E-Mail- und SMS-Nachrichten streamt, finden Sie unter [E-Mail-Ereignisdatenstream von Amazon Pinpoint](event-streams-data-email.md) und[SMS-Ereignisdatenstream von Amazon Pinpoint](event-streams-data-sms.md). Informationen zum Einrichten von Event-Streaming finden Sie unter[Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen](event-streams-setup.md). ## Beispiel für eine Kampagnenveranstaltung Das JSON-Objekt für ein Kampagnenereignis enthält die im folgenden Beispiel gezeigten Daten. ``` { "event_type": "_campaign.send", "event_timestamp": 1562109497426, "arrival_timestamp": 1562109497494, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "d8dcf7c5-e81a-48ae-8313-f540cexample" }, "device": { "platform": {} }, "session": {}, "attributes": { "treatment_id": "0", "campaign_activity_id": "5473285727f04865bc673e527example", "delivery_type": "GCM", "campaign_id": "4f8d6097c2e8400fa3081d875example", "campaign_send_status": "SUCCESS" }, "client_context": { "custom": { "endpoint": "{\"ChannelType\":\"GCM\",\"EndpointStatus\":\"ACTIVE\", ↳\"OptOut\":\"NONE\",\"RequestId\":\"ec229696-9d1e-11e9-8bf1-85d0aexample\", ↳\"EffectiveDate\":\"2019-07-02T23:12:54.836Z\",\"User\":{}}" } }, "awsAccountId": "123456789012" } ``` ## Kampagnen-Ereignisattribute In diesem Abschnitt werden die Attribute definiert, die im Ereignis-Stream der Kampagne enthalten sind. | Attribut | Description | | --- | --- | | event\_type | Der Ereignistyp. Die möglichen Werte sind:+ **\_campaign.send**: Amazon Pinpoint hat die Kampagne ausgeführt.
+ **\_campaign.opened\_notification**: Bei Kampagnen mit Push-Benachrichtigungen gibt dieser Ereignistyp an, dass der Empfänger auf die Benachrichtigung getippt hat, um sie zu öffnen.
+ **\_campaign.received\_foreground**: Bei Kampagnen mit Push-Benachrichtigungen gibt dieser Ereignistyp an, dass der Empfänger die Nachricht als Vordergrundbenachrichtigung erhalten hat.
+ **\_campaign.received\_background**: Bei Kampagnen mit Push-Benachrichtigungen gibt dieser Ereignistyp an, dass der Empfänger die Nachricht als Hintergrundbenachrichtigung erhalten hat. **\_campaign.opened\_notification**, **\_campaign.received\_foreground** und **\_campaign.received\_background** werden nur zurückgegeben, wenn Sie AWS Amplify verwenden. Weitere Informationen zur Integration Ihrer App mit AWS Amplify. Siehe [Connect Ihre Frontend-Anwendung mithilfe von Amplify mit Amazon Pinpoint AWS](integrate-sdk.md). | | 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. 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)](#event-streams-data-campaign-attributes-application). | | client | Informationen über den Endpunkt, dem das Ereignis zugeordnet ist. Weitere Informationen finden Sie in der Tabelle [Client](#event-streams-data-campaign-attributes-client). | | device | Informationen über das Gerät, das das Ereignis gemeldet hat. Bei Kampagnen- und Transaktionsnachrichten ist dieses Objekt leer. | | session | Informationen über die Sitzung, die das Ereignis generiert hat. Bei Kampagnen ist dieses Objekt leer. | | attributes | Attribute, die dem Ereignis zugeordnet sind. Bei Ereignissen, die von einer Ihrer Apps gemeldet werden, kann dieses Objekt benutzerdefinierte Attribute enthalten, die von der App definiert werden. Bei Ereignissen, die beim Senden einer Kampagne erstellt werden, enthält dieses Objekt Attribute, die der Kampagne zugeordnet sind. Bei Ereignissen, die generiert werden, wenn Sie Transaktionsnachrichten senden, enthält dieses Objekt Informationen, die sich auf die Nachricht selbst beziehen.
Weitere Informationen finden Sie in der Tabelle [Attributes (Attribute)](#event-streams-data-campaign-attributes-attrs). | | 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, an den die Kampagne gesendet wurde. | | awsAccountId | Die ID des AWS Kontos, das zum Senden der Nachricht verwendet wurde. | ### Anwendung Enthält Informationen über das Amazon Pinpoint-Projekt, dem das Ereignis zugeordnet ist. | Attribut | Description | | --- | --- | | app\_id | Die eindeutige ID des Amazon-Pinpoint-Projekts, das das Ereignis gemeldet hat. | | sdk | Das SDK, das zum Melden des Ereignisses verwendet wurde. | ### Attribute Enthält Informationen über die Kampagne, die das Ereignis generiert hat. | Attribut | Description | | --- | --- | | treatment\_id | Wenn die Nachricht mithilfe einer A/B Testkampagne gesendet wurde, steht dieser Wert für die Behandlungsnummer der Nachricht. Für Standardkampagnen ist dieser Wert `0`. | | campaign\_activity\_id | Die eindeutige ID, die Amazon Pinpoint generiert, wenn das Ereignis eintritt. | | delivery\_type | Die Bereitstellungsmethode für die Kampagne. Verwechseln Sie dieses Attribut nicht mit dem `ChannelType`-Feld, das unter der `endpoint`-Eigenschaft von `client_context` angegeben ist. Das `ChannelType`-Feld basiert normalerweise auf dem Endpunkt, an den die Nachricht gesendet wird.
Bei Kanälen, die nur einen Endpunkttyp unterstützen, haben die Felder `delivery_type` und `ChannelType` denselben Wert. Für den E-Mail-Kanal haben die Felder `delivery_type` und `ChannelType` beispielsweise denselben Wert EMAIL.
Diese Bedingung gilt jedoch nicht immer für Kanäle, die unterschiedliche Endpunkttypen unterstützen, z. B. benutzerdefinierte Kanäle. Sie können einen benutzerdefinierten Kanal für verschiedene Endpunkte verwenden, z. B. EMAIL, SMS, CUSTOM usw. In diesem Fall identifiziert der `delivery_type` ein benutzerdefiniertes Bereitstellungsereignis, CUSTOM, und der `ChannelType` gibt den Typ des Endpunkts an, an den die Kampagne gesendet wurde, z. B. EMAIL, SMS, CUSTOM usw. Weitere Informationen zum Erstellen von benutzerdefinierten Kanälen finden Sie unter [Erstellen Sie einen benutzerdefinierten Kanal in Amazon Pinpoint mithilfe einer Webhook- oder Lambda-Funktion](channels-custom.md).
Die möglichen Werte sind:+ **EMAIL**
+ ** SMS**
+ **ADM**
+ **APNS**
+ **APNS\_SANDBOX**
+ **APNS\_VOIP**
+ **APNS\_VOIP\_SANDBOX**
+ **VOICE**
+ **GCM**
+ **BAIDU**
+ **PUSH**
+ **CUSTOM** | | campaign\_id | Die eindeutige ID der Kampagne, von der die Nachricht gesendet wurde. | | campaign\_send\_status | Gibt den Status der Kampagne für den Zielendpunkt an. Mögliche Werte sind:+ **SUCCESS**: Die Kampagne wurde erfolgreich an den Endpunkt gesendet.
+ **FAILURE**: Die Kampagne wurde nicht an den Endpunkt gesendet.
+ **DAILY\_CAP**: Die Kampagne wurde nicht an den Endpunkt gesendet, da bereits die maximale Anzahl an täglichen Nachrichten an den Endpunkt gesendet wurde.
+ **EXPIRED**: Die Kampagne wurde nicht an den Endpunkt gesendet, da das Senden die Einstellungen für die maximale Dauer oder die Senderate für die Kampagne überschreiten würde.
+ **QUIET\_TIME**: Die Kampagne wurde aufgrund von Ruhezeitbeschränkungen nicht an den Endpunkt gesendet.
+ **HOLDOUT**: Die Kampagne wurde nicht an den Endpunkt gesendet, da der Endpunkt Mitglied der Holdout-Gruppe war.
+ **DUPLICATE\_ADDRESS**: Das Segment enthält doppelte Endpunktadressen. Die Kampagne wurde einmal an die Endpunktadresse gesendet.
+ **QUIET\_TIME**: Die Kampagne wurde aufgrund von Ruhezeitbeschränkungen nicht an den Endpunkt gesendet.
+ **CAMPAIGN\_CAP**: Die Kampagne wurde nicht an den Endpunkt gesendet, da von dieser Kampagne bereits die maximale Anzahl an Nachrichten an den Endpunkt gesendet wurde.
+ **FAILURE\_PERMANENT**: Beim Senden an den Endpunkt ist ein permanenter Fehler aufgetreten.
+ **TRANSIENT\_FAILURE**: Beim Senden an den Endpunkt ist ein vorübergehender Fehler aufgetreten.
+ **THROTTLED**: Das Senden wurde gedrosselt.
+ **UNKNOWN**: Unbekannter Fehler.
+ **HOOK\_FAILURE**: Der Kampagnen-Hook ist fehlgeschlagen.
+ **CUSTOM\_DELIVERY\_FAILURE**: Die benutzerdefinierte Bereitstellung ist fehlgeschlagen.
+ **RECOMMENDATION\_FAILURE**: Empfehlung fehlgeschlagen.
+ **UNSUPPORTED\_CHANNEL**: Kanal wird nicht unterstützt. | ### Client Enthält Informationen über den Endpunkt, auf den die Kampagne ausgerichtet war. | Attribut | Description | | --- | --- | | client\_id | Die ID des Endpunkts, an den die Kampagne gesendet wurde. |