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.
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, 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 Die mit dem Dienst verknüpfte Rolle ist. AWSServiceRoleForAmazonCognitoIdp
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)
-
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.
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
-
Melden Sie sich bei der Amazon-Cognito-Konsole
an. Sie werden möglicherweise aufgefordert, Ihre AWS -Anmeldeinformationen einzugeben. -
Wählen Sie User Pools (Benutzerpools) und dann einen vorhandenen Benutzerpool aus der Liste aus.
-
Wählen Sie das Menü App-Clients und wählen Sie den App-Client aus, den Sie aktualisieren möchten.
-
Wählen Sie auf der Registerkarte Analytics unter Pinpoint Analytics die Option Aktivieren aus.
-
Wählen Sie eine Pinpoint-Region aus.
-
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.
-
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.
-
Wählen Sie Änderungen speichern.
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 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.
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
