Utilisation de l'analytique Amazon Pinpoint avec des groupes d'utilisateurs Amazon Cognito.

Les groupes d'utilisateurs Amazon Cognito sont intégrés à Amazon Pinpoint afin de fournir une analytique pour les groupes d'utilisateurs Amazon Cognito et d'enrichir les données utilisateur pour les campagnes Amazon Pinpoint. Amazon Pinpoint fournit une analytique et des campagnes ciblées pour susciter l'implication des utilisateurs dans les applications mobiles à l'aide de notifications push. Avec la prise en charge de l'analytique Amazon Pinpoint dans les groupes d'utilisateurs Amazon Cognito, vous pouvez suivre les inscriptions de groupes d'utilisateurs, les connexions, les échecs d'authentification, les utilisateurs actifs quotidiens et les utilisateurs actifs mensuels dans la console Amazon Pinpoint. Vous pouvez explorer les données pour différentes plages de dates ou divers attributs, comme la plateforme, les paramètres régionaux des appareils et la version des applications.

Vous pouvez également configurer des attributs personnalisés pour votre application. Ceux-ci peuvent ensuite être utilisés pour segmenter vos utilisateurs sur Amazon Pinpoint et leur envoyer des notifications push ciblées. Si vous choisissez Share user attribute data with Amazon Pinpoint (Partager les données d'attribut utilisateur avec Amazon Pinpoint) dans l'onglet Analytics (Analytique) de la console Amazon Cognito, Amazon Pinpoint créé des points de terminaison supplémentaires pour les adresses e-mail et les numéros de téléphone des utilisateurs.

Lorsque vous activez l'analytique Amazon Pinpoint dans votre groupe d'utilisateurs à l'aide de la console Amazon Cognito, vous créez également un rôle lié à un service qu'Amazon Cognito endosse lorsqu'il envoie une demande d'API à Amazon Pinpoint pour votre groupe d'utilisateurs. Le principal IAM qui ajoute votre configuration d'analyse doit disposer d'CreateServiceLinkedRoleautorisations. Le rôle lié au service est. AWSServiceRoleForAmazonCognitoIdp Pour plus d’informations, consultez Utilisation de rôles liés à un service pour Amazon Cognito .

Lorsque vous appliquez un AnalyticsConfiguration à votre client d'application dans l'API Amazon Cognito, vous pouvez attribuer un rôle IAM personnalisé pour Amazon Pinpoint et un ID externe pour endosser le rôle. Le rôle doit faire confiance au principal de service cognito-idp, et si la politique d'approbation de rôle nécessite un ID externe, celui-ci doit correspondre à votre AnalyticsConfiguration. Vous devez accorder les autorisations cognito-idp:Describe* de rôle, ainsi que les autorisations suivantes pour votre projet Amazon Pinpoint.

• mobiletargeting:UpdateEndpoint

• mobiletargeting:PutEvents

Disponibilité des régions Amazon Cognito et Amazon Pinpoint

Le tableau suivant indique les Région AWS mappages entre Amazon Cognito et Amazon Pinpoint qui répondent à l'une des conditions suivantes.

• Vous ne pouvez utiliser un projet Amazon Pinpoint que dans la région USA Est (Virginie du Nord) (us-east-1).

• Vous pouvez utiliser un projet Amazon Pinpoint dans la même région ou dans la région USA Est (Virginie du Nord) (us-east-1).

Par défaut, Amazon Cognito ne peut envoyer des données analytiques qu'à un projet Amazon Pinpoint dans la même Région AWS. Les exceptions à cette règle sont les régions figurant dans le tableau suivant et celles où Amazon Pinpoint n'est pas disponible.

Amazon Pinpoint n'est pas disponible dans les régions suivantes : Les groupes d'utilisateurs Amazon Cognito de ces régions ne prennent pas en charge l'analytique.

• Europe (Milan)

• Moyen-Orient (Bahreïn)

• Asie-Pacifique (Osaka)

• Israël (Tel Aviv)

• Afrique (Le Cap)

• Asie-Pacifique (Jakarta)

Le tableau montre la relation entre la région dans laquelle vous avez créé votre groupe d'utilisateurs Amazon Cognito et la région correspondante dans Amazon Pinpoint. Vous devez configurer votre projet Amazon Pinpoint dans une région disponible pour l'intégrer à Amazon Cognito.

Région du groupe d'utilisateurs Amazon Cognito	Régions du projet Amazon Pinpoint
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

Exemples de correspondances entre régions

• Si vous créez un groupe d'utilisateurs dans la région ap-northest-1, vous pouvez créer votre projet Amazon Pinpoint dans la région us-east-1.

• Si vous créez un groupe d'utilisateurs dans la région ap-south-1, vous pouvez créer votre projet Amazon Pinpoint dans la région us-east-1 ou ap-south-1.

Note

Pour tous, à l' Régions AWS exception de ceux du tableau précédent, Amazon Cognito ne peut utiliser un projet Amazon Pinpoint que dans la même région que votre groupe d'utilisateurs. Si Amazon Pinpoint n'est pas disponible dans la région où vous avez créé votre groupe d'utilisateurs et qu'elle ne figure pas dans le tableau, Amazon Cognito ne prend pas en charge l'analytique Amazon Pinpoint dans cette région. Pour obtenir des informations détaillées sur la Région AWS , consultez Points de terminaison et quotas Amazon Pinpoint.

Spécification des paramètres d'analytique Amazon Pinpoint (AWS Management Console)

Vous pouvez configurer votre groupe d'utilisateurs Amazon Cognito pour envoyer des données analytiques à Amazon Pinpoint. Amazon Cognito envoie des données analytiques à Amazon Pinpoint uniquement pour les utilisateurs locaux. Après avoir configuré votre groupe d'utilisateurs pour l'associer à un projet Amazon Pinpoint, vous devez inclureAnalyticsMetadata dans vos demandes d'API. Pour plus d’informations, consultez Intégration de votre application à Amazon Pinpoint.

Pour spécifier les paramètres d'analyse

1. Accédez à la console Amazon Cognito. Il se peut que vous soyez invité à saisir vos informations d'identification AWS .

2. Sélectionnez User Pools (Groupes d'utilisateurs) et choisissez un groupe d'utilisateurs existant dans la liste.

3. Choisissez l’onglet App integration (Intégration d’applications).

4. Sous App clients and analytics (Clients d'application et analytique), choisissez un nom de client d'application existant dans la liste.

5. Sous Pinpoint analytics (Analytique Pinpoint), choisissez Enable (Activer).

6. Choisissez un élément dans Pinpoint Region (Région Pinpoint).

7. Choisissez un élément dans Amazon Pinpoint project (Projet Amazon Pinpoint) ou sélectionnez Create Amazon Pinpoint project (Créer un projet Amazon Pinpoint).

   Note

   L'ID de projet Amazon Pinpoint est une chaîne de 32 caractères propre à votre projet Amazon Pinpoint. Il s'affiche dans la console Amazon Pinpoint.

   Vous pouvez mapper plusieurs applications Amazon Cognito à un seul projet Amazon Pinpoint. Cependant, chaque application Amazon Cognito ne peut être mappée qu'à un seul projet Amazon Pinpoint.

   Dans Amazon Pinpoint, chaque projet doit être une seule application. Par exemple, si un développeur de jeux possède deux jeux, chaque d'eux doit être un projet Amazon Pinpoint distinct, même si les deux utilisent le même groupe d'utilisateurs Amazon Cognito. Pour plus d'informations sur les projets Pinpoint, consultez Créer un projet dans Amazon Pinpoint.

8. Sous User data sharing (Partage de données utilisateur), choisissez Share user data with Amazon Pinpoint (Partager des données utilisateur avec Amazon Pinpoint) si vous souhaitez qu'Amazon Cognito envoie les adresses e-mail et les numéros de téléphone à Amazon Pinpoint et crée des points de terminaison supplémentaires pour les utilisateurs. Une fois le numéro de téléphone et l'adresse e-mail de vos utilisateurs vérifiés, Amazon Cognito les partage uniquement avec Amazon Pinpoint s'ils sont accessibles au compte utilisateur.

   Note

   Un point de terminaison identifie de façon unique un appareil d'utilisateur auquel vous pouvez envoyer des notifications push avec Amazon Pinpoint. Pour plus d'informations sur les points de terminaison, consultez Ajout de points de terminaison dans le Guide du développeur Amazon Pinpoint.

9. Sélectionnez Enregistrer les modifications.

Spécification des paramètres d'analyse (AWS CLI et AWS de l'API) d'Amazon Pinpoint

Utilisez les commandes suivantes pour spécifier les paramètres d'analytique Amazon Pinpoint pour votre groupe d'utilisateurs.

Pour spécifier les paramètres d'analyse de l'application cliente existante de votre groupe d'utilisateurs au moment de la création de l'application

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

• AWS API : CreateUserPoolClient

Pour mettre à jour les paramètres d'analyse de l'application cliente existante de votre groupe d'utilisateurs

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

• AWS API : UpdateUserPoolClient

Note

Amazon Cognito prend en charge les intégrations dans la région lorsque vous utilisez ApplicationArn

Intégration de votre application à Amazon Pinpoint

Vous pouvez publier des métadonnées analytiques dans Amazon Pinpoint pour des utilisateurs locaux Amazon Cognito dans l'API des groupes d'utilisateurs.

Utilisateurs locaux

Utilisateurs qui se sont inscrits pour obtenir un compte ou qui ont été créés dans votre groupe d'utilisateurs au lieu de se connecter via un fournisseur d'identité (IdP) tiers.

API des groupes d'utilisateurs

Les opérations que vous pouvez intégrer à un AWS SDK à l'aide d'une application dotée d'une interface utilisateur personnalisée. Vous ne pouvez pas transmettre de métadonnées analytiques pour des utilisateurs fédérés ou locaux qui se connectent via l'interface utilisateur hébergée. Pour obtenir la liste des opérations d'API des groupes d’utilisateurs, consultez Référence d'API Amazon Cognito.

Une fois que vous avez configuré votre groupe d'utilisateurs en vue d’une publication dans une campagne, Amazon Cognito transmet des métadonnées à Amazon Pinpoint pour les opérations d'API suivantes.

• AdminInitiateAuth

• AdminRespondToAuthChallenge

• ConfirmForgotPassword

• ConfirmSignUp

• ForgotPassword

• InitiateAuth

• ResendConfirmationCode

• RespondToAuthChallenge

• SignUp

Pour transmettre les métadonnées relatives à votre session utilisateur à votre campagne Amazon Pinpoint, incluez une valeur AnalyticsEndpointId dans le paramètre AnalyticsMetadata de votre demande d'API. JavaScript Par exemple, consultez Pourquoi les analyses de mon groupe d'utilisateurs Amazon Cognito n'apparaissent-elles pas sur mon tableau de bord Amazon Pinpoint ? dans le AWS Knowledge Center.