Utilisation d'Amazon Pinpoint pour l'analyse des groupes d'utilisateurs - Amazon Cognito

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation d'Amazon Pinpoint pour l'analyse des groupes d'utilisateurs

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. Grâce à la prise en charge des analyses Amazon Pinpoint dans les groupes d'utilisateurs Amazon Cognito, vous pouvez suivre les inscriptions aux groupes d'utilisateurs, les connexions, les échecs d'authentification, les utilisateurs actifs quotidiens () et les utilisateurs actifs mensuels DAUs () dans la console Amazon Pinpoint. MAUs 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 Amazon Pinpoint Analytics 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 assume lorsqu'il adresse une API demande à Amazon Pinpoint pour votre groupe d'utilisateurs. Le IAM principal qui ajoute votre configuration d'analyse doit disposer d'CreateServiceLinkedRoleautorisations. Le rôle lié au service est. AWSServiceRoleForAmazonCognitoIdp Pour de plus amples informations, veuillez consulter Utilisation de rôles liés à un service pour Amazon Cognito .

Lorsque vous appliquez un AnalyticsConfiguration à votre client d'application dans Amazon CognitoAPI, vous pouvez attribuer un IAM rôle personnalisé à Amazon Pinpoint et un identifiant externe pour assumer ce 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 l'inclure AnalyticsMetadata dans vos API demandes. Pour de plus amples informations, veuillez consulter 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 Amazon Pinpoint (AWS CLI et) AWS API

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
Pour mettre à jour les paramètres d'analyse de l'application cliente existante de votre groupe d'utilisateurs
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 les utilisateurs locaux d'Amazon Cognito dans les groupes d'utilisateurs. API

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.

Groupes d'utilisateurs API

Les opérations que vous pouvez intégrer à un AWS SDK, à l'aide d'une application dotée d'une interface utilisateur (UI) 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. Consultez le manuel Amazon Cognito API Reference pour obtenir la liste des opérations relatives aux groupes d'utilisateurs. API

Après avoir configuré votre groupe d'utilisateurs pour publier dans une campagne, Amazon Cognito transmet les métadonnées à Amazon Pinpoint pour les opérations suivantes. API

  • AdminInitiateAuth

  • AdminRespondToAuthChallenge

  • ConfirmForgotPassword

  • ConfirmSignUp

  • ForgotPassword

  • InitiateAuth

  • ResendConfirmationCode

  • RespondToAuthChallenge

  • SignUp

Pour transmettre les métadonnées relatives à la session de votre utilisateur à votre campagne Amazon Pinpoint, incluez une AnalyticsEndpointId valeur dans le AnalyticsMetadata paramètre de votre API demande. 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.