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.
Disponibilité des régions Amazon Cognito et Amazon Pinpoint
Le tableau suivant présente les mappages Région AWS 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.
Note
Amazon Pinpoint n'est pas disponible dans les régions Europe (Milan) et Moyen-Orient (Bahreïn). Les groupes d'utilisateurs Amazon Cognito de ces régions ne prennent pas en charge l'analytique.
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 toutes les régions Régions AWS à l'exception de celles figurant dans le tableau précédent, Amazon Cognito peut uniquement utiliser un projet Amazon Pinpoint 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 n'envoie des données analytiques à Amazon Pinpoint que pour les utilisateurs natifs de votre groupe d'utilisateurs. Après avoir configuré votre groupe d'utilisateurs pour l'associer à un projet Amazon Pinpoint, vous devez inclureAnalyticsMetadata
dans vos demandes d'API. Pour de plus amples informations, veuillez consulter Intégration de votre application à Amazon Pinpoint.
Pour spécifier les paramètres d'analyse
-
Accédez à la console Amazon Cognito
. Il se peut que vous soyez invité à saisir vos informations d'identification AWS. -
Sélectionnez User Pools (Groupes d'utilisateurs) et choisissez un groupe d'utilisateurs existant dans la liste.
-
Choisissez l'onglet App integration (Intégration d'applications).
-
Sous App clients and analytics (Clients d'application et analytique), choisissez un nom de client d'application existant dans la liste.
-
Sous Pinpoint analytics (Analytique Pinpoint), choisissez Enable (Activer).
-
Choisissez un élément dans Pinpoint Region (Région Pinpoint).
-
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.
-
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.
-
Sélectionnez Save Changes (Enregistrer les modifications).
Spécification des paramètres d'analytique Amazon Pinpoint (AWS CLI et API AWS)
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 d'analyse sur Amazon Pinpoint pour des utilisateurs natifs Amazon Cognito dans l’API native.
- Utilisateurs natifs
-
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 native
-
Opérations que vous pouvez intégrer avec un kit SDK AWS, à l'aide d'une application dotée d'une interface utilisateur personnalisée. Vous ne pouvez pas transmettre de métadonnées d'analyse à des utilisateurs fédérés ou natifs qui se connectent via l'interface utilisateur hébergée. Pour obtenir une liste des opérations d’API, consultez la 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. Pour accéder à un exemple de JavaScript, veuillez consulter Pourquoi les analyses de mon groupe d'utilisateurs Amazon Cognito n'apparaissent-elles pas sur mon tableau de bord Amazon Pinpoint ?