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
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 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 Berechtigungen verfügen. CreateServiceLinkedRole Die mit dem Dienst verknüpfte Rolle ist AWSServiceRoleForAmazonCognitoIdp
Wenn Sie eine AnalyticsConfiguration auf Ihren App-Client im Amazon Cognito anwendenAPI, 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 Pinpoint-Projekt konfiguriert haben, müssen Sie dies AnalyticsMetadata in Ihre API Anfragen 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 die Registerkarte App integration (Anwendungsintegration) aus.
-
Wählen Sie unter App Clients and Analytics (App-Clients und -Analysen) einen vorhandenen App client name (App-Client-Namen) aus der Liste aus.
-
Wählen Sie unter Pinpoint Analytics (Pinpoint-Analysen) die Option Enable (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 Amazon Pinpoint Pinpoint-Analyseeinstellungen (AWS CLI und AWS API)
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 Analyse-Metadaten für lokale Amazon Cognito Cognito-Benutzer in den Benutzerpools in Amazon Pinpoint veröffentlichen. API
- 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.
- Benutzerpools API
-
Die Operationen, die Sie mithilfe einer AWS SDK App mit einer benutzerdefinierten Benutzeroberfläche (UI) in eine 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 API Benutzerpool-Operationen finden Sie in der Amazon Cognito API Cognito-Referenz.
Nachdem Sie Ihren Benutzerpool für die Veröffentlichung in einer Kampagne konfiguriert haben, leitet Amazon Cognito Metadaten für die folgenden API Vorgänge an Amazon Pinpoint weiter.
-
AdminInitiateAuth -
AdminRespondToAuthChallenge -
ConfirmForgotPassword -
ConfirmSignUp -
ForgotPassword -
InitiateAuth -
ResendConfirmationCode -
RespondToAuthChallenge -
SignUp
Um Metadaten über die Sitzung Ihres Benutzers an Ihre Amazon Pinpoint Pinpoint-Kampagne zu übergeben, geben Sie einen AnalyticsEndpointId Wert in den AnalyticsMetadata Parameter Ihrer API Anfrage ein. Ein JavaScript Beispiel finden Sie unter Warum erscheinen meine Amazon Cognito Cognito-Benutzerpool-Analysen nicht auf meinem Amazon Pinpoint Pinpoint-Dashboard
