Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
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 enlace, segmentos, campañas, recorridos y análisis). Para obtener más información, consulte el fin del soporte de Amazon Pinpoint. Nota: en lo APIs que respecta a los SMS, este cambio no afecta a los mensajes de voz, a las notificaciones push móviles, a las OTP y a la validación de números de teléfono, y son compatibles con la mensajería para el usuario AWS final.
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. Con el soporte analítico de Amazon Pinpoint en los grupos de usuarios de Amazon Cognito, puede realizar un seguimiento de las inscripciones, los inicios de sesión, las autenticaciones fallidas, los usuarios activos diarios () y los usuarios activos mensuales DAUs () en la consola de Amazon Pinpoint. MAUs 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 de usuario con Amazon Pinpoint en la configuración de Analytics del cliente de la aplicación en el menú Clientes de la aplicación de la consola de Amazon Cognito, Amazon Pinpoint crea puntos de enlace adicionales para las direcciones de correo electrónico y los números de teléfono de los usuarios.
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. El director de IAM que añade la configuración de análisis debe tener permisos. CreateServiceLinkedRole La función vinculada 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 Región de AWS las asignaciones 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 todos, Regiones de AWS excepto los de la tabla anterior, Amazon Cognito solo puede usar 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
-
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ú de clientes de aplicaciones y seleccione el cliente de aplicaciones que desee actualizar.
-
En la pestaña Análisis, en Análisis de Pinpoint, selecciona 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 de análisis (AWS CLI y AWS la API) de Amazon Pinpoint
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 AWS SDK mediante una aplicación con una interfaz de usuario (UI) personalizada. No puedes transferir metadatos de análisis a los usuarios federados o locales que inicien sesión mediante un inicio de sesión gestionado. 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 JavaScript ejemplo, consulte ¿Por qué los análisis de mi grupo de usuarios de Amazon Cognito no aparecen en mi panel de Amazon Pinpoint?
