**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 In Bezug auf SMS sind Sprach-, mobile Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt. 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. # E-Mail-Ereignisdatenstream von Amazon Pinpoint Wenn Sie Amazon Pinpoint zum Senden von E-Mails verwenden, kann Amazon Pinpoint Ereignisdaten zu diesen E-Mails streamen. Nachdem Sie das Event-Streaming eingerichtet haben, ruft Amazon Pinpoint Ihre Veranstaltungsdaten von dem Ziel ab, das Sie bei der Einrichtung angegeben haben, damit Sie sie sich ansehen können. Informationen zum Einrichten des Event-Streamings finden Sie unter. [Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen](event-streams-setup.md) Amazon Pinpoint streamt Daten über die folgenden Ereignistypen für E-Mail-Nachrichten: + Sends (Sendevorgänge) + Deliveries (Zustellungen) + Unzustellbarkeit + Complaints (Beschwerden) + Opens (Öffnungsvorgänge) + Clicks (Klickvorgänge) + Ablehnungen + Abbestellungen + Rendering failures (Rendern von Fehlern) Diese Ereignistypen werden unter ausführlich [E-Mail-Ereignisattribute](#event-streams-data-email-attributes) erklärt. Abhängig von der API und den Einstellungen, die Sie zum Senden von E-Mail-Nachrichten verwenden, werden möglicherweise zusätzliche Ereignistypen oder andere Daten angezeigt. Wenn Sie beispielsweise Nachrichten mithilfe von Konfigurationssätzen senden, in denen Ereignisdaten zu Amazon Kinesis veröffentlicht werden, z. B. von Amazon Simple Email Service (Amazon SES), können die Daten auch Ereignisse für Vorlagenrendering-Fehler enthalten. Weitere Informationen zu diesen Daten finden Sie unter [Überwachen mithilfe der Amazon-SES-Ereignisveröffentlichung](https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html) im *Entwicklerhandbuch für Amazon Simple Email Service*. Bevor Sie Ihre Ereignisse ansehen können, müssen Sie das Event-Streaming einrichten, siehe[Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen](event-streams-setup.md). 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. ## Beispiele für E-Mail-Ereignisse **E-Mail-Sendevorgang** Das JSON-Objekt für ein *E-Mail-Sendeereignis* enthält die Daten wie im folgenden Beispiel. ``` { "event_type": "_email.send", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618622025, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "9a311b17-6f8e-4093-be61-4d0bbexample" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "received" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "send": {} } } } } ``` **E-Mail zugestellt** Das JSON-Objekt für ein *E-Mail-Zustellereignis* enthält die Daten wie im folgenden Beispiel. ``` { "event_type": "_email.delivered", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618622690, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "e9a3000d-daa2-40dc-ac47-1cd34example" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "delivered" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "delivery": { "smtp_response": "250 ok: Message 82080542 accepted", "reporting_mta": "a8-53.smtp-out.amazonses.com", "recipients": ["recipient@example.com"], "processing_time_millis": 1310 } } } } } ``` **E-Mail-Klick** Das JSON-Objekt für ein *E-Mail-Klickereignis* enthält die Daten wie im folgenden Beispiel. ``` { "event_type": "_email.click", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618713751, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "49c1413e-a69c-46dc-b1c4-6470eexample" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "https://aws.amazon.com/pinpoint/" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }, { "name": "Message-ID", "value": "null" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "click": { "ip_address": "72.21.198.67", "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.2 Safari/605.1.15", "link": "https://aws.amazon.com/pinpoint/" } } } } } ``` **E-Mail-Öffnungsvorgang** Das JSON-Objekt für ein *E-Mail-Öffnungsvorgangsereignis* enthält die Daten wie im folgenden Beispiel. ``` { "event_type": "_email.open", "event_timestamp": 1564618621380, "arrival_timestamp": 1564618712316, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "8dc1f651-b3ec-46fc-9b67-2a050example" }, "device": { "platform": {} }, "session": {}, "attributes": { "feedback": "opened" }, "awsAccountId": "123456789012", "facets": { "email_channel": { "mail_event": { "mail": { "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000", "message_send_timestamp": 1564618621380, "from_address": "sender@example.com", "destination": ["recipient@example.com"], "headers_truncated": false, "headers": [{ "name": "From", "value": "sender@example.com" }, { "name": "To", "value": "recipient@example.com" }, { "name": "Subject", "value": "Amazon Pinpoint Test" }, { "name": "MIME-Version", "value": "1.0" }, { "name": "Content-Type", "value": "multipart/alternative; boundary=\"----=_Part_314159_271828\"" }, { "name": "Message-ID", "value": "null" }], "common_headers": { "from": "sender@example.com", "to": ["recipient@example.com"], "subject": "Amazon Pinpoint Test" } }, "open": { "ip_address": "72.21.198.67", "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko)" } } } } } ``` ## E-Mail-Ereignisattribute In diesem Abschnitt werden die Attribute definiert, die im vorherigen Beispiel für die Event-Stream-Daten enthalten sind, die Amazon Pinpoint generiert, wenn Sie E-Mail-Nachrichten senden. | Attribut | Beschreibung | | --- | --- | | event\$1type | Der Ereignistyp. Die möglichen Werte sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/event-streams-data-email.html) | | event\$1timestamp | Die Uhrzeit, zu der die Nachricht gesendet wurde, wird als Unix-Zeit in Millisekunden angezeigt. Dieser Wert ist in der Regel für alle Ereignisse identisch, die für eine Nachricht generiert werden. | | arrival\$1timestamp | De Zeitpunkt, zu dem das Ereignis von Amazon Pinpoint empfangen wurde, angezeigt als Unix-Zeit in Millisekunden. | | event\$1version | 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)* . | | client | Informationen zum App-Client, der auf dem Gerät installiert ist, das das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle *Client*. | | device | Informationen über das Gerät, das das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle *Device (Gerät)*. Bei E-Mail-Ereignissen ist dieses Objekt leer. | | session | Bei E-Mail-Ereignissen ist dieses Objekt leer. | | attributes | Attribute, die dem Ereignis zugeordnet sind. Weitere Informationen finden Sie in der Tabelle *Attributes (Attribute)*. 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 Nachricht aus einer Kampagne oder Journey erstellt werden, enthält dieses Objekt Attribute, die der Kampagne oder Journey zugeordnet sind. Bei Ereignissen, die generiert werden, wenn Sie Transaktionsnachrichten senden, enthält dieses Objekt Informationen, die sich auf die Nachricht selbst beziehen. | | client\$1context | Bei E-Mail-Ereignissen enthält dieses Objekt ein custom-Objekt, das ein legacy\$1identifier Attribut enthält. Der Wert für das legacy\$1identifier-Attribut ist die ID des Projekts, von dem die Nachricht gesendet wurde. | | facets | Zusätzliche Informationen über die Nachricht, z. B. die E-Mail-Header. Weitere Informationen finden Sie in der Tabelle *Facets*. | | 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 | Beschreibung | | --- | --- | | app\$1id | Die eindeutige ID des Amazon-Pinpoint-Projekts, das das Ereignis gemeldet hat. | | sdk | Das SDK, das zum Melden des Ereignisses verwendet wurde. Wenn Sie eine Transaktions-E-Mail-Nachricht durch einen direkten Amazon-Pinpoint-API-Aufruf oder über die Amazon-Pinpoint-Konsole senden, ist dieses Objekt leer. | ### Attribute Enthält Informationen über die Kampagne oder Journey, die das Ereignis generiert hat. #### Kampagne Enthält Informationen über die Kampagne, die das Ereignis generiert hat. | Attribut | Beschreibung | | --- | --- | | feedback | Bei `_email.click`-Ereignissen ist der Wert für dieses Attributs die URL des Links, auf den der Empfänger in der Nachricht geklickt hat, um das Ereignis zu generieren. Bei anderen Ereignissen stellt dieser Wert den Ereignistyp dar (z. B. `received`, `opened` oder `clicked`). | | treatment\$1id | Wenn die Nachricht mit einer A/B-Testkampagne gesendet wurde, stellt dieser Wert die Behandlungsnummer der Nachricht dar. Für Standardkampagnen und Transaktions-E-Mail-Nachrichten ist dieser Wert `0`. | | campaign\$1activity\$1id | Die eindeutige ID, die Amazon Pinpoint generiert, wenn das Ereignis eintritt. | | campaign\$1id | Die eindeutige ID der Kampagne, die die Nachricht gesendet hat. | #### Journey Enthält Informationen über die Journey, die das Ereignis generiert hat. | Attribut | Beschreibung | | --- | --- | | journey\$1run\$1id | Die eindeutige ID des Journeylaufs, der die Nachricht gesendet hat. Amazon Pinpoint generiert diese ID automatisch und weist sie jedem neuen Lauf einer Journey zu. | | feedback | Bei `_email.click`-Ereignissen ist der Wert für dieses Attributs die URL des Links, auf den der Empfänger in der Nachricht geklickt hat, um das Ereignis zu generieren. Bei anderen Ereignissen stellt dieser Wert den Ereignistyp dar (z. B. `received`, `delivered` oder `opened`). | | journey\$1id | Die eindeutige ID der Journey, die die Nachricht gesendet hat. | | journey\$1activity\$1id | Die eindeutige ID der Journey-Aktivität, die die Nachricht gesendet hat. | ### Client Die eindeutige Kennung des Kunden, auf den die Kampagne oder Journey abzielte. | Attribut | Beschreibung | | --- | --- | | client\$1id | Die Client-ID Der Wert ist die Endpunkt-ID für Kampagnen und Journeys und für transaktionales Senden ist es eine UUID. | ### Facets Enthält Informationen zur Nachricht und zum Ereignistyp. | Attribut | Beschreibung | | --- | --- | | email\$1channel | Enthält ein Objekt `mail_event`, das zwei Objekte enthält: `mail` und ein Objekt, das dem Ereignistyp entspricht. | ### Mail Enthält Informationen über den Inhalt der E-Mail-Nachricht sowie Metadaten zu der Nachricht. | Attribut | Beschreibung | | --- | --- | | message\$1id | Die eindeutige ID der Nachricht. Amazon Pinpoint generiert diese ID automatisch, wenn es die Nachricht akzeptiert. | | message\$1send\$1timestamp | Das Datum und die Uhrzeit, zu der die Nachricht gesendet wurde, in dem Format angezeigt, das in [RFC 822](https://datatracker.ietf.org/doc/html/rfc822) angegeben ist. | | from\$1address | Die E-Mail-Adresse, von der die Nachricht gesendet wurde. | | destination | Ein Array mit den E-Mail-Adressen, an die die Nachricht gesendet wurde. | | headers\$1truncated | Ein boolescher Wert, der angibt, ob die E-Mail-Header abgeschnitten wurden. | | headers | Ein Objekt, das mehrere Name-Wert-Paare enthält, die den Headern in der Nachricht entsprechen. Dieses Objekt enthält in der Regel Informationen zu den folgenden Headern: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/event-streams-data-email.html) | | common\$1headers | Enthält Informationen zu verschiedenen allgemeinen Kopfzeilen für E-Mail-Nachrichten. Die Informationen können das Datum, an dem die Nachricht gesendet wurde, sowie die Zeilen „An“, „Von“ und „Betreff“ der Nachricht enthalten. |