Utilisation de l'analytique Amazon Pinpoint avec des groupes d'utilisateurs Amazon Cognito. - 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 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 des autorisations CreateServiceLinkedRole. Le rôle lié à un 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 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 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.

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 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 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 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. Choisissez 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
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 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

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 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. 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 ? dans le Centre de connaissances AWS.

Configuration de l'analytique des groupe d'utilisateurs

Avec l'analytique Amazon Pinpoint, vous pouvez suivre les inscriptions de groupes d'utilisateurs Amazon Cognito, les connexions, les échecs d'authentification, les utilisateurs actifs quotidiennement et les utilisateurs actifs mensuellement. Vous pouvez également configurer des attributs d'utilisateurs spécifiques à votre application avec AWS Mobile SDK for Android ou AWS Mobile SDK for iOS. Ceux-ci peuvent ensuite être utilisés pour segmenter vos utilisateurs dans Amazon Pinpoint, et leur envoyer des notifications push ciblées.

Dans l'onglet Intégration d'application, sous Clients d'application et analytique, vous pouvez accéder à un client d'application existant ou en créer un nouveau. Sous la configuration du client d'application, vous pouvez spécifier un projet Amazon Pinpoint que vous souhaitez utiliser avec votre application. Pour plus d'informations, consultez Utilisation de l'analytique Amazon Pinpoint avec des groupes d'utilisateurs Amazon Cognito.

Note

Amazon Pinpoint est disponible dans plusieurs régions AWS en Amérique du Nord, en Europe, en Asie et en Océanie. Les régions Amazon Pinpoint incluent l'API Amazon Pinpoint. Si une région Amazon Pinpoint est prise en charge par Amazon Cognito, Amazon Cognito envoie des événements à des projets Amazon Pinpoint dans la même région Amazon Pinpoint. Si une région n'est pas prise en charge par Amazon Pinpoint, Amazon Cognito prend en charge uniquement l'envoi d'événements dans la région us-east-1. Pour obtenir des informations détaillées sur une région Amazon Pinpoint, consultez Points de terminaison et quotas Amazon Pinpoint et Utilisation de l'analytique Amazon Pinpoint avec des groupes d'utilisateurs Amazon Cognito.

Pour ajouter l'analytique et des campagnes
  1. Choisissez Ajouter l'analytique et des campagnes).

  2. Choisissez un client d'application Cognito dans la liste.

  3. Pour mapper votre application Amazon Cognito à un Projet Amazon Pinpoint, choisissez le projet Amazon Pinpoint dans la liste.

    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 les mêmes groupes d'utilisateurs Amazon Cognito.

  4. Choisissez Share user attribute data with Amazon Pinpoint (Partager les données d'attribut utilisateur avec Amazon Pinpoint) si vous souhaitez qu'Amazon Cognito envoie des adresses e-mail et numéros de téléphone à Amazon Pinpoint afin de créer des points de terminaison supplémentaires pour des utilisateurs.

    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 à Amazon Pinpoint dans le Guide du développeur Amazon Pinpoint.

  5. Saisissez un rôle IAM que vous avez déjà créé ou choisissez Create new role (Créer un nouveau rôle) pour créer un rôle dans la console IAM.

  6. Choisissez Enregistrer les modifications.

  7. Pour spécifier d'autres mappages d'application, choisissez Ajouter un mappage d'application.

  8. Choisissez Enregistrer les modifications.