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 Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analysen) zugreifen. Weitere Informationen finden Sie unter Ende des Supports von Amazon Pinpoint. Hinweis: APIs In Bezug auf SMS sind Sprach-, Handy-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.

Richten Sie Amazon Pinpoint ein, um App-Ereignisdaten über Amazon Kinesis oder Amazon Data Firehose zu streamen

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 im Amazon-Pinpoint-Benutzerhandbuch.

Voraussetzungen

Die Beispiele in diesem Abschnitt erfordern die folgende Eingabe:

AWS CLI

Das folgende AWS CLI Beispiel verwendet den Befehl. put-event-stream 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

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.