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 el análisis de grupos de usuarios
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 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 su 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 API solicitud a Amazon Pinpoint para su grupo de usuarios. El IAM director que añada la configuración de análisis debe tener permisos. CreateServiceLinkedRole La función vinculada al servicio es. AWSServiceRoleForAmazonCognitoIdp
Al aplicar una AnalyticsConfiguration al cliente de su aplicación en Amazon CognitoAPI, puede asignar una IAM función personalizada a Amazon Pinpoint y un ID externo para que asuma la función. 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.
-
Europa (Milán)
-
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 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 el grupo de usuarios para asociarlo a un proyecto de Amazon Pinpoint, debe incluirlo AnalyticsMetadata en sus API solicitudes. 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 la pestaña Integración de aplicaciones.
-
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.
-
En Pinpoint analytics (Análisis de Pinpoint), elija Enable (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.
-
Elija Guardar cambios.
Especificar la configuración de análisis de Amazon Pinpoint (AWS CLI y) AWS API
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 los usuarios locales de Amazon Cognito en los grupos de usuarios. API
- 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.
- Grupos de usuarios API
-
Las operaciones que puede integrar con una AWS SDK, 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 APIreferencia de Amazon Cognito para obtener una lista de las operaciones de los grupos API de usuarios.
Tras configurar el grupo de usuarios para publicarlos en una campaña, Amazon Cognito pasa los metadatos a Amazon Pinpoint para las siguientes operaciones. API
-
AdminInitiateAuth -
AdminRespondToAuthChallenge -
ConfirmForgotPassword -
ConfirmSignUp -
ForgotPassword -
InitiateAuth -
ResendConfirmationCode -
RespondToAuthChallenge -
SignUp
Para pasar los metadatos sobre la sesión de su usuario a su campaña de Amazon Pinpoint, incluya un AnalyticsEndpointId valor en el AnalyticsMetadata parámetro de su API solicitud. 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?
