**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.

# Streamen Sie App-Ereignisdaten mithilfe von Amazon Pinpoint über Kinesis und Firehose
<a name="event-streams"></a>

In Amazon Pinpoint ist ein *Ereignis* eine Aktion, die auftritt, wenn ein Benutzer mit einer Ihrer Anwendungen interagiert, Sie eine Nachricht aus einer Kampagne oder einer Journey senden oder eine Transaktions-SMS oder eine E-Mail-Nachricht senden. Wenn Sie beispielsweise eine E-Mail-Nachricht senden, treten mehrere Ereignisse auf:
+ Wenn Sie die Nachricht senden, tritt ein *Sendeereignis* ein.
+ Wenn die Nachricht den Posteingang des Empfängers erreicht, tritt ein *Zustellereignis* ein.
+ Wenn der Empfänger die Nachricht öffnet, tritt ein *Öffnen*- Ereignis ein. 

Sie können Amazon Pinpoint so konfigurieren dass Informationen zu Ereignissen an Amazon Kinesis gesendet werden. Die Kinesis-Plattform bietet Dienste, mit denen Sie Daten aus AWS Diensten in Echtzeit sammeln, verarbeiten und analysieren können. Amazon Pinpoint kann Ereignisdaten an Firehose senden, das diese Daten an AWS Datenspeicher wie Amazon S3 oder Amazon Redshift streamt. Amazon Pinpoint kann auch Daten an Kinesis Data Streams streamen, das mehrere Datenströme zur Verarbeitung durch Analyseanwendungen aufnimmt und speichert.

Der Amazon Pinpoint-Ereignis-Stream enthält Informationen zu Benutzerinteraktionen mit Anwendungen (Apps), die Sie mit Amazon Pinpoint verbinden. Er enthält auch Informationen über alle Nachrichten, die Sie von Kampagnen, über jeden Kanal und von Journeys senden. Dies kann auch alle benutzerdefinierten Ereignisse umfassen, die Sie definiert haben. Schließlich enthält er Informationen über die Transaktions-E-Mail-Nachrichten und SMS-Nachrichten, die Sie senden.

**Anmerkung**  
Amazon Pinpoint streamt keine Informationen über transaktionale Push-Benachrichtigungen oder Sprachnachrichten.

Dieses Kapitel enthält Informationen zum Einrichten von Amazon Pinpoint zum Streamen von Ereignisdaten zu Kinesis. Er enthält auch Beispiele für die Ereignisdaten, die Amazon Pinpoint streamt.

**Topics**
+ [Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen](event-streams-setup.md)
+ [App-Event-Datenstream von Amazon Pinpoint](event-streams-data-app.md)
+ [Datenstream zu Kampagnenereignissen von Amazon Pinpoint](event-streams-data-campaign.md)
+ [Reiseereignisdaten von Amazon Pinpoint](event-streams-data-journey.md)
+ [E-Mail-Ereignisdatenstream von Amazon Pinpoint](event-streams-data-email.md)
+ [SMS-Ereignisdatenstream von Amazon Pinpoint](event-streams-data-sms.md)
+ [Löschen Sie einen Event-Stream aus Amazon Pinpoint](event-streams-disable.md)

# Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen
<a name="event-streams-setup"></a>

Sie können Amazon Pinpoint so einrichten, dass Ereignisdaten an einen Amazon Kinesis Kinesis-Stream oder einen Amazon Data Firehose-Lieferstream gesendet werden. Amazon Pinpoint kann Ereignisdaten für Kampagnen, Reisen und transaktionale E-Mail- und SMS-Nachrichten senden.

Dieser Abschnitt enthält Informationen zum programmgesteuerten Konfigurieren von Ereignis-Streaming. Sie können auch die Amazon-Pinpoint-Konsole verwenden, um Ereignis-Streaming zu konfigurieren. Weitere Informationen zum Konfigurieren von Ereignis-Streaming mithilfe der Amazon-Pinpoint-Konsole finden Sie unter [Ereignis-Stream-Einstellungen](https://docs.aws.amazon.com/pinpoint/latest/userguide/settings-event-streams.html) im *Amazon-Pinpoint-Benutzerhandbuch*.

## Voraussetzungen
<a name="event-streams-setup-prerequisites"></a>

Die Beispiele in diesem Abschnitt erfordern die folgende Eingabe:
+ Die Anwendungs-ID einer Anwendung, die mit Amazon Pinpoint und Berichtsereignissen integriert ist. Weitere Informationen über die Integration finden Sie unter [Integrieren Sie Amazon Pinpoint in Ihre Anwendung](integrate.md).
+ Der Amazon-Ressourcenname (ARN) eines Kinesis-Streams oder Firehose-Lieferstreams in Ihrem AWS Konto. Informationen zum Erstellen dieser Ressourcen finden Sie unter [Creating and Managing Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) im *Amazon Kinesis Data Streams Developer Guide* oder [Creating an Amazon Data Firehose Delivery Stream](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) im *Amazon Data Firehose* Developer Guide.
+ Der ARN einer AWS Identity and Access Management (IAM-) Rolle, die Amazon Pinpoint autorisiert, Daten an den Stream zu senden. Weitere Informationen zum Erstellen einer Rolle finden Sie unter [IAM-Rolle für das Streamen von Ereignissen an Kinesis](permissions-streams.md).

## AWS CLI
<a name="event-streams-setup-cli"></a>

Das folgende AWS CLI Beispiel verwendet den Befehl. [put-event-stream](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/put-event-stream.html) Dieser Befehl konfiguriert Amazon Pinpoint, um Ereignisse an einen Kinesis-Stream zu senden:

```
aws pinpoint put-event-stream \
--application-id projectId \
--write-event-stream DestinationStreamArn=streamArn,RoleArn=roleArn
```

## AWS SDK für Java
<a name="event-streams-setup-java"></a>

Im folgenden Java-Beispiel wird Amazon Pinpoint so konfiguriert, dass Ereignisse an einen Kinesis-Stream gesendet werden:

```
public PutEventStreamResult createEventStream(AmazonPinpoint pinClient, 
        String appId, String streamArn, String roleArn) {
        
    WriteEventStream stream = new WriteEventStream()
            .withDestinationStreamArn(streamArn)
            .withRoleArn(roleArn);

    PutEventStreamRequest request = new PutEventStreamRequest()
            .withApplicationId(appId)
            .withWriteEventStream(stream);

    return pinClient.putEventStream(request);
}
```

In diesem Beispiel wird ein `WriteEventStream` Objekt erstellt, das den ARNs Kinesis-Stream und die IAM-Rolle speichert. Das `WriteEventStream`-Objekt wird an ein `PutEventStreamRequest`-Objekt übergeben, um Amazon Pinpoint für das Streamen von Ereignissen für eine bestimmte Anwendung zu konfigurieren. Das `PutEventStreamRequest`-Objekt wird an die `putEventStream`-Methode des Amazon-Pinpoint-Client übergeben.

Sie können einen Kinesis-Stream mehreren Anwendungen zuordnen. Wenn Sie dies tun, sendet Amazon Pinpoint in base64 verschlüsselte Ereignisdaten von jeder Anwendung an den Stream, sodass Sie die Daten als Sammlung analysieren können. Die folgende Beispielmethode akzeptiert eine Liste von Anwendungen (App) IDs und verwendet die vorherige Beispielmethode,`createEventStream`, um jeder Anwendung einen Stream zuzuweisen:

```
public List<PutEventStreamResult> createEventStreamFromAppList(
        AmazonPinpoint pinClient, List<String> appIDs, 
        String streamArn, String roleArn) {

    return appIDs.stream()
            .map(appId -> createEventStream(pinClient, appId, streamArn, 
                    roleArn))
            .collect(Collectors.toList());
}
```

Sie können zwar einen Stream mehreren Anwendungen zuweisen, jedoch nicht mehrere Streams einer Anwendung.

# App-Event-Datenstream von Amazon Pinpoint
<a name="event-streams-data-app"></a>

Nachdem Sie Ihre Anwendung (App) in Amazon Pinpoint integriert und Event-Streaming eingerichtet haben, ruft Amazon Pinpoint die Benutzeraktivitäten, benutzerdefinierten Ereignisse und Nachrichtenzustellungsdaten Ihrer App von dem Ziel ab, das Sie bei der Einrichtung angegeben haben, sodass Sie sie einsehen können. Informationen darüber, wie Sie das Event-Streaming einrichten, damit Sie Ihre Veranstaltungsdaten einsehen können, 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 ein App-Ereignis
<a name="event-streams-data-app-example"></a>

Das JSON-Objekt für ein App-Ereignis enthält die Daten, die im folgenden Beispiel gezeigt werden.

```
{
  "event_type": "_session.stop",
  "event_timestamp": 1487973802507,
  "arrival_timestamp": 1487973803515,
  "event_version": "3.0",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "cognito_identity_pool_id": "us-east-1:a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
    "package_name": "main.page",
    "sdk": {
      "name": "aws-sdk-mobile-analytics-js",
      "version": "0.9.1:2.4.8"
    },
    "title": "title",
    "version_name": "1.0",
    "version_code": "1"
  },
  "client": {
    "client_id": "m3n4o5p6-a1b2-c3d4-e5f6-g7h8i9j0k1l2",
    "cognito_id": "us-east-1:i9j0k1l2-m3n4-o5p6-a1b2-c3d4e5f6g7h8"
  },
  "device": {
    "locale": {
      "code": "en_US",
      "country": "US",
      "language": "en"
    },
    "make": "generic web browser",
    "model": "Unknown",
    "platform": {
      "name": "android",
      "version": "10.10"
    }
  },
  "session": {
    "session_id": "f549dea9-1090-945d-c3d1-e4967example",
    "start_timestamp": 1487973202531,
    "stop_timestamp": 1487973802507
  },
  "attributes": {},
  "metrics": {}
}
```

## App-Ereignisattribute
<a name="event-streams-data-app-attributes"></a>

In diesem Abschnitt werden die Attribute definiert, die im vorherigen Beispiel des App-Event-Streams enthalten sind.


| 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-app.html)  | 
| event\$1timestamp | Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. | 
| 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)](#event-streams-data-app-attributes-application). | 
| client | Informationen über den Endpunkt, der das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle [Client](#event-streams-data-app-attributes-client). | 
| device | Informationen über das Gerät, das das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle [Device (Gerät)](#event-streams-data-app-attributes-device). | 
| session | Informationen über die Sitzung, die das Ereignis generiert hat. Weitere Informationen finden Sie in der Tabelle [Session (Sitzung)](#event-streams-data-app-attributes-session). | 
| attributes |  Attribute, die dem Ereignis zugeordnet sind. Bei Ereignissen, die von Ihren Apps gemeldet werden, enthält dieses Objekt benutzerdefinierte Attribute, die Sie definieren.  | 
| metrics | Metriken, die sich auf das Ereignis beziehen. Sie können Ihre Apps optional so konfigurieren, dass benutzerdefinierte Metriken an Amazon Pinpoint gesendet werden. | 

### Anwendung
<a name="event-streams-data-app-attributes-application"></a>

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.  | 
| cognito\$1identity\$1pool\$1id |  Die ID des Amazon-Cognito-Identitätspools, dem der Endpunkt zugeordnet ist.  | 
| package\$1name |  Der Name des App-Pakets, z.B. `com.example.my_app`.  | 
| sdk |  Informationen über das SDK, das zum Melden des Ereignisses verwendet wurde. Weitere Informationen finden Sie in der Tabelle [SDK](#event-streams-data-app-attributes-application-sdk).  | 
| title |  Gibt den Namen der App an.  | 
| version\$1name |  Der Name der Version der App, z. B. `V2.5`.  | 
| version\$1code |  Die Versionsnummer der App, z. B. `3`.  | 

#### SDK
<a name="event-streams-data-app-attributes-application-sdk"></a>

Enthält Informationen über das SDK, das zum Melden des Ereignisses verwendet wurde.


| Attribut | Beschreibung | 
| --- | --- | 
| name | Der Name des SDKs, das zum Melden des Ereignisses verwendet wurde. | 
| version | Die Version des SDKs. | 

### Client
<a name="event-streams-data-app-attributes-client"></a>

Enthält Informationen über den Endpunkt, der das Ereignis generiert hat.


| Attribut | Beschreibung | 
| --- | --- | 
| client\$1id | Die ID des Endpunkts. | 
| cognito\$1id | Das Amazon-Cognito-ID-Token, das dem Endpunkt zugeordnet ist. | 

### Gerät
<a name="event-streams-data-app-attributes-device"></a>

Enthält Informationen über das Gerät des Endpunkts, der das Ereignis generiert hat.


| Attribut | Beschreibung | 
| --- | --- | 
| locale |  Enthält Informationen über die Sprach- und Regioneneinstellungen für das Gerät des Endpunkts. Weitere Informationen finden Sie in der Tabelle [Locale (Gebietsschema)](#event-streams-data-app-attributes-device-locale).  | 
| make | Der Hersteller des Endpunktgeräts. | 
| model | Der Modellbezeichner des Endpunktgeräts. | 
| platform |  Informationen zum Betriebssystem auf dem Endpunktgerät. Weitere Informationen finden Sie in der Tabelle [Platform (Plattform)](#event-streams-data-app-attributes-device-platform).  | 

#### Gebietsschema
<a name="event-streams-data-app-attributes-device-locale"></a>

Enthält Informationen über die Sprach- und Regioneneinstellungen für das Gerät des Endpunkts.


| Attribut | Beschreibung | 
| --- | --- | 
| code | Die Gebietsschema-ID, die dem Gerät zugeordnet ist. | 
| country | Das Land oder die Region, die dem Gebietsschema des Geräts zugeordnet ist. | 
| language | Die Sprache, die dem Gebietsschema des Geräts zugeordnet ist. | 

#### Plattform
<a name="event-streams-data-app-attributes-device-platform"></a>

Enthält Informationen zum Betriebssystem auf dem Endpunktgerät.


| Attribut | Beschreibung | 
| --- | --- | 
| name | Der Name des Betriebssystems auf dem Gerät. | 
| version | Das Betriebssystemversion des Geräts. | 

### Sitzung
<a name="event-streams-data-app-attributes-session"></a>

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


| Attribut | Beschreibung | 
| --- | --- | 
| session\$1id | Eine eindeutige ID, die die Sitzung identifiziert. | 
| start\$1timestamp | Das Datum und die Uhrzeit, zu der die Sitzung begann, angezeigt als Unix-Zeit in Millisekunden. | 
| stop\$1timestamp | Das Datum und die Uhrzeit, zu der die Sitzung beendet wurde, angezeigt als Unix-Zeit in Millisekunden. | 

# Datenstream zu Kampagnenereignissen von Amazon Pinpoint
<a name="event-streams-data-campaign"></a>

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
<a name="event-streams-data-campaign-example"></a>

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
<a name="event-streams-data-campaign-attributes"></a>

In diesem Abschnitt werden die Attribute definiert, die im Ereignis-Stream der Kampagne enthalten sind.


| Attribut | Description | 
| --- | --- | 
| 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-campaign.html)  | 
| event\$1timestamp | Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. | 
| 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)](#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\$1context | 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
<a name="event-streams-data-campaign-attributes-application"></a>

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


| Attribut | Description | 
| --- | --- | 
| app\$1id |  Die eindeutige ID des Amazon-Pinpoint-Projekts, das das Ereignis gemeldet hat.  | 
| sdk |  Das SDK, das zum Melden des Ereignisses verwendet wurde.   | 

### Attribute
<a name="event-streams-data-campaign-attributes-attrs"></a>

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


| Attribut | Description | 
| --- | --- | 
| treatment\$1id |  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\$1activity\$1id | Die eindeutige ID, die Amazon Pinpoint generiert, wenn das Ereignis eintritt. | 
| delivery\$1type |  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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 
| campaign\$1id |  Die eindeutige ID der Kampagne, von der die Nachricht gesendet wurde.  | 
| campaign\$1send\$1status | Gibt den Status der Kampagne für den Zielendpunkt an. Mögliche Werte sind:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 

### Client
<a name="event-streams-data-campaign-attributes-client"></a>

Enthält Informationen über den Endpunkt, auf den die Kampagne ausgerichtet war.


| Attribut | Description | 
| --- | --- | 
| client\$1id | Die ID des Endpunkts, an den die Kampagne gesendet wurde. | 

# Reiseereignisdaten von Amazon Pinpoint
<a name="event-streams-data-journey"></a>

Wenn Sie eine Journey veröffentlichen, kann Amazon Pinpoint Ereignisdaten für E-Mail-, SMS-, Push- und benutzerdefinierte Nachrichten streamen, die Sie von der Journey aus versenden. Nachdem Sie das Event-Streaming eingerichtet haben, ruft Amazon Pinpoint die Daten von dem Ziel ab, 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 ein Journey-Event
<a name="event-streams-data-journey-example"></a>

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
<a name="event-streams-data-journey-attributes"></a>

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\$1type |  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\$1timestamp | Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. | 
| 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)](#event-streams-data-journey-attributes-application). | 
| client | Informationen über den Endpunkt, dem das Ereignis zugeordnet ist. Weitere Informationen finden Sie in der Tabelle [Client](#event-streams-data-journey-attributes-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)](#event-streams-data-journey-attributes-attrs).  | 
| client\$1context | 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
<a name="event-streams-data-journey-attributes-application"></a>

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.   | 

### Client
<a name="event-streams-data-journey-attributes-client"></a>

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


| Attribut | Beschreibung | 
| --- | --- | 
| client\$1id | Die ID des Endpunkts. | 

### Attribute
<a name="event-streams-data-journey-attributes-attrs"></a>

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


| Attribut | Beschreibung | 
| --- | --- | 
| journey\$1run\$1id |  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\$1send\$1status |  Gibt den Zustellungsstatus der Nachricht an, die dem Ereignis zugeordnet ist. Mögliche Werte sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/event-streams-data-journey.html)  | 
| journey\$1id |  Die eindeutige ID der Journey, die das Ereignis generiert hat.  | 
| journey\$1activity\$1id |  Die eindeutige ID der Journey-Aktivität, die das Ereignis generiert hat.  | 
| journey\$1activity\$1type |  Der Journey-Aktivitätstyp des Ereignisses. Dies kann **EMAIL**, **SMS**, **PUSH**, **CONTACT\$1CENTER** oder **CUSTOM** sein.   **VOICE** ist kein unterstützter Journey-Aktivitätstyp. **Das `journey_activity_type` Feld ist nicht vorhanden, wenn es auf QUIET\$1TIME\$1WAIT\$1FINISHED gesetzt ist. `journey_send_status`**   | 
|  `journey_send_status_message`  | Die Beschreibung des Status des Sendeereignisses. | 
| journey\$1send\$1status\$1code | Der HTTP-Statuscode der Anfrage. | 

# E-Mail-Ereignisdatenstream von Amazon Pinpoint
<a name="event-streams-data-email"></a>

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
<a name="event-streams-data-email-example"></a>

**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
<a name="event-streams-data-email-attributes"></a>

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
<a name="event-streams-data-email-attributes-application"></a>

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
<a name="event-streams-data-email-attributes-attrs"></a>

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

#### Kampagne
<a name="event-streams-data-email-attributes-attrs-campaigns"></a>

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
<a name="event-streams-data-email-attributes-attrs-journey"></a>

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
<a name="event-streams-data-email-attributes-client"></a>

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
<a name="event-streams-data-email-attributes-facets"></a>

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
<a name="event-streams-data-email-attributes-mail"></a>

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.  | 

# SMS-Ereignisdatenstream von Amazon Pinpoint
<a name="event-streams-data-sms"></a>

Wenn der SMS-Kanal für ein Projekt aktiviert ist, kann Amazon Pinpoint Ereignisdaten über SMS-Nachrichtenzustellungen für das Projekt 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) 

**Anmerkung**  
Es kann bis zu 72 Stunden dauern, bis SMS-Ereignisse empfangen werden, die von Mobilfunkanbietern generiert werden. Sie sollten daher nicht verwendet werden, um festzustellen, ob es bei der Zustellung ausgehender Nachrichten zu Verzögerungen gekommen ist. Wenn Amazon Pinpoint nach 72 Stunden kein letztes Ereignis von einem Transporteur erhalten hat, gibt der Service automatisch einen UNKNOWN record\$1status zurück, da Amazon Pinpoint nicht weiß, was mit dieser Nachricht passiert ist.

## Beispiel für ein SMS-Ereignis
<a name="event-streams-data-sms-example"></a>

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

```
{
  "event_type": "_SMS.SUCCESS",
  "event_timestamp": 1553104954322,
  "arrival_timestamp": 1553104954064,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "123456789012"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "sender_request_id": "565d4425-4b3a-11e9-b0a5-example",
    "campaign_activity_id": "cbcfc3c5e3bd48a8ae2b9cb41example",
    "origination_phone_number": "+12065550142",
    "destination_phone_number": "+14255550199",
    "record_status": "DELIVERED",
    "iso_country_code": "US",
    "treatment_id": "0",
    "number_of_message_parts": "1",
    "message_id": "1111-2222-3333",
    "message_type": "Transactional",
    "campaign_id": "52dc44b35c4742c98c5935269example"
    "customer_context": "{\"userId\":\"user-id-4\"}"
  },
  "metrics": {
    "price_in_millicents_usd": 645.0
  },
  "awsAccountId": "123456789012"
}
```

## SMS-Ereignisattribute
<a name="event-streams-data-sms-attributes"></a>

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 SMS-Nachrichten senden.


**Ereignis**  

| 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-sms.html)  | 
| event\$1timestamp | Der Zeitpunkt, zu dem das Ereignis gemeldet wurde, angezeigt als Unix-Zeit in Millisekunden. | 
| 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)](#event-streams-data-sms-attributes-application). | 
| 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](#event-streams-data-sms-attributes-client). | 
| device | Informationen über das Gerät, das das Ereignis gemeldet hat. Weitere Informationen finden Sie in der Tabelle [Device (Gerät)](#event-streams-data-sms-attributes-device). Bei SMS-Ereignissen ist dieses Objekt leer. | 
| session | Bei SMS-Ereignissen 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-sms-attributes-attrs).  | 
| metrics |  Zusätzliche Metriken, die dem Ereignis zugeordnet sind. Weitere Informationen finden Sie in der Tabelle [Metrics (Metriken)](#event-streams-data-sms-attributes-metrics).  | 
| awsAccountId |  Die ID des AWS Kontos, das zum Senden der Nachricht verwendet wurde.  | 

### Anwendung
<a name="event-streams-data-sms-attributes-application"></a>

Enthält Informationen über das Amazon-Pinpoint-Projekt, dem das Ereignis zugeordnet ist, und gegebenenfalls das SDK, das zum Melden des Ereignisses verwendet wurde.


| 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-SMS-Nachricht durch einen direkten Amazon-Pinpoint-API-Aufruf oder über die Amazon-Pinpoint-Konsole senden, ist dieses Objekt leer.  | 

### Attribute
<a name="event-streams-data-sms-attributes-attrs"></a>

Enthält Informationen zu den Attributen, die dem Ereignis zugeordnet sind.


| Attribut | Beschreibung | 
| --- | --- | 
| sender\$1request\$1id | Eine eindeutige ID, die der Anforderung zum Senden der SMS-Nachricht zugeordnet ist. | 
| campaign\$1activity\$1id | Die eindeutige ID der Aktivität innerhalb der Kampagne. | 
| origination\$1phone\$1number |  Die Telefonnummer, von der die Nachricht gesendet wurde.  | 
| destination\$1phone\$1number |  Die Telefonnummer, an die Sie versucht haben, die Nachricht zu senden.  | 
| record\$1status |  Zusätzliche Informationen über den Status der Nachricht. Mögliche Werte sind: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/developerguide/event-streams-data-sms.html)  | 
| iso\$1country\$1code |  Das Land , die der Telefonnummer des Empfängers zugeordnet ist, im ISO 3166-1 Alpha-2-Format.  | 
| treatment\$1id |  Die ID der Nachrichtenbehandlung, wenn die Nachricht in einer A/B-Kampagne gesendet wurde.  | 
| treatment\$1id |  Wenn die Nachricht mit einer A/B-Testkampagne gesendet wurde, stellt dieser Wert die Behandlungsnummer der Nachricht dar. Für Transaktions-SMS-Nachrichten ist dieser Wert 0.  | 
| number\$1of\$1message\$1parts |  Die Anzahl der Mitteilungsteile, die Amazon Pinpoint erstellt hat, um die Nachricht zu senden. Im Allgemeinen können SMS-Nachrichten nur 160 GSM-7-Zeichen oder 67 Nicht-GSM-Zeichen enthalten, obwohl diese Limits je nach Land variieren können. Wenn Sie eine Nachricht senden, die diese Limits überschreitet, teilt Amazon Pinpoint die Nachrichten automatisch in kleinere Teile auf. Wir erstellen Rechnungen basierend auf der Anzahl der Mitteilungsteile, die Sie senden.  | 
| message\$1id |  Die eindeutige ID, die Amazon Pinpoint generiert, wenn die Nachricht akzeptiert wird.  | 
| message\$1type |  Der Nachrichtentyp. Mögliche Werte sind **Promotional** und **Transactional**. Sie geben diesen Wert an, wenn Sie eine Kampagne erstellen oder wenn Sie Transaktionsnachrichten mithilfe des [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)Vorgangs in der Amazon Pinpoint Pinpoint-API versenden.  | 
| campaign\$1id |  Die eindeutige ID der Amazon-Pinpoint-Kampagne, die die Nachricht gesendet hat.  | 
| customer\$1context | Eine JSON-Zeichenfolge mit dem Inhalt der `Context` Map, die in einem Amazon Pinpoint [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)Pinpoint-Vorgang gesendet wurde. | 

### Client
<a name="event-streams-data-sms-attributes-client"></a>

Enthält Informationen zum App-Client, der auf dem Gerät installiert ist, das das Ereignis gemeldet hat.


| Attribut | Beschreibung | 
| --- | --- | 
| client\$1id |  Bei Ereignissen, die von Apps generiert werden, ist dieser Wert die eindeutige ID des App-Clients, der auf dem Gerät installiert ist. Diese ID wird automatisch von der AWS Mobile SDK for iOS und der AWS Mobile SDK für Android generiert. Bei Ereignissen, die generiert werden, wenn Sie Kampagnen und Transaktionsnachrichten senden, entspricht dieser Wert der ID des Endpunkts, an den Sie die Nachricht gesendet haben.  | 
| cognito\$1id | Die eindeutige ID, die dem App-Client im Amazon-Cognito-Identitätspool zugewiesen ist, der von Ihrer App genutzt wird | 

### Gerät
<a name="event-streams-data-sms-attributes-device"></a>

Enthält Informationen über das Gerät, das das Ereignis gemeldet hat.


| Attribut | Beschreibung | 
| --- | --- | 
| locale | Der Gerätestandort | 
| make | Der Gerätehersteller, beispielsweise Apple oder Samsung | 
| model | Das Gerätemodell, z. B. iPhone | 
| platform | Die Geräteplattform, z. B. ios oder android | 

### Metriken
<a name="event-streams-data-sms-attributes-metrics"></a>

Enthält Informationen zu Metriken, die dem Ereignis zugeordnet sind.


| Attribut | Beschreibung | 
| --- | --- | 
| price\$1in\$1millicents\$1usd | Der Betrag, den wir Ihnen für das Senden der Nachricht berechnet haben. Dieser Preis wird in Tausendstel eines US-Cents angegeben. Wenn der Wert dieses Attributs beispielsweise `645` lautet, wird Ihnen für das Senden der Nachricht 0,645 ¢ in Rechnung gestellt (645/1 000 = 0,645 ¢ = 0,00645 \$1).  Diese Eigenschaft wird nicht für Nachrichten mit dem `event_type` **\$1SMS.BUFFERED** angezeigt.   | 

# Löschen Sie einen Event-Stream aus Amazon Pinpoint
<a name="event-streams-disable"></a>

Wenn Sie einen Kinesis-Stream einer Anwendung zuweisen, können Sie Ereignis-Streaming für diese Anwendung deaktivieren. Amazon Pinpoint streamt die Ereignisse nicht mehr an Kinesis, aber Sie können die Ereignisanalysen mithilfe der Amazon-Pinpoint-Konsole anzeigen.

## AWS CLI
<a name="event-streams-disable-cli"></a>

Verwenden Sie den [-Befehl:`delete-event-stream`](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/delete-event-stream.html)

```
aws pinpoint delete-event-stream --application-id application-id
```

## AWS SDK für Java
<a name="event-streams-disable-java"></a>

Verwenden Sie die [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/DeleteEventStreamRequest.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/DeleteEventStreamRequest.html)Methode des Amazon Pinpoint Pinpoint-Clients:

```
pinClient.deleteEventStream(new DeleteEventStreamRequest().withApplicationId(appId));
```