Uso de Amazon Pinpoint para analizar grupos de usuarios
nota
Aviso de fin de soporte: el 30 de octubre de 2026, AWS finalizará el soporte para Amazon Pinpoint. Después del 30 de octubre de 2026, ya no podrá acceder a la consola de Amazon Pinpoint ni a los recursos de Amazon Pinpoint (puntos de conexión, segmentos, campañas, recorridos y análisis). Para obtener más información, consulte Fin de soporte de Amazon Pinpoint. Nota: Este cambio no afecta a las API relacionadas con los SMS, los mensajes de voz, las notificaciones push móviles, la OTP y la validación de números de teléfono, por lo que son compatibles con Mensajería para usuarios finales de AWS.
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 Compartir datos de atributos del usuario con Amazon Pinpoint en la configuración de Análisis del cliente de aplicación en el menú Clientes de aplicación, en 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
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)
-
Asia-Pacífico (Malasia)
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 (Consola de administración de AWS)
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
-
Diríjase a la consola de Amazon Cognito
. Es posible que se le soliciten sus credenciales de AWS. -
Seleccione User Pools (Grupos de usuarios) y elija un grupo de usuarios existente de la lista.
-
Elija el menú Clientes de aplicación y seleccione el cliente de aplicación que desee actualizar.
-
En la pestaña Análisis, en Análisis de Pinpoint, seleccione Activar.
-
Elija un valor de Pinpoint Region (Región de Pinpoint).
-
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.
-
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.
-
Seleccione Save changes (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 -
AWS API: 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 -
AWS API: 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 se pueden pasar metadatos analíticos para usuarios federados o locales que inician sesión a través del inicio de sesión administrado. 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?
