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.
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 relacionadas con la participación de los usuarios, el alcance de las campañas y mucho más. Estas métricas, también denominadas indicadores clave de rendimiento (KPIs), son valores medibles que pueden ayudarle a supervisar y evaluar el rendimiento de sus proyectos, campañas y procesos.
Si lo utiliza APIs para consultar datos de análisis, puede analizarlos mediante la herramienta de informes que prefiera, sin tener que iniciar sesión en la consola de Amazon Pinpoint ni analizar datos de eventos sin procesar de fuentes como las transmisiones de Amazon Kinesis. Por ejemplo, puede crear un panel personalizado que muestre los resultados semanales de las campañas o que proporcione análisis detallados sobre las tasas de entrega de las campañas.
Puede consultar los datos mediante la API REST de Amazon Pinpoint, el AWS Command Line Interface (AWS CLI) o un AWS SDK. Para consultar los datos, envíe una solicitud a la API de Amazon Pinpoint y utilice los parámetros compatibles para especificar los datos que desee y los filtros que quiere aplicar. Después de enviar la consulta, Amazon Pinpoint devuelve los resultados de la consulta en una respuesta JSON. A continuación, puede transferir los resultados a otro servicio o aplicación para un análisis más exhaustivo, para su almacenamiento o para la generación de informes.
Amazon Pinpoint recopila y acumula automáticamente datos de todas las métricas compatibles para todos los proyectos, campañas y recorridos. Además, los datos se actualizan continuamente, con lo que el periodo de latencia de los datos es de tan solo dos horas aproximadamente. No obstante, tenga en cuenta que puede haber latencia de datos adicional para ciertas métricas. Esto se debe a que los datos de algunas métricas se basan en la información que recibimos de los proveedores de correo electrónico de los destinatarios. Algunos proveedores nos envían esta información inmediatamente, mientras que otros la envían con menos frecuencia.
Amazon Pinpoint almacena los datos durante 90 días. Para almacenar los datos durante más de 90 días o para acceder a los datos de análisis sin procesar en tiempo real, puede configurar un proyecto de Amazon Pinpoint para que transmita datos de eventos a Amazon Kinesis Data Streams o Amazon Data Firehose. Para obtener información sobre la configuración de secuencias de eventos, consulte Transmitir datos de eventos de aplicación a través de Kinesis y Firehose con Amazon Pinpoint.
Consultar componentes y parámetros de las métricas en Amazon Pinpoint
Para consultar los datos de una métrica, envíe una solicitud get al recurso de métricas adecuado de la API de Amazon Pinpoint. En la solicitud, para definir la consulta debe utilizar parámetros compatibles con los siguientes componentes de consulta:
-
Proyecto: especifique un proyecto proporcionando el ID del proyecto como valor del parámetro
application-id. Este parámetro es obligatorio para todas las métricas. -
Campaña: especifique una campaña proporcionando el ID de la campaña como valor del parámetro
campaign-id. Este parámetro solo es obligatorio para las métricas de campaña. -
Recorrido: especifique un recorrido proporcionando el ID del recorrido como valor del parámetro
journey-id. Este parámetro solo es necesario para métricas de interacción y ejecución de recorrido y para métricas de ejecución de actividades de recorrido. -
Actividad de recorrido: especifique una actividad de recorrido proporcionando el ID de la actividad de recorrido como valor del parámetro
journey-activity-id. Este parámetro solo es necesario para métricas de ejecución de actividades de recorrido. -
Intervalo de fechas: si lo desea, puede filtrar los datos por intervalo de fechas, indique la primera y la última fecha y la hora del intervalo de fechas mediante los parámetros de hora de inicio y finalización compatibles. Los valores deben estar en formato ISO 8601 extendido y utilizar la hora universal coordinada (UTC), por ejemplo,
2019-07-19T20:00:00Zpara el 19 de julio de 2019 a las 20:00 UTC.Los intervalos de fechas son inclusivos y deben tener 31 días naturales o menos. Además, la primera fecha y hora deben ser inferiores a 90 días desde el día actual. Si no especifica un intervalo de fechas, Amazon Pinpoint devuelve los datos de los 31 días naturales anteriores. Todos los parámetros del intervalo de fechas son compatibles con todas las métricas, excepto las métricas de ejecución de recorrido y las métricas de ejecución de actividades de recorrido.
-
Métrica: especifique la métrica proporcionando el nombre de la métrica como valor del parámetro
kpi-name. Este valor describe la métrica asociada y consta de dos o más términos, que se componen de caracteres alfanuméricos en minúsculas, separados por un guion. Algunos ejemplos sonemail-open-rateysuccessful-delivery-rate. Este parámetro es obligatorio para todas las métricas, excepto las métricas de ejecución de recorrido y las métricas de ejecución de actividades de recorrido. Para obtener una lista completa de las métricas admitidas y del valorkpi-nameque se va a utilizar para cada una, consulte Métricas estándar para proyectos, campañas y recorridos.
Después de enviar la consulta, Amazon Pinpoint devuelve los resultados de la consulta en una respuesta JSON. En la respuesta, la estructura de los resultados varía según la métrica que consultó.
Algunas métricas proporcionan solo un valor, por ejemplo, la cantidad de mensajes que entregó una campaña. Otras métricas proporcionan varios valores y, por lo general, los agrupan por un campo relevante, por ejemplo, el número de mensajes que se entregaron en cada ejecución de una campaña, agrupados por ejecución de campaña. Si una métrica proporciona y agrupa varios valores, la respuesta JSON incluye un campo que indica qué campo se utilizó para agrupar los datos. Para obtener más información sobre la estructura de los resultados de la consulta, lea Usar resultados de consultas JSON.
