Uso del análisis de Amazon Pinpoint con grupos de usuarios de Amazon Cognito

Los grupos de usuarios de Amazon Cognito se integran con Amazon Pinpoint para proporcionar análisis de dichos grupos y enriquecer los datos de los usuarios para las campañas de Amazon Pinpoint. Con Amazon Pinpoint, se ofrecen análisis y campañas dirigidas a públicos específicos para mejorar la interacción de los usuarios con las aplicaciones móviles mediante notificaciones push. Gracias a la compatibilidad de los análisis de Amazon Pinpoint con los grupos de usuarios de Amazon Cognito, puede realizar seguimiento de los registros de los grupos de usuarios, los inicios de sesión, las autenticaciones fallidas, los usuarios activos diarios (DAU) y los usuarios activos mensuales (MAU) desde la consola de Amazon Pinpoint. Puede analizar los datos por intervalo de fechas o por atributos como plataforma del dispositivo, idioma del dispositivo o versión de la aplicación.

También puede configurar atributos personalizados para su aplicación. Estos atributos pueden usarse posteriormente para segmentar los usuarios en Amazon Pinpoint y enviarles notificaciones push específicas. Si selecciona Share user attribute data with Amazon Pinpoint (Compartir datos de atributos del usuario con Amazon Pinpoint) en la pestaña Analytics (Análisis) de la consola de Amazon Cognito, Amazon Pinpoint crea puntos de conexión adicionales para las direcciones de correo electrónico y los números de teléfono.

Al activar los análisis de Amazon Pinpoint en el grupo de usuarios con la consola de Amazon Cognito, también crea un rol vinculado a un servicio que Amazon Cognito asume cuando realiza una solicitud a la API a Amazon Pinpoint para el grupo de usuarios. La entidad principal de IAM que agrega la configuración de análisis debe tener permisos CreateServiceLinkedRole. El rol vinculado al servicio es AWSServiceRoleForAmazonCognitoIdp. Para obtener más información, consulte Uso de roles vinculados a servicios para Amazon Cognito.

Cuando aplique AnalyticsConfiguration al cliente de la aplicación en la API de Amazon Cognito, puede asignar un rol de IAM personalizado para Amazon Pinpoint y un ID externo para asumir el rol. El rol debe confiar en la entidad principal del servicio cognito-idp  y, si la política de confianza del rol requiere un ID externo, debe coincidir con AnalyticsConfiguration. Debe conceder los permisos cognito-idp:Describe* del rol y los siguientes permisos para el proyecto de Amazon Pinpoint.

• mobiletargeting:UpdateEndpoint

• mobiletargeting:PutEvents

Disponibilidad de regiones de Amazon Cognito y Amazon Pinpoint

En la siguiente tabla se muestran las asignaciones de Región de AWS entre Amazon Cognito y Amazon Pinpoint que cumplen una de las siguientes condiciones.

• Solo puede utilizar un proyecto de Amazon Pinpoint en la región de Este de EE. UU. (Norte de Virginia) (us-east-1).

• Puede utilizar un proyecto de Amazon Pinpoint en la misma región o en la región de Este de EE. UU. (Norte de Virginia) (us-east-1)

De forma predeterminada, Amazon Cognito solo puede enviar análisis a un proyecto de Amazon Pinpoint en la misma Región de AWS. Las excepciones a esta regla son las regiones de la tabla siguiente y las regiones en las que Amazon Pinpoint no está disponible.

Amazon Pinpoint ya no está disponible en las siguientes regiones. Los grupos de usuarios de Amazon Cognito de estas regiones no admiten análisis.

• Europe (Milan)

• Middle East (Bahrain)

• Asia-Pacífico (Osaka)

• Israel (Tel Aviv)

• África (Ciudad del Cabo)

• Asia-Pacífico (Yakarta)

En la tabla se muestra la relación entre la región en la que creó su grupo de usuarios de Amazon Cognito y la región correspondiente en Amazon Pinpoint. Debe configurar su proyecto de Amazon Pinpoint en una región disponible para integrarlo con Amazon Cognito.

Región del grupo de usuarios de Amazon Cognito	Región del proyecto de 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

Ejemplos de mapeo de regiones

• Si crea un grupo de usuarios en ap-northeast-1, podrá crear su proyecto de Amazon Pinpoint en us-east-1.

• Si crea un grupo de usuarios en ap-south-1, puede crear el proyecto de Amazon Pinpoint en us-east-1 o ap-south-1.

nota

Para todas las Regiones de AWS, excepto las de la tabla anterior, Amazon Cognito solo puede utilizar un proyecto de Amazon Pinpoint en la misma región que su grupo de usuarios. Si Amazon Pinpoint no está disponible en la región en la que ha creado su grupo de usuarios y no aparece en la tabla, significa que Amazon Cognito no es compatible con los análisis de Amazon Pinpoint en esa región. Para obtener información detallada sobre las Región de AWS, consulte Amazon Pinpoint endpoints and quotas (Puntos de conexión y cuotas de Amazon Pinpoint).

Especificación de la configuración del análisis de Amazon Pinpoint (AWS Management Console)

Puede configurar su grupo de usuarios de Amazon Cognito para enviar datos de análisis a Amazon Pinpoint. Amazon Cognito solo envía datos de análisis a Amazon Pinpoint para los usuarios locales. Después de configurar su grupo de usuarios para asociarlo a un proyecto de Amazon Pinpoint, deberá incluir AnalyticsMetadata en sus solicitudes de API. Para obtener más información, consulte Integración de su aplicación con Amazon Pinpoint.

Para definir los ajustes de análisis

1. Diríjase a la consola de Amazon Cognito. Es posible que se le soliciten sus credenciales de AWS.

2. Seleccione User Pools (Grupos de usuarios) y elija un grupo de usuarios existente de la lista.

3. Elija la pestaña App integration (Integración de aplicaciones).

4. En App clients and analytics (Clientes y análisis de aplicaciones), elija un valor de App client name (Nombre de cliente de aplicación) existente de la lista.

5. En Pinpoint analytics (Análisis de Pinpoint), elija Enable (Activar).

6. Elija un valor de Pinpoint Region (Región de Pinpoint).

7. Elija un valor de Amazon Pinpoint project (Proyecto de Amazon Pinpoint) o seleccione Create Amazon Pinpoint project (Crear proyecto de Amazon Pinpoint).

   nota

   El ID de proyecto de Amazon Pinpoint es una cadena de 32 caracteres única para cada proyecto de Amazon Pinpoint. Este aparece en la consola de Amazon Pinpoint.

   Puede mapear varias aplicaciones de Amazon Cognito a un único proyecto de Amazon Pinpoint. Sin embargo, no puede mapear una aplicación de Amazon Cognito a más de un proyecto de Amazon Pinpoint.

   En Amazon Pinpoint, cada proyecto debe ser una sola aplicación. Por ejemplo, si un desarrollador de juegos tiene dos juegos, cada uno debe ser un proyecto de Amazon Pinpoint distinto, incluso si en ambos juegos se utiliza el mismo grupo de usuarios de Amazon Cognito. Para obtener más información sobre los proyectos de Amazon Pinpoint, consulte Creación de un proyecto en Amazon Pinpoint.

8. En User data sharing (Uso compartido de datos de usuario), elija Share user data with Amazon Pinpoint (Compartir datos de usuario con Amazon Pinpoint) si desea que Amazon Cognito envíe direcciones de correo electrónico y números de teléfono a Amazon Pinpoint y cree puntos de conexión adicionales para los usuarios. Después de que sus usuarios verifiquen su dirección de correo electrónico y su número de teléfono, Amazon Cognito solo los comparte con Amazon Pinpoint si están disponibles en la cuenta de usuario.

   nota

   Con el punto de enlace, se identifica de forma exclusiva el dispositivo de un usuario al que puede enviar notificaciones push con Amazon Pinpoint. Para obtener más información sobre los puntos de enlace, consulte Adición de puntos de enlace en la Guía para desarrolladores de Amazon Pinpoint.

9. Elija Guardar cambios.

Especificación de la configuración del análisis de Amazon Pinpoint (AWS CLI y la API de AWS)

Utilice los siguientes comandos con el fin de especificar la configuración del análisis de Amazon Pinpoint para su grupo de usuarios.

Para especificar la configuración de análisis para la aplicación cliente existente del grupo de usuarios en momento de crear dicha aplicación

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

• API de AWS: CreateUserPoolClient

Para actualizar la configuración de análisis para la aplicación cliente existente del grupo de usuarios

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

• API de AWS: UpdateUserPoolClient

nota

Amazon Cognito admite integraciones dentro de las regiones cuando se utiliza ApplicationArn

Integración de su aplicación con Amazon Pinpoint

Puede publicar metadatos de análisis en Amazon Pinpoint para usuarios locales de Amazon Cognito en la API del grupo de usuarios.

Usuarios locales

Los usuarios que se registraron para crear una cuenta o que se crearon en su grupo de usuarios en lugar de iniciar sesión mediante un proveedor de identidades (IdP) externo.

API de grupos de usuarios

Las operaciones que puede integrar con un SDK de AWS, mediante una aplicación con una interfaz de usuario (UI) personalizada. No puede transferir los metadatos de análisis de los usuarios federados o locales que inician sesión a través de la interfaz de usuario alojada. Consulte la Referencia de la API de Amazon Cognito para una lista de las operaciones de la API de los grupos de usuarios.

Tras configurar su grupo de usuarios para publicar en una campaña, Amazon Cognito pasa los metadatos a Amazon Pinpoint para las siguientes operaciones de la API.

• AdminInitiateAuth

• AdminRespondToAuthChallenge

• ConfirmForgotPassword

• ConfirmSignUp

• ForgotPassword

• InitiateAuth

• ResendConfirmationCode

• RespondToAuthChallenge

• SignUp

Para transferir metadatos sobre la sesión de su usuario a su campaña de Amazon Pinpoint, incluya un valor AnalyticsEndpointId en el parámetro AnalyticsMetadata de tu solicitud de API. Para ver un ejemplo de JavaScript, consulte ¿Por qué no aparecen los análisis de mi grupo de usuarios de Amazon Cognito en mi panel de Amazon Pinpoint? en el AWSCentro de conocimientos.

Configuración de análisis de grupo de usuarios

Con el análisis de Amazon Pinpoint, puede realizar seguimiento de los registros, inicios de sesión y errores de autenticación de los grupos de usuario de Amazon Cognito, así como de los usuarios activos diarios (DAU) y mensuales (MAU). También puede utilizar AWS Mobile SDK for Android o AWS Mobile SDK for iOS para configurar atributos de usuario que sean específicos de su aplicación. Estos atributos pueden usarse posteriormente para segmentar los usuarios en Amazon Pinpoint y enviarles notificaciones push específicas.

En la pestaña Integración de aplicaciones en Clientes de aplicaciones y análisis, puede ir a un cliente de aplicaciones existente o crear uno nuevo. En la configuración del cliente de aplicaciones, puede especificar un proyecto de Amazon Pinpoint que desee usar con la aplicación. Para obtener más información, consulte Uso del análisis de Amazon Pinpoint con grupos de usuarios de Amazon Cognito.

nota

Amazon Pinpoint está disponible en varias regiones de AWS en América del Norte, Europa, Asia y Oceanía. Las regiones de Amazon Pinpoint incluyen la API de Amazon Pinpoint. Si Amazon Cognito admite una región de Amazon Pinpoint, enviará eventos a proyectos de Amazon Pinpoint dentro de la misma región de Amazon Pinpoint. Si una región no es compatible con Amazon Pinpoint, Amazon Cognito solo admitirá el envío de eventos en us-east-1. Para obtener información detallada sobre la región de Amazon Pinpoint, consulte Cuotas y puntos de enlace de Amazon Pinpoint y Uso de Amazon Pinpoint Analytics con grupos de usuarios de Amazon Cognito.

Para añadir análisis y campañas

1. Elija Add analytics and campaigns (Añadir análisis y campañas).

2. Elija un valor de Cognito app client (Cliente de aplicación de Cognito) en la lista.

3. Para mapear la aplicación de Amazon Cognito a un proyecto de Amazon Pinpoint, elija el proyecto de Amazon Pinpoint de la lista.

   nota

   El ID de proyecto de Amazon Pinpoint es una cadena de 32 caracteres única para cada proyecto de Amazon Pinpoint. Aparece en la consola de Amazon Pinpoint.

   Puede mapear varias aplicaciones de Amazon Cognito a un único proyecto de Amazon Pinpoint. Sin embargo, no puede mapear una aplicación de Amazon Cognito a más de un proyecto de Amazon Pinpoint.

   En Amazon Pinpoint, cada proyecto debe ser una sola aplicación. Por ejemplo, si un desarrollador de juegos tiene dos juegos, cada uno debe ser un proyecto de Amazon Pinpoint diferente, incluso si en ambos juegos se utiliza el mismo grupo de usuarios de Amazon Cognito.

4. Elija Share user attribute data with Amazon Pinpoint (Compartir datos de atributos de usuario con Amazon Pinpoint) si desea que Amazon Cognito envíe las direcciones de correo electrónico y los números de teléfono a Amazon Pinpoint a fin de crear otros puntos de enlace para los usuarios.

   nota

   Un punto de conexión identifica de forma exclusiva un dispositivo de un usuario al que puede enviar notificaciones push con Amazon Pinpoint. Para obtener más información sobre los puntos de conexión, consulte Adición de puntos de conexión en la Guía para desarrolladores de Amazon Pinpoint.

5. Ingrese un rol de IAM que ya haya creado o elija Create new role (Crear nuevo rol) para crear uno nuevo en la consola de IAM.

6. Elija Guardar cambios.

7. Para definir asignaciones de aplicación adicionales, elija Add app mapping (Añadir asignación de aplicación).

8. Elija Guardar cambios.