Consultar datos de análisis de Amazon Pinpoint para mensajes transaccionales

Además de utilizar las páginas de análisis de la consola Amazon Pinpoint, puede utilizar Amazon Pinpoint APIs Analytics para consultar los datos de análisis de un subconjunto de métricas estándar que proporcionan información sobre las tendencias de entrega e interacción de los mensajes transaccionales que se enviaron para un proyecto.

Cada una de estas métricas es un valor medible, también conocido como un indicador clave de rendimiento (KPI), que puede ayudarle a supervisar y evaluar el rendimiento de los mensajes transaccionales. Por ejemplo, puede usar una métrica para averiguar cuántos mensajes de correo electrónico o SMS transaccionales envió o cuántos de esos mensajes se entregaron a los destinatarios. Amazon Pinpoint recopila y agrega automáticamente estos datos para todos los correos electrónicos y mensajes SMS transaccionales que envíe para un proyecto. Almacena los datos durante 90 días.

Si utiliza Amazon Pinpoint Analytics APIs para consultar datos, puede elegir varias opciones que definan el alcance, los datos, la agrupación y los filtros de la consulta. Para ello, utilice parámetros que especifiquen el proyecto y la métrica que desea consultar, además de los filtros basados en fechas que desee aplicar.

En este tema se explica y se proporcionan ejemplos de cómo elegir estas opciones y consultar los datos de mensajes transaccionales de un proyecto.

Requisitos previos

Antes de consultar los datos de análisis de los mensajes transaccionales, ayuda a recopilar la siguiente información, que utilizará para definir la consulta:

• ID del proyecto: el identificador único del proyecto desde el que se enviaron los mensajes. En la API de Amazon Pinpoint, este valor se almacena en la propiedad application-id. En la consola de Amazon Pinpoint, este valor se muestra como ID de proyecto en la página Todos los proyectos.

• Intervalo de fechas: de forma opcional, la primera y la última fecha y hora del intervalo de fechas para el que se van a consultar los datos. Los intervalos de fechas son inclusivos y deben tener 31 días naturales o menos. Además, deben comenzar en menos de 90 días a partir del día actual. Si no especifica un intervalo de fechas, Amazon Pinpoint consulta automáticamente los datos de los 31 días naturales anteriores.

• Métrica: el nombre de la métrica que se va a consultar y, más específicamente, el valor kpi-name de la métrica. Para obtener una lista completa de las métricas admitidas y el valor kpi-name de cada una de ellas, consulte Métricas estándar para proyectos, campañas y recorridos.

También ayuda determinar si desea agrupar los datos por un campo relevante. Si lo hace, para simplificar el análisis y los informes, elija una métrica diseñada para agrupar datos de forma automática. Por ejemplo, Amazon Pinpoint proporciona varias métricas estándar que informan del número de mensajes SMS transaccionales que se entregaron a los destinatarios. Una de estas métricas agrupa automáticamente los datos por fecha (txn-sms-delivered-grouped-by-date). Otra métrica agrupa automáticamente los datos por país o región (txn-sms-delivered-grouped-by-country). Una tercera métrica simplemente devuelve un único valor: el número de mensajes que se entregaron a los destinatarios (txn-sms-delivered). Si no puede encontrar una métrica estándar que agrupe los datos de la forma que quiere, puede desarrollar una serie de consultas que devuelvan los datos que desee. A continuación, desglose o combine manualmente los resultados de la consulta en grupos personalizados de diseño propio.

Por último, es importante verificar que está autorizado para acceder a los datos que desea consultar. Para obtener más información, consulte Políticas de IAM para consultar datos de análisis de Amazon Pinpoint.