Verwenden von Amazon Pinpoint Analytics mit Amazon-Cognito-Benutzerpools

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-Analysen in Amazon-Cognito-Benutzerpools können Sie Anmeldungen von Benutzerpools, fehlgeschlagene Authentifizierungen, täglich aktive Benutzer (DAUs) und monatlich aktive Benutzer (MAUs) auf der Amazon-Pinpoint-Konsole nachverfolgen. 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 auf der Registerkarte Analytics (Analysen) in der Amazon-Cognito-Konsole Share user attribute data with Amazon Pinpoint (Benutzerattributdaten mit Amazon Pinpoint teilen) auswä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, 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 CreateServiceLinkedRoleBerechtigungen verfügen. Die mit dem Dienst verknüpfte Rolle ist. AWSServiceRoleForAmazonCognitoIdp Weitere Informationen finden Sie unter Verwendung von serviceverknüpften Rollen für Amazon Cognito.

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)

• Naher Osten (Bahrain)

• Asien-Pazifik (Osaka)

• Israel (Tel Aviv)

• Afrika (Kapstadt)

• Asien-Pazifik (Jakarta)

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.

Angeben von Amazon-Pinpoint-Analytics-Einstellungen (AWS Management Console)

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.

Einstellung der Analysen

1. Melden Sie sich bei der Amazon-Cognito-Konsole an. Sie werden möglicherweise aufgefordert, Ihre AWS -Anmeldeinformationen einzugeben.

2. Wählen Sie User Pools (Benutzerpools) und dann einen vorhandenen Benutzerpool aus der Liste aus.

3. Wählen Sie die Registerkarte App integration (Anwendungsintegration) aus.

4. Wählen Sie unter App Clients and Analytics (App-Clients und -Analysen) einen vorhandenen App client name (App-Client-Namen) aus der Liste aus.

5. Wählen Sie unter Pinpoint Analytics (Pinpoint-Analysen) die Option Enable (Aktivieren) aus.

6. Wählen Sie eine Pinpoint-Region aus.

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

8. 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 (Hinzufügen von Endpunkten) im Amazon-Pinpoint-Entwicklerhandbuch.

9. Wählen Sie Save Changes.

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: CreateUserPoolClient

Die Analyse-Einstellungen für die vorhandene Client-App Ihres Benutzerpools aktualisieren

• AWS CLI: aws cognito-idp update-user-pool-client

• AWS API: UpdateUserPoolClient

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 Analysemetadaten für verbundene oder lokale Benutzer übergeben, die sich über die gehostete Benutzeroberfläche anmelden. Eine Liste der Benutzerpool-API-Vorgänge finden Sie in der Amazon-Cognito-API-Referenz.

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? im AWS Knowledge Center.