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. # Verwendung von Amazon Pinpoint für Benutzerpool-Analysen **Anmerkung** **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. Amazon-Cognito-Benutzertools sind in Amazon Pinpoint integriert, um Analysen für Amazon-Cognito-Benutzerpools bereitzustellen und die Benutzerdaten für Amazon-Pinpoint-Kampagnen zu ergänzen. Amazon Pinpoint bietet Analysen und gezielte Werbekampagnen, um die Nutzerbindung in mobilen Anwendungen mithilfe von Push-Benachrichtigungen zu unterstützen. Mit der Unterstützung von Amazon Pinpoint Analytics in Amazon Cognito Cognito-Benutzerpools können Sie Benutzerpool-Anmeldungen, Anmeldungen, fehlgeschlagene Authentifizierungen, täglich aktive Benutzer (DAUs) und monatlich aktive Benutzer (MAUs) in der Amazon Pinpoint Pinpoint-Konsole verfolgen. Sie können Daten für unterschiedliche Datenbereiche oder Attribute weiter aufschlüsseln, wie z. B. Geräteplattform, Gerätestandort und App-Version. Sie können auch benutzerdefinierte Attribute für Ihre App einrichten. Diese können dann verwendet werden, um Ihre Benutzer auf Amazon Pinpoint zu segmentieren und ihnen gezielte Push-Benachrichtigungen zu senden. Wenn Sie in der **Analytics-Konfiguration** für Ihren App-Client im Menü **App-Clients** in der **Amazon Cognito-Konsole Benutzerattributdaten mit Amazon Pinpoint teilen** wählen, erstellt Amazon Pinpoint zusätzliche Endpunkte für Benutzer-E-Mail-Adressen und Telefonnummern. Wenn Sie Amazon-Pinpoint-Analytics in Ihrem Benutzerpool mit der Amazon-Cognito-Konsole aktivieren, erstellen Sie auch eine [serviceverknüpfte Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions), die Amazon Cognito übernimmt, wenn Amazon Pinpoint eine API-Anfrage für Ihren Benutzerpool stellt. Der IAM-Principal, der Ihre Analytics-Konfiguration hinzufügt, muss über Berechtigungen verfügen. [CreateServiceLinkedRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateServiceLinkedRole.html) Die mit dem Dienst verknüpfte Rolle ist. [AWSServiceRoleForAmazonCognitoIdp](https://console.aws.amazon.com/iamv2/home?region=us-east-1#/roles/details/AWSServiceRoleForAmazonCognitoIdp) Weitere Informationen finden Sie unter [Verwendung von serviceverknüpften Rollen für Amazon Cognito](using-service-linked-roles.md). Wenn Sie in der Amazon-Cognito-API eine `AnalyticsConfiguration` auf Ihren App-Client anwenden, können Sie Amazon Pinpoint eine benutzerdefinierte IAM-Rolle und eine externe ID zuweisen, um die Rolle zu übernehmen. Die Rolle muss dem `cognito-idp`-Service-Prinzipal vertrauen, und wenn die Richtlinie zur Rollenvertraulichkeit eine externe ID erfordert, muss diese mit Ihrer `AnalyticsConfiguration` übereinstimmen. Sie müssen der Rolle `cognito-idp:Describe*`-Berechtigungen und die folgenden Berechtigungen für Ihr **Amazon-Pinpoint-Projekt** gewähren. + `mobiletargeting:UpdateEndpoint` + `mobiletargeting:PutEvents` ## Verfügbarkeit der Amazon-Cognito- und Amazon-Pinpoint-Regionen Die folgende Tabelle zeigt die AWS-Region Zuordnungen zwischen Amazon Cognito und Amazon Pinpoint, die eine der folgenden Bedingungen erfüllen. + Sie können nur ein Amazon-Pinpoint-Projekt in der Region USA Ost (Nord-Virginia) (us-east-1) verwenden. + Sie können ein Amazon-Pinpoint-Projekt in derselben Region *oder* in der Region USA Ost (Nord-Virginia) (us-east-1) verwenden. Standardmäßig kann Amazon Cognito Analysen nur an ein Amazon-Pinpoint-Projekt in derselben AWS-Region senden. Ausnahmen von dieser Regel sind die Regionen in der folgenden Tabelle und Regionen, in denen Amazon Pinpoint nicht verfügbar ist. Amazon Pinpoint ist in den folgenden Regionen verfügbar. Amazon-Cognito-Benutzerpools in diesen Regionen unterstützen keine Analysen. + Europa (Milan) + Middle East (Bahrain) + Asien-Pazifik (Osaka) + Israel (Tel Aviv) + Afrika (Kapstadt) + Asien-Pazifik (Jakarta) + Asien-Pazifik (Malaysia) Die Tabelle zeigt die Beziehung zwischen der Region, in der Sie Ihren Amazon-Cognito-Benutzerpool erstellt haben und die entsprechenden Region in Amazon Pinpoint. Sie müssen Ihr Amazon-Pinpoint-Projekt in einer verfügbaren Region konfigurieren, um es in Amazon Cognito zu integrieren. | Region mit dem Amazon-Cognito-Benutzerpool | Region für das Amazon-Pinpoint-Projekt | | --- | --- | | ap-northeast-1 | us-east-1 | | ap-northeast-2 | us-east-1 | | ap-south-1 | us-east-1, ap-south-1 | | ap-southeast-1 | us-east-1 | | ap-southeast-2 | us-east-1, ap-southeast-2 | | ca-central-1 | us-east-1 | | eu-central-1 | us-east-1, eu-central-1 | | eu-west-1 | us-east-1, eu-west-1 | | eu-west-2 | us-east-1 | | us-east-1 | us-east-1 | | us-east-2 | us-east-1 | | us-west-2 | us-east-1, us-west-2 | **Beispiele für Regionsmappings** + Wenn Sie einen Benutzerpool in ap-northest-1 erstellen, können Sie Ihr Amazon-Pinpoint-Projekt in us-east-1 erstellen. + Wenn Sie einen Benutzerpool in ap-south-1 erstellen, können Sie Ihr Amazon-Pinpoint-Projekt entweder in us-east-1 oder in ap-south-1 erstellen. **Anmerkung** Für alle AWS-Regionen außer denen in der obigen Tabelle kann Amazon Cognito nur ein Amazon Pinpoint Pinpoint-Projekt in derselben Region wie Ihr Benutzerpool verwenden. Wenn Amazon Pinpoint in der Region, in der Sie Ihren Benutzerpool erstellt haben, nicht verfügbar und nicht in der Tabelle aufgeführt ist, unterstützt Amazon Cognito keine Amazon-Pinpoint-Analysen in dieser Region. Ausführliche Informationen zu der AWS-Region finden Sie unter [Amazon-Pinpoint-Endpunkte und -Kontingente](https://docs.aws.amazon.com/general/latest/gr/pinpoint.html). ### Angeben von Amazon-Pinpoint-Analytics-Einstellungen (AWS-Managementkonsole) Sie können Ihren Amazon-Cognito-Benutzerpool so konfigurieren, dass Analysedaten an Amazon Pinpoint gesendet werden. Amazon Cognito sendet nur für lokale Benutzer Analysedaten an Amazon Pinpoint. Nachdem Sie Ihren Benutzerpool für die Verknüpfung mit einem Amazon-Pinpoint-Projekt konfiguriert haben, müssen Sie `AnalyticsMetadata` in Ihre API-Anforderungen aufnehmen. Weitere Informationen finden Sie unter [Integrieren Ihrer App in Amazon Pinpoint](#cognito-user-pools-pinpoint-integration-client). **Einstellung der Analysen** 1. Melden Sie sich bei der [Amazon-Cognito-Konsole](https://console.aws.amazon.com/cognito/home) an. Sie werden möglicherweise aufgefordert, Ihre AWS -Anmeldeinformationen einzugeben. 1. Wählen Sie **User Pools** (Benutzerpools) und dann einen vorhandenen Benutzerpool aus der Liste aus. 1. Wählen Sie das Menü **App-Clients** und wählen Sie den App-Client aus, den Sie aktualisieren möchten. 1. Wählen Sie auf der Registerkarte **Analytics** unter **Pinpoint Analytics** die Option **Aktivieren** aus. 1. Wählen Sie eine **Pinpoint-Region** aus. 1. Wählen Sie ein **Amazon-Pinpoint-Projekt** oder **Create Amazon Pinpoint project** (Amazon-Pinpoint-Projekt erstellen) aus. **Anmerkung** Die Amazon-Pinpoint-Projekt-ID ist eine für Ihr Amazon-Pinpoint-Projekt eindeutige 32 Zeichen lange Zeichenfolge. Sie wird in der Amazon-Pinpoint-Konsole aufgelistet. Sie können mehrere Amazon-Cognito-Apps auf ein einziges Amazon-Pinpoint-Projekt abbilden. Jede Amazon-Cognito-App kann jedoch nur auf ein Amazon-Pinpoint-Projekt abgebildet werden. In Amazon Pinpoint sollte jedes Projekts eine einzelne Anwendung sein. Wenn ein Spieleentwickler beispielsweise zwei Spiele hat, sollte jedes Spiel ein separates Amazon-Pinpoint-Projekt sein, auch wenn beide Spiele denselben Amazon-Cognito-Benutzerpool verwenden. Weitere Informationen zu Amazon-Pinpoint-Projekten finden Sie unter [Erstellen eines Projekts in Amazon Pinpoint.](https://docs.aws.amazon.com/push-notifications/latest/userguide/mobile-push.html#mobile-push-create-project) 1. Wählen Sie unter **User data sharing** (Teilen von Benutzerdaten) **Share user data with Amazon Pinpoint** (Benutzerdaten mit Amazon Pinpoint teilen) aus, wenn Amazon Cognito E-Mail-Adressen und Telefonnummern an Amazon Pinpoint senden und zusätzliche Endpunkte für Benutzer erstellen soll. Nachdem Ihre Benutzer die E-Mail-Adresse und Telefonnummer verifiziert haben, teilt Amazon Cognito diese nur mit Amazon Pinpoint, wenn sie für das Benutzerkonto verfügbar sind. **Anmerkung** Ein *Endpunkt* kennzeichnet auf eindeutige Weise ein Benutzergerät, zu dem Sie mit Amazon Pinpoint Push-Benachrichtigungen senden können. Weitere Informationen zu Endpunkten finden Sie unter [Addming endpoints](https://docs.aws.amazon.com/pinpoint/latest/developerguide/endpoints.html) (Hinzufügen von Endpunkten) im *Amazon-Pinpoint-Entwicklerhandbuch*. 1. Wählen Sie **Änderungen speichern ** aus. ### Angeben der Analyseeinstellungen (AWS CLI und der AWS API) von Amazon Pinpoint Verwenden Sie die folgenden Befehle für die Einstellungen der Amazon-Pinpoint-Analyse für Ihren Benutzerpool. **Die Analyse-Einstellungen für die vorhandene Client-App Ihres Benutzerpools beim Erstellen der App festlegen** + AWS CLI: `aws cognito-idp create-user-pool-client` + AWS API: [https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPoolClient.html](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateUserPoolClient.html) **Die Analyse-Einstellungen für die vorhandene Client-App Ihres Benutzerpools aktualisieren** + AWS CLI: `aws cognito-idp update-user-pool-client` + AWS API: [https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserPoolClient.html](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserPoolClient.html) **Anmerkung** Amazon Cognito unterstützt Integrationen in Regionen, wenn Sie `ApplicationArn` verwenden ## Integrieren Ihrer App in Amazon Pinpoint Sie können Analysemetadaten in Amazon Pinpoint für *lokale Benutzer* von Amazon Cognito über die *Benutzerpool-API* veröffentlichen. **Lokale Benutzer** Benutzer, die sich für ein Konto angemeldet haben oder in Ihrem Benutzerpool erstellt wurden, anstatt sich über einen externen Identitätsanbieter (IDP) anzumelden. **Benutzerpool-API** Die Operationen, die Sie mithilfe einer App mit einer benutzerdefinierten Benutzeroberfläche (UI) in ein AWS SDK integrieren können. Sie können keine Analyse-Metadaten für föderierte oder lokale Benutzer weitergeben, die sich über eine verwaltete Anmeldung anmelden. Eine Liste der Benutzerpool-API-Vorgänge finden Sie in der [Amazon-Cognito-API-Referenz](https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/Welcome.html). Nachdem Sie Ihren Benutzerpool für die Veröffentlichung in einer Kampagne konfiguriert haben, übergibt Amazon Cognito Metadaten für die folgenden API-Vorgänge an Amazon Pinpoint. + `AdminInitiateAuth` + `AdminRespondToAuthChallenge` + `ConfirmForgotPassword` + `ConfirmSignUp` + `ForgotPassword` + `InitiateAuth` + `ResendConfirmationCode` + `RespondToAuthChallenge` + `SignUp` Wenn Sie Metadaten über die Sitzung Ihres Benutzers an Ihre Amazon-Pinpoint-Kampagne übergeben möchten, nehmen Sie einen `AnalyticsEndpointId`-Wert in den `AnalyticsMetadata`-Parameter Ihrer API-Anfrage auf. Ein JavaScript Beispiel finden Sie unter [Warum erscheinen meine Amazon Cognito Cognito-Benutzerpool-Analysen nicht auf meinem Amazon Pinpoint Pinpoint-Dashboard](https://aws.amazon.com/premiumsupport/knowledge-center/pinpoint-cognito-user-pool-analytics/)? im *AWS Knowledge* Center.