**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](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **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.
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.
# Consultar datos de análisis de Amazon Pinpoint
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](event-streams.md).
## 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:00Z` para 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 son `email-open-rate` y `successful-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 valor `kpi-name` que se va a utilizar para cada una, consulte [Métricas estándar para proyectos, campañas y recorridos](analytics-standard-metrics.md).
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](analytics-query-results.md).
# Políticas de IAM para consultar datos de análisis de Amazon Pinpoint
Con la API de Amazon Pinpoint, puede consultar los datos de análisis de un subconjunto de métricas estándar, también denominadas *indicadores clave de rendimiento (KPIs)*, que se aplican a los proyectos, campañas y recorridos de Amazon Pinpoint. Estas métricas pueden ayudarle a supervisar y evaluar el rendimiento de los proyectos, las campañas y los recorridos.
Para administrar el acceso a estos datos, puede crear políticas AWS Identity and Access Management (de IAM) que definan los permisos para las funciones de IAM o los usuarios que están autorizados a acceder a los datos. Para permitir el control detallado del acceso a estos datos, Amazon Pinpoint proporciona varias acciones distintas que se pueden especificar en las políticas de IAM. Hay una acción determinada para ver los datos de análisis en la consola de Amazon Pinpoint (`mobiletargeting:GetReports`) y hay otras acciones para acceder a los datos de análisis mediante programación con la API de Amazon Pinpoint.
Para crear políticas de IAM que gestionen el acceso a los datos de análisis, puede utilizar la Consola de administración de AWS, la o la API AWS CLI de IAM. Tenga en cuenta que la pestaña **Editor visual** en la Consola de administración de AWS actualmente no incluye acciones para ver o consultar los datos de análisis de Amazon Pinpoint. Sin embargo, puede agregar las acciones necesarias a las políticas de IAM manualmente desde la pestaña **JSON** de la consola.
Por ejemplo, la siguiente política permite el acceso programático a todos los datos de análisis de todos sus proyectos, campañas y recorridos en todas las regiones: AWS
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryAllAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:*:111122223333:apps/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/kpis/*",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:*:111122223333:apps/*/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
¿Dónde *accountId* está el ID de tu AWS cuenta?
Sin embargo, recomendamos que las políticas se creen según el principio de *privilegios mínimos*. En otras palabras, debe crear políticas que incluyan solo los permisos necesarios para realizar una tarea específica. Para respaldar esta práctica e implementar un control más detallado, puede restringir el acceso programático a los datos de análisis únicamente para un proyecto concreto en una AWS región específica, por ejemplo:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryProjectAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetApplicationDateRangeKpi",
"mobiletargeting:GetCampaignDateRangeKpi",
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/*/activities/*/execution-metrics"
]
}
]
}
```
------
Donde:
+ *region*es el nombre de la AWS región que aloja el proyecto.
+ *accountId*es el ID AWS de tu cuenta.
+ *projectId*es el identificador del proyecto al que quieres proporcionar acceso.
Del mismo modo, la política de ejemplo siguiente permite el acceso mediante programación a los datos de análisis solo para una campaña concreta:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryCampaignAnalytics",
"Effect": "Allow",
"Action": "mobiletargeting:GetCampaignDateRangeKpi",
"Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/campaigns/campaignId/kpis/*"
}
]
}
```
------
Donde:
+ *region*es el nombre de la AWS región que aloja el proyecto.
+ *accountId*es tu Cuenta de AWS ID.
+ *projectId*es el identificador del proyecto asociado a la campaña.
+ *campaignId*es el identificador de la campaña a la que quieres proporcionar acceso.
Y la siguiente política de ejemplo permite el acceso mediante programación a todos los datos de análisis, tanto datos de interacción como de ejecución, de un recorrido particular y las actividades que lo componen:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "QueryJourneyAnalytics",
"Effect": "Allow",
"Action": [
"mobiletargeting:GetJourneyDateRangeKpi",
"mobiletargeting:GetJourneyExecutionMetrics",
"mobiletargeting:GetJourneyExecutionActivityMetrics"
],
"Resource": [
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/kpis/*",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/execution-metrics",
"arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/journeys/journeyId/activities/*/execution-metrics"
]
}
]
}
```
------
Donde:
+ *region*es el nombre de la AWS región que aloja el proyecto.
+ *accountId*es el ID AWS de tu cuenta.
+ *projectId*es el identificador del proyecto asociado al viaje.
+ *journeyId*es el identificador del viaje al que quieres dar acceso.
Para obtener una lista completa de las acciones de la API de Amazon Pinpoint que puede utilizar en las políticas de IAM, consulte [Acciones de Amazon Pinpoint para las políticas de IAM](permissions-actions.md). Para obtener más información sobre cómo crear y administrar políticas de IAM, consulte la [Guía del usuario de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/).
# Métricas estándar que se aplican a los proyectos, campañas y recorridos de Amazon Pinpoint
Puede usar Amazon Pinpoint Analytics APIs para consultar datos de análisis de un subconjunto de métricas estándar que se aplican a los proyectos, campañas y recorridos de Amazon Pinpoint. Estas métricas, también denominadas *indicadores clave de rendimiento (KPIs)*, son valores medibles que pueden ayudarle a supervisar y evaluar el rendimiento de los proyectos, las campañas y las trayectorias.
Amazon Pinpoint proporciona acceso mediante programación a los datos de análisis de varios tipos de métricas estándar:
+ **Métricas de aplicaciones**: estas métricas proporcionan información sobre las tendencias de todas las campañas y mensajes transaccionales asociados a un proyecto, también denominado *aplicación*. Por ejemplo, puede utilizar una métrica de aplicación para ver un desglose del número de mensajes de la campaña que abrieron los destinatarios de cada campaña asociada a un proyecto.
+ **Métricas de campaña**: estas métricas proporcionan información sobre el rendimiento de las campañas individuales. Puede utilizar una métrica de campaña para, por ejemplo, determinar el número de puntos de enlace al que se envió un mensaje de una campaña o sobre el número de mensajes entregados a los puntos de enlace.
+ **Métricas de participación en recorridos**: estas métricas proporcionan información sobre el rendimiento de los recorridos individuales. Por ejemplo, puede utilizar una métrica de interacción del recorrido para obtener un desglose del número de mensajes abiertos por los participantes en cada actividad de un recorrido.
+ **Métricas de ejecución en recorridos**: estas métricas proporcionan información sobre las tendencias de participación en los recorridos individuales. Por ejemplo, puede utilizar una métrica de ejecución de recorrido para determinar cuántos participantes han iniciado un recorrido.
+ **Métricas de ejecución de actividades de los recorridos**: estas métricas proporcionan información sobre las tendencias de participación en los recorridos individuales. Por ejemplo, puede utilizar una métrica de ejecución de actividades de recorrido para determinar cuántos participantes han iniciado una actividad y cuántos participantes han completado cada ruta de una actividad.
Los temas de esta sección enumeran y describen las métricas individuales que puede consultar para cada tipo de métrica.
**Topics**
+ [Métricas de aplicación de Amazon Pinpoint para campañas](application-metrics-campaigns.md)
+ [Métricas de aplicación de Amazon Pinpoint para mensajes de correo electrónico transaccionales](application-metrics-txn-email.md)
+ [Métricas de aplicación de Amazon Pinpoint para mensajes SMS transaccionales](application-metrics-txn-sms.md)
+ [Métricas de campañas de Amazon Pinpoint](campaign-metrics.md)
+ [Métricas de interacción de recorrido de Amazon Pinpoint](journey-metrics-engagement-email.md)
+ [Métricas de ejecución de recorrido de Amazon Pinpoint](journey-metrics-execution.md)
+ [Métricas de ejecución de actividades de recorrido de Amazon Pinpoint](journey-metrics-activity-execution.md)
+ [Métricas de ejecución de recorrido y campaña de Amazon Pinpoint](journey-run-metrics-activity-execution.md)
# Métricas de aplicación de Amazon Pinpoint para campañas
En la siguiente tabla se muestran y describen las métricas de aplicación estándar que puede consultar para evaluar todas las campañas asociadas a un proyecto de Amazon Pinpoint. Para consultar los datos de estas métricas, utilice el recurso [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) de la API de Amazon Pinpoint. En la tabla, la columna **kpi-name** indica el valor que se debe utilizar para el parámetro `kpi-name` en la consulta.
| Métrica | Kpi-name | Description (Descripción) |
| --- | --- | --- |
| Porcentaje de entregas | `successful-delivery-rate` | Para todas las campañas que están asociadas con un proyecto, el porcentaje de mensajes que se entregaron a los destinatarios. Esta métrica se calcula como el número de mensajes enviados por todas las campañas de un proyecto y entregados a los destinatarios, dividido entre el número de mensajes enviados por todas esas campañas. |
| Porcentaje de entregas, agrupadas por fecha | `successful-delivery-rate-grouped-by-date` | Para todas las campañas que están asociadas a un proyecto, el porcentaje de mensajes que se proporcionaron a los destinatarios cada día del intervalo de fechas especificado. Esta métrica se calcula como el número de mensajes enviados por todas las campañas de un proyecto y entregados a los destinatarios, dividido por el número de mensajes enviados por todas esas campañas, durante cada día del intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Porcentaje de correo electrónicos abiertos | `email-open-rate` | Para todas las campañas que están asociadas con un proyecto, el porcentaje de mensajes de correo electrónico que abrieron los destinatarios. Esta métrica se calcula como el número de mensajes de correo electrónico enviados por todas las campañas de un proyecto y abiertos por los destinatarios, dividido por el número de mensajes de correo electrónico enviados por todas esas campañas y entregados a los destinatarios. |
| Porcentaje de correos electrónicos abiertos, agrupados por campaña | `email-open-rate-grouped-by-campaign` | Para cada campaña asociada a un proyecto, el porcentaje de mensajes de correo electrónico abiertos por los destinatarios. Esta métrica se calcula como el número de mensajes de correo electrónico enviados por una campaña y abiertos por los destinatarios, dividido por el número de mensajes de correo electrónico enviados por la campaña y entregados a los destinatarios. Los resultados de la consulta de esta métrica se agrupan por ID de campaña (`CampaignId`), que es una cadena que identifica de forma inequívoca una campaña. |
| Entregas a puntos de enlace | `unique-deliveries` | Para todas las campañas que están asociadas con un proyecto, el número de puntos de enlace distintos a los que se entregaron mensajes. |
| Entregas a puntos de enlace, agrupadas por campaña | `unique-deliveries-grouped-by-campaign` | Para cada campaña asociada a un proyecto, el número de puntos de enlace distintos a los que se entregaron mensajes. Los resultados de la consulta de esta métrica se agrupan por ID de campaña (`CampaignId`), que es una cadena que identifica de forma inequívoca una campaña. |
| Entregas a puntos de enlace, agrupadas por fecha | `unique-deliveries-grouped-by-date` | Para todas las campañas que están asociadas con un proyecto, el número de puntos de enlace distintos a los que entregaron mensajes cada día del intervalo de tiempo especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Mensajes entregados, agrupados por campaña | `successful-deliveries-grouped-by-campaign` | Para cada campaña asociada a un proyecto, el número de mensajes que se entregaron a los destinatarios. Esta métrica se calcula como el número de mensajes enviados por una campaña, menos el número de mensajes enviados por la campaña que no se pudieron entregar a los destinatarios debido a un rebote permanente. Los resultados de la consulta de esta métrica se agrupan por ID de campaña (`CampaignId`), que es una cadena que identifica de forma inequívoca una campaña. |
| Porcentaje de notificaciones push abiertas | `push-open-rate` | Para todas las campañas que están asociadas con un proyecto, el porcentaje de notificaciones push que abrieron los destinatarios. Esta métrica se calcula como el número de notificaciones push enviadas por todas las campañas de un proyecto y abiertas por los destinatarios, dividido entre el número de notificaciones push enviadas por todas esas campañas y entregadas a los destinatarios. |
| Porcentaje de notificaciones push abiertas, agrupadas por campaña | `push-open-rate-grouped-by-campaign` | Para cada campaña asociada a un proyecto, el porcentaje de notificaciones push que abrieron los destinatarios. Esta métrica se calcula como el número de notificaciones push enviadas por una campaña y abiertas por los destinatarios, dividido entre el número de notificaciones push enviadas por la campaña y entregadas a los destinatarios. Los resultados de la consulta de esta métrica se agrupan por ID de campaña (`CampaignId`), que es una cadena que identifica de forma inequívoca una campaña. |
# Métricas de aplicación de Amazon Pinpoint para mensajes de correo electrónico transaccionales
En la siguiente tabla se muestran y describen las métricas de aplicaciones estándar que puede consultar para monitorear las tendencias de todos los mensajes de correo electrónico transaccionales asociados a un proyecto de Amazon Pinpoint. Para consultar los datos de estas métricas, utilice el recurso [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) de la API de Amazon Pinpoint. En la tabla, la columna **kpi-name** indica el valor que se debe utilizar para el parámetro `kpi-name` en la consulta.
Tenga en cuenta que estas métricas no proporcionan datos sobre los mensajes de correo electrónico enviados por las campañas. Únicamente proporcionan datos sobre los mensajes de correo electrónico de transacciones. Para consultar los datos de mensajes enviados por una o varias campañas, utilice una [métrica de campaña ](campaign-metrics.md) o una [una métrica de aplicación para campañas](application-metrics-campaigns.md).
| Métrica | Kpi-name | Description (Descripción) |
| --- | --- | --- |
| Clics | `txn-emails-clicked` | El número de veces que los destinatarios hicieron clic en los enlaces del mensaje. Si un único destinatario hizo clic en varios enlaces del mensaje o hizo clic varias veces en el mismo enlace, cada clic se incluye en el recuento. |
| Clics, agrupados por fecha | `txn-emails-clicked-grouped-by-date` | El número de veces que los destinatarios han hecho clic en enlaces en los mensajes, para cada día en el intervalo de fechas especificado. Si un único destinatario hizo clic en varios enlaces del mensaje o hizo clic varias veces en el mismo enlace, cada clic se incluye en el recuento. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Complaint rate (Tasa de reclamaciones) | `txn-emails-complaint-rate` | El porcentaje de mensajes notificados por los destinatarios como correo electrónico no solicitado o no deseado. Esta métrica se calcula como el número de mensajes notificados por los destinatarios como correo electrónico no solicitado o no deseado, dividido por el número de mensajes enviados. |
| Tasa de reclamaciones, agrupada por fechas | `txn-emails-complaint-rate-grouped-by-date` | El porcentaje de mensajes notificados por los destinatarios como correo electrónico no solicitado o no deseado, para cada día en el intervalo de fechas especificado. Esta métrica se calcula como el número de mensajes notificados por los destinatarios como correo electrónico no solicitado o no deseado, dividido por el número de mensajes enviados, para cada día en el intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Reclamos | `txn-emails-with-complaints` | El número de mensajes notificados por los destinatarios como correo electrónico no solicitado o no deseado. |
| Reclamaciones, agrupadas por fechas | `txn-emails-with-complaints-grouped-by-date` | El número de mensajes notificados por los destinatarios como correo electrónico no solicitado o no deseado, para cada día en el intervalo de fechas especificado.Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Entregas | `txn-emails-delivered` | El número de mensajes que se entregaron a los destinatarios. Esta métrica se calcula como el número de mensajes que se enviaron, menos el número de mensajes que no se pudieron entregar debido a un rebote temporal o permanente o porque se rechazaron. Se rechaza un mensaje si Amazon Pinpoint determina que el mensaje contiene malware. Amazon Pinpoint no intenta enviar mensajes rechazados. |
| Entregas, agrupadas por fechas | `txn-emails-delivered-grouped-by-date` | El número de mensajes que se entregaron a los destinatarios, para cada día en el intervalo de fechas especificado. Esta métrica se calcula como el número de mensajes que se enviaron, menos el número de mensajes que no se pudieron entregar debido a un rebote temporal o permanente o porque se rechazaron, para cada día en el intervalo de fechas especificado. Se rechaza un mensaje si Amazon Pinpoint determina que el mensaje contiene malware. Amazon Pinpoint no intenta enviar mensajes rechazados. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Porcentaje de entregas | `txn-emails-delivery-rate` | El porcentaje de mensajes que se entregaron a los destinatarios. Esta métrica se calcula como el número de mensajes enviados y entregados a los destinatarios, dividido por el número de mensajes enviados. |
| Porcentaje de entregas, agrupadas por fecha | `txn-emails-delivery-rate-grouped-by-date` | El porcentaje de mensajes que se entregaron a los destinatarios, para cada día en el intervalo de fechas especificado. Esta métrica se calcula como el número de mensajes enviados y entregados a los destinatarios, dividido por el número de mensajes enviados, para cada día en el intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Rebotes permanentes | `txn-emails-hard-bounced` | El número de mensajes que no se han podido entregar a los destinatarios debido a un rebote permanente. Se produce una devolución permanente si un problema persistente impide la entrega de un mensaje, por ejemplo, si no existe la dirección de correo electrónico del destinatario. |
| Rebotes permanentes, agrupados por fechas | `txn-emails-hard-bounced-grouped-by-date` | El número de mensajes que no se pudieron entregar a los destinatarios debido a un rebote permanente, para cada día en el intervalo de fechas especificado. Se produce una devolución permanente si un problema persistente impide la entrega de un mensaje, por ejemplo, si no existe la dirección de correo electrónico del destinatario. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Aperturas | `txn-emails-opened` | El número de mensajes que han abierto los destinatarios. |
| Abiertos, agrupados por fechas | `txn-emails-opened-grouped-by-date` | El número de mensajes que abrieron los destinatarios, para cada día en el intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Envíos | `txn-emails-sent` | El número de mensajes que se han enviado. |
| Envíos, agrupados por fechas | `txn-emails-sent-grouped-by-date` | El número de mensajes que se enviaron, para cada día en el intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Rebotes temporales | `txn-emails-soft-bounced` | El número de mensajes que no se han podido entregar a los destinatarios debido a un rebote temporal. Se produce una devolución temporal si un problema temporal evita que se entregue un mensaje, por ejemplo, si la bandeja de entrada de un destinatario está llena o cuando el servidor de recepción no está disponible temporalmente. |
| Rebotes temporales, agrupados por fechas | `txn-emails-soft-bounced-grouped-by-date` | El número de mensajes que no se pudieron entregar a los destinatarios debido a un rebote temporal, para cada día en el intervalo de fechas especificado. Se produce una devolución temporal si un problema temporal evita que se entregue un mensaje, por ejemplo, si la bandeja de entrada de un destinatario está llena o cuando el servidor de recepción no está disponible temporalmente. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Eventos de clic de usuario únicos | `txn-emails-unique-clicks` | El número de destinatarios únicos (puntos de enlace) que han hecho clic en enlaces en mensajes. A diferencia de la métrica **Clicks (Clics)** esta métrica indica el número de destinatarios únicos que han hecho clic en enlaces, no el número de eventos de clic que se han producido. Por ejemplo, si un único destinatario ha hecho clic en varios enlaces del mismo mensaje o ha hecho clic en el mismo enlace más de una vez, esta métrica notifica solo un evento de clic para ese destinatario. |
| Eventos de clic de usuario únicos, agrupados por fechas | `txn-emails-unique-clicks-grouped-by-date` | El número de destinatarios únicos (puntos de enlace) que han hecho clic en enlaces en mensajes, para cada día en el intervalo de fechas especificado. A diferencia de la métrica **Clicks, grouped by date (Clics, agrupados por fecha)**, esta métrica indica el número de destinatarios únicos que han hecho clic en enlaces, no el número de eventos de clic que se han producido. Por ejemplo, si un único destinatario ha hecho clic en varios enlaces del mismo mensaje o ha hecho clic en el mismo enlace más de una vez, esta métrica notifica solo un evento de clic para ese destinatario. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Eventos de apertura de usuario únicos | `txn-emails-unique-opens` | El número de destinatarios únicos (puntos de enlace) que han abierto mensajes. A diferencia de la métrica **Opens (Aperturas)**, esta métrica indica el número de destinatarios únicos que han abierto mensajes, no el número de eventos de apertura que se han producido. Por ejemplo, si un único destinatario abre el mismo mensaje varias veces, esta métrica notifica solo un evento de apertura para ese destinatario. |
| Eventos de apertura de usuario únicos, agrupados por fechas | `txn-emails-unique-opens-grouped-by-date` | El número de destinatarios únicos (puntos de enlace) que han abierto mensajes, para cada día en el intervalo de fechas especificado. A diferencia de la métrica **Opens, grouped by date (Aperturas, agrupadas por fecha)**, esta métrica indica el número de destinatarios únicos que han abierto mensajes, no el número de eventos de apertura que se han producido. Por ejemplo, si un único destinatario abre el mismo mensaje varias veces, esta métrica notifica solo un evento de apertura para ese destinatario. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
# Métricas de aplicación de Amazon Pinpoint para mensajes SMS transaccionales
En la siguiente tabla se muestran y describen las métricas de aplicaciones estándar que puede consultar para monitorear las tendencias de todos los mensajes SMS transaccionales asociados a un proyecto de Amazon Pinpoint. Para consultar los datos de estas métricas, utilice el recurso [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) de la API de Amazon Pinpoint. En la tabla, la columna **kpi-name** indica el valor que se debe utilizar para el parámetro `kpi-name` en la consulta.
Tenga en cuenta que estas métricas no proporcionan datos sobre los mensajes SMS enviados por las campañas. Únicamente proporcionan datos sobre mensajes de SMS de transacción. Para consultar los datos de mensajes enviados por una o varias campañas, utilice una [métrica de campaña ](campaign-metrics.md) o una [una métrica de aplicación para campañas](application-metrics-campaigns.md).
| Métrica | Kpi-name | Description (Descripción) |
| --- | --- | --- |
| Precio medio por mensaje, agrupado por país | `txn-sms-average-price-grouped-by-country` | El precio medio del envío de cada mensaje, para cada país o región adonde se enviaron los mensajes. El precio se muestra en milésimas de centavo de dólar estadounidense. Por ejemplo, si el valor de este atributo es 645, se le cobran 0,645 ¢ por enviar el mensaje (645 / 1000 = 0,645 ¢ = 0,00645 USD). Esta métrica se calcula como precio total de todos los mensajes que se enviaron a los destinatarios en cada país o región, dividido por el número de mensajes que se enviaron a los destinatarios en cada uno de esos países y regiones. Los resultados de la consulta de esta métrica se agrupan por país o región, en formato ISO 3166-1 alfa-2. |
| Precio medio por parte del mensaje, agrupado por país | `txn-sms-average-price-by-parts-grouped-by-country` | El precio medio del envío de cada parte de mensaje, para cada país o región adonde se enviaron los mensajes. Una parte de un mensaje es una parte de un mensaje SMS. El precio se muestra en milésimas de centavo de dólar estadounidense. Por ejemplo, si el valor de este atributo es 645, se le cobran 0,645 ¢ por enviar el mensaje (645 / 1000 = 0,645 ¢ = 0,00645 USD). Esta métrica se calcula como precio total de todas las partes de mensajes que se enviaron a los destinatarios en cada país o región, dividido por el número de partes de mensajes que se enviaron a los destinatarios en cada uno de esos países y regiones. Los resultados de la consulta de esta métrica se agrupan por país o región, en formato ISO 3166-1 alfa-2. |
| Entregas | `txn-sms-delivered` | El número de mensajes que se entregaron a los destinatarios. |
| Entregas, agrupadas por país | `txn-sms-delivered-grouped-by-country` | El número de mensajes que se entregaron a los destinatarios, para cada país o región a donde se enviaron los mensajes. Los resultados de la consulta de esta métrica se agrupan por país o región, en formato ISO 3166-1 alfa-2. |
| Entregas, agrupadas por fechas | `txn-sms-delivered-grouped-by-date` | El número de mensajes que se entregaron a los destinatarios, para cada día en el intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Errores de entrega | `txn-sms-error-distribution` | El número de veces que se produjo un error al intentar entregar los mensajes, por cada tipo de error que se produjo. Los resultados de la consulta de esta métrica se agrupan por código de error, para cada tipo de error que se ha producido. |
| Porcentaje de entregas | `txn-sms-delivery-rate` | El porcentaje de mensajes que se entregaron a los destinatarios. Esta métrica se calcula como el número de mensajes enviados y entregados a los destinatarios, dividido por el número de mensajes enviados. |
| Porcentaje de entregas, agrupadas por fecha | `txn-sms-delivery-rate-grouped-by-date` | El porcentaje de mensajes que se entregaron a los destinatarios, para cada día en el intervalo de fechas especificado. Esta métrica se calcula como el número de mensajes enviados y entregados a los destinatarios, dividido por el número de mensajes enviados, para cada día en el intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Partes del mensaje entregadas | `txn-sms-delivered-by-parts` | El número de partes de mensajes que se entregaron. Una *parte de un mensaje* es una parte de un mensaje SMS. Si un mensaje SMS contiene más caracteres de los que permite el protocolo SMS, Amazon Pinpoint divide el mensaje en tantas partes del mensaje como sea necesario para enviar el mensaje a un destinatario. |
| Partes del mensaje entregadas, agrupadas por país | `txn-sms-delivered-by-parts-grouped-by-country` | El número de partes de mensajes que se entregaron, para cada país o región a donde se enviaron los mensajes. Una *parte de un mensaje* es una parte de un mensaje SMS. Los resultados de la consulta de esta métrica se agrupan por país o región, en formato ISO 3166-1 alfa-2. |
| Partes del mensaje enviadas | `txn-sms-sent-by-parts` | El número de partes de mensajes que se enviaron. Una *parte de un mensaje* es una parte de un mensaje SMS. Si un mensaje SMS contiene más caracteres de los que permite el protocolo SMS, Amazon Pinpoint divide el mensaje en tantas partes del mensaje como sea necesario para enviar el mensaje a un destinatario. |
| Partes del mensaje enviadas, agrupadas por país | `txn-sms-sent-by-parts-grouped-by-country` | El número de partes de mensajes que se enviaron, por cada país o región adonde se enviaron los mensajes. Una *parte de un mensaje* es una parte de un mensaje SMS. Los resultados de la consulta de esta métrica se agrupan por país o región, en formato ISO 3166-1 alfa-2. |
| Messages sent (Mensajes enviados) | `txn-sms-sent` | El número de mensajes que se han enviado. |
| Mensajes enviados, agrupados por país | `txn-sms-sent-grouped-by-country` | El número de mensajes que se enviaron, por cada país o región adonde se enviaron los mensajes. Los resultados de la consulta de esta métrica se agrupan por país o región, en formato ISO 3166-1 alfa-2. |
| Mensajes enviados, agrupados por fecha | `txn-sms-sent-grouped-by-date` | El número de mensajes que se enviaron, para cada día en el intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Precio total, agrupado por país | `txn-sms-total-price-grouped-by-country` | El costo total de enviar los mensajes, para cada país o región adonde se enviaron los mensajes. El precio se muestra en milésimas de centavo de dólar estadounidense. Por ejemplo, si el valor de este atributo es 645, se le cobran 0,645 ¢ por enviar el mensaje (645 / 1000 = 0,645 ¢ = 0,00645 USD). Los resultados de la consulta de esta métrica se agrupan por país o región, en formato ISO 3166-1 alfa-2. |
# Métricas de campañas de Amazon Pinpoint
En la siguiente tabla se muestran y describen las métricas de campaña estándar que puede consultar para evaluar las tendencias de una campaña individual. Para consultar los datos de estas métricas, utilice el recurso [Métricas de campaña](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) de la API de Amazon Pinpoint. En la tabla, la columna **kpi-name** indica el valor que se debe utilizar para el parámetro `kpi-name` en la consulta.
| Métrica | Kpi-name | Description (Descripción) |
| --- | --- | --- |
| Bounce rate (Tasa de rebotes) | `hard-bounce-rate` | Para todas las ejecuciones de la campaña, el porcentaje de mensajes de correo electrónico que no se pudieron entregar a los destinatarios. Esta métrica mide solo las devoluciones permanentes, es decir, los mensajes en los que la dirección de correo electrónico del destinatario tenía un problema permanente que impedía la entrega del mensaje. Esta métrica se calcula como el número de mensajes de correo electrónico rebotados enviados por todas las ejecuciones de la campaña, dividido por el número de mensajes de correo electrónico enviados por todas esas ejecuciones de la campaña. |
| Porcentaje de rebotes, agrupados por ejecuciones de la campaña | `hard-bounce-rate-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el porcentaje de mensajes de correo electrónico que no se pudieron entregar a los destinatarios. Esta métrica mide solo las devoluciones permanentes, es decir, los mensajes en los que la dirección de correo electrónico del destinatario tenía un problema permanente que impedía la entrega del mensaje. Esta métrica se calcula como el número de mensajes de correo electrónico rebotados enviados por una ejecución de la campaña, dividido por el número de mensajes de correo electrónico enviados por la ejecución de la campaña. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Porcentaje de entregas | `successful-delivery-rate` | Para todas las ejecuciones de la campaña, el porcentaje de mensajes que se entregaron a los destinatarios. Esta métrica se calcula como el número de mensajes enviados por todas las ejecuciones de la campaña y entregados a los destinatarios, dividido por el número de mensajes enviados por todas esas ejecuciones de la campaña. |
| Porcentaje de entregas, agrupadas por ejecuciones de la campaña | `successful-delivery-rate-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el porcentaje de mensajes que se entregaron a los destinatarios. Esta métrica se calcula como el número de mensajes enviados por una ejecución de la campaña y entregados a los destinatarios, dividido por el número de mensajes enviados por la ejecución de la campaña. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Porcentaje de entregas, agrupadas por fecha | `successful-delivery-rate-grouped-by-date` | Para todas las ejecuciones de la campaña, el porcentaje de mensajes que se entregaron a los destinatarios durante cada día del intervalo de fechas especificado. Esta métrica se calcula como el número de mensajes enviados por todas las ejecuciones de la campaña y entregados a los destinatarios, dividido entre el número de mensajes enviados por todas esas ejecuciones de la campaña, durante cada día del intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Porcentaje de correo electrónicos abiertos | `email-open-rate` | Para todas las ejecuciones de la campaña, el porcentaje de mensajes de correo electrónico abiertos por los destinatarios.Esta métrica se calcula como el número de mensajes de correo electrónico enviados por todas las ejecuciones de la campaña y abiertos por los destinatarios, dividido entre el número de mensajes de correo electrónico enviados por todas esas ejecuciones de la campaña y entregados a los destinatarios. |
| Porcentaje de correos electrónicos abiertos, agrupados por ejecuciones de la campaña | `email-open-rate-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el porcentaje de mensajes de correo electrónico abiertos por los destinatarios. Esta métrica se calcula como el número de mensajes de correo electrónico enviados por una ejecución de la campaña y abiertos por los destinatarios, dividido entre el número de mensajes de correo electrónico enviados por la ejecución de la campaña y entregados a los destinatarios. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Correos electrónicos abiertos, agrupados por ejecuciones de la campaña | `direct-email-opens-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el número de mensajes de correo electrónico abiertos por los destinatarios. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Entregas a puntos de enlace | `unique-deliveries` | Para todas las ejecuciones de la campaña, el número de puntos de enlace distintos a los que se entregaron mensajes. |
| Entregas a puntos de enlace, agrupadas por ejecuciones de la campaña | `unique-deliveries-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el número de puntos de enlace distintos a los que se entregaron mensajes. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Entregas a puntos de enlace, agrupadas por fecha | `unique-deliveries-grouped-by-date` | Para todas las ejecuciones de la campaña, el número de puntos de enlace distintos a los que se entregaron mensajes cada día del intervalo de fechas especificado. Los resultados de la consulta de esta métrica se agrupan por día natural, en el formato ISO 8601 extendido. |
| Enlaces en los que se ha hecho clic, agrupados por ejecuciones de la campaña | `clicks-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el número de veces que los destinatarios hicieron clic en los enlaces del mensaje de correo electrónico. Si un único destinatario hizo clic en varios enlaces del mensaje o hizo clic varias veces en el mismo enlace, cada clic se incluye en el recuento. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Mensajes entregados, agrupados por ejecuciones de la campaña | `successful-deliveries-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el número de mensajes que se entregaron a los destinatarios. Esta métrica se calcula como el número de mensajes enviados por una ejecución de la campaña, menos el número de mensajes que no se pudieron entregar a los destinatarios de la ejecución debido a un rebote permanente. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Mensajes enviados, agrupados por ejecuciones de la campaña | `attempted-deliveries-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el número de mensajes que se enviaron. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Porcentaje de notificaciones push abiertas | `push-open-rate` | Para todas las ejecuciones de la campaña, el porcentaje de notificaciones push abiertas por los destinatarios. Esta métrica se calcula como el número de notificaciones push enviadas por todas las ejecuciones de la campaña y abiertas por los destinatarios, dividido entre el número de notificaciones push enviadas por todas esas ejecuciones de la campaña. |
| Porcentaje de notificaciones push abiertas, agrupadas por ejecuciones de la campaña | `push-open-rate-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el porcentaje de notificaciones push abiertas por los destinatarios. Esta métrica se calcula como el número de notificaciones push enviadas por una ejecución de la campaña y abiertas por los destinatarios, dividido entre el número de notificaciones push enviadas por la ejecución de la campaña y entregadas a los destinatarios. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Total de notificaciones push abiertas, agrupadas por ejecuciones de la campaña | `direct-push-opens-grouped-by-campaign-activity` | Para cada ejecución de la campaña, el número de notificaciones push abiertas por los destinatarios. Los resultados de la consulta de esta métrica se agrupan por ID de actividad de campaña (`CampaignActivityId`), que es una cadena que identifica de forma inequívoca una ejecución de la campaña. |
| Total SMS spend (Gasto total en SMS) | sms-spend | Para todas las campañas, la cantidad total de dinero, en milicents, gastada en el envío de SMS. |
# Métricas de interacción de recorrido de Amazon Pinpoint
En la siguiente tabla se muestran y describen las métricas de interacción del recorrido estándar que puede consultar para monitorear las tendencias de todos los mensajes de correo electrónico enviados por un recorrido de Amazon Pinpoint. Para consultar datos de estas métricas, utilice el recurso [Métricas de interacción del recorrido](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-kpis-daterange-kpi-name.html) de la API de Amazon Pinpoint. En la tabla, la columna **kpi-name** indica el valor que se debe utilizar para el parámetro `kpi-name` en la consulta.
| Métrica | Kpi-name | Description (Descripción) |
| --- | --- | --- |
| Clics | `journey-emails-clicked` | El número de veces que los participantes hicieron clic en los enlaces de los mensajes. Si un único participante hizo clic en varios enlaces del mensaje o hizo clic varias veces en el mismo enlace, cada clic se incluye en el recuento. |
| Clics, agrupados por actividad | `emails-clicked-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de veces que los participantes hicieron clic en los enlaces de los mensajes. Si un único participante hizo clic en varios enlaces del mensaje o hizo clic varias veces en el mismo enlace, cada clic se incluye en el recuento. Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
| Reclamos | `journey-emails-complained` | El número de mensajes notificados por los participantes como correo electrónico no solicitado o no deseado. |
| Reclamaciones, agrupadas por actividad | `emails-complained-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de mensajes notificados por los participantes como correo electrónico no solicitado o no deseado.Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
| Entregas | `journey-emails-delivered` | El número de mensajes que se entregaron a los participantes. Esta métrica se calcula como el número de mensajes que se enviaron, menos el número de mensajes que no se pudieron entregar debido a un rebote temporal o permanente o porque se rechazaron. |
| Entregas, agrupadas por actividad | `emails-delivered-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de mensajes que se entregaron a los participantes. Esta métrica se calcula como el número de mensajes que se enviaron, menos el número de mensajes que no se pudieron entregar debido a un rebote temporal o permanente o porque se rechazaron, para cada actividad en el recorrido. Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
| Rebotes permanentes | `journey-emails-hardbounced` | El número de mensajes que no se han podido entregar a los participantes debido a un rebote permanente. Se produce una devolución permanente si un problema persistente impide la entrega de un mensaje, por ejemplo, si no existe la dirección de correo electrónico del participante. |
| Rebotes permanentes, agrupados por actividad | `emails-hardbounced-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de mensajes que no se han podido entregar a los participantes debido a un rebote permanente. Se produce una devolución permanente si un problema persistente impide la entrega de un mensaje, por ejemplo, si no existe la dirección de correo electrónico del participante. Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
| Aperturas | `journey-emails-opened` | El número de mensajes que han abierto los participantes. |
| Abiertos, agrupados por actividad | `emails-opened-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de mensajes que abrieron los participantes. Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
| Rechazos | `journey-emails-rejected` | El número de mensajes que no se enviaron a los participantes porque fueron rechazados. Se rechaza un mensaje si Amazon Pinpoint determina que el mensaje contiene malware. Amazon Pinpoint no intenta enviar mensajes rechazados. |
| Rechazos, agrupados por actividad | `emails-rejected-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de mensajes que no se enviaron a los participantes porque fueron rechazados. Se rechaza un mensaje si Amazon Pinpoint determina que el mensaje contiene malware. Amazon Pinpoint no intenta enviar mensajes rechazados. Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
| Envíos | `journey-emails-sent` | El número de mensajes que se han enviado. |
| Envíos, agrupados por actividad | `emails-sent-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de mensajes que se enviaron. Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
| Rebotes temporales | `journey-emails-softbounced` | El número de mensajes que no se han podido entregar a los participantes debido a un rebote temporal. Se produce una devolución temporal si un problema temporal evita que se entregue un mensaje, por ejemplo, si la bandeja de entrada de un participante está llena o cuando el servidor de recepción no está disponible temporalmente. |
| Rebotes temporales, agrupados por actividad | `emails-softbounced-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de mensajes que no se han podido entregar a los participantes debido a un rebote temporal. Se produce una devolución temporal si un problema temporal evita que se entregue un mensaje, por ejemplo, si la bandeja de entrada de un participante está llena o cuando el servidor de recepción no está disponible temporalmente. Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
| Cancelaciones de suscripciones | `journey-emails-unsubscribed` | El número de veces que los participantes hicieron clic en los enlaces de cancelación de suscripción en los mensajes. Si un único participante hizo clic en el mismo enlace de cancelación de suscripción varias veces, cada clic se incluye en el recuento. |
| Cancelaciones de suscripción, agrupadas por actividad | `emails-unsubscribed-grouped-by-journey-activity` | Para cada actividad de recorrido, el número de veces que los participantes hicieron clic en los enlaces de cancelación de suscripción de los mensajes. Si un único participante hizo clic en el mismo enlace de cancelación de suscripción varias veces, cada clic se incluye en el recuento. Los resultados de la consulta de esta métrica se agrupan por ID de actividad (`JourneyActivityId`), que es una cadena que identifica de forma inequívoca una actividad. |
# Métricas de ejecución de recorrido de Amazon Pinpoint
En la siguiente tabla se muestran y describen las métricas de ejecución estándar que puede consultar para evaluar el estado de los participantes en un recorrido de Amazon Pinpoint. Para consultar los datos de estas métricas, utilice el recurso [Métricas de ejecución de recorrido](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-execution-metrics.html) de la API de Amazon Pinpoint. La columna **Campo** de la tabla identifica el nombre del campo que aparece en los resultados de la consulta de cada métrica.
| Métrica | Campo | Description (Descripción) |
| --- | --- | --- |
| Participantes activos | `ENDPOINT_ACTIVE` | El número de participantes que avanzan activamente a través de las actividades del recorrido. Esta métrica se calcula como el número de participantes que han iniciado el recorrido, menos el número de participantes que abandonaron el recorrido y el número de participantes que se retiraron del recorrido. |
| Cancelaciones de participantes | `CANCELLED` | El número de participantes que no completaron el recorrido porque se canceló. |
| Salidas de los participantes | `ENDPOINT_LEFT` | El número de participantes que abandonaron el recorrido. |
| Entradas de participantes | `ENDPOINT_ENTERED` | El número de participantes que iniciaron el recorrido. |
| Excepciones de participantes, límites de re-entradas | `REENTRY_CAP_EXCEEDED` | El número de participantes que no completaron el recorrido porque habrían superado el número máximo de veces que un solo participante puede volver a entrar en el recorrido. |
| Excepciones de los participantes, rechazos | `ACTIVE_ENDPOINT_REJECTED` | El número de participantes que no pueden iniciar el recorrido porque ya son participantes activos en el recorrido. Un participante se rechaza si inicia un recorrido y, posteriormente, actualiza la definición de punto de enlace de una manera que afecte a su inclusión en un segmento (según criterios de segmento) o en el recorrido (según condiciones de actividad). |
# Métricas de ejecución de actividades de recorrido de Amazon Pinpoint
En la siguiente tabla se muestran y describen las métricas de ejecución estándar que puede consultar para evaluar el estado de los participantes en cada tipo de actividad individual de un recorrido de Amazon Pinpoint. Para consultar los datos de estas métricas, utilice el recurso [Métricas de ejecución de actividad de recorrido](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-activities-journey-activity-id-execution-metrics.html) de la API de Amazon Pinpoint. La columna **Métricas** de la tabla muestra los campos que aparecen en los resultados de la consulta para cada tipo de actividad. También proporciona una breve descripción de cada campo.
| Tipo de actividad | Métricas |
| --- | --- |
| División sí/no (`CONDITIONAL_SPLIT`) | Las métricas son: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) Hay métricas adicionales disponibles para cada ruta de la actividad. Para obtener información sobre esas métricas, consulte la fila de esta tabla para ese tipo de actividad. |
| Retención (`HOLDOUT`) | Las métricas son: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Correo electrónico (`MESSAGE`) | Las métricas son: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| División multivariante (`MULTI_CONDITIONAL_SPLIT`) | Para cada ruta de la actividad, el número de participantes que procedieron a la actividad en el camino. Los resultados de la consulta de esta métrica se agrupan por ruta, `Branch_#` donde *\$1* es el identificador numérico de una ruta, por `Branch_1` ejemplo, de la primera ruta de la actividad. Hay métricas adicionales disponibles para cada ruta de la actividad. Para obtener información sobre esas métricas, consulte la fila de esta tabla para ese tipo de actividad. |
| División aleatoria (`RANDOM_SPLIT`) | Para cada ruta de la actividad, el número de participantes que procedieron a la actividad en el camino. Los resultados de la consulta de esta métrica se agrupan por ruta, `Branch_#` donde *\$1* es el identificador numérico de una ruta, por `Branch_1` ejemplo, de la primera ruta de la actividad. Hay métricas adicionales disponibles para cada ruta de la actividad. Para obtener información sobre esas métricas, consulte la fila de esta tabla para ese tipo de actividad. |
| Espera (`WAIT`) | Las métricas son: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
| Centro de contacto (`CONTACT_CENTER`) | Las métricas son: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/pinpoint/latest/developerguide/journey-metrics-activity-execution.html) |
# Métricas de ejecución de recorrido y campaña de Amazon Pinpoint
Puede consultar las métricas de ejecución estándar para evaluar el estado de los participantes en cada tipo de actividad individual de un recorrido o campaña de Amazon Pinpoint. Para consultar los datos para estas métricas, utilice el recurso [Métricas de ejecución de actividades de recorrido](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-journeys-journey-id-runs-run-id-activities-journey-activity-id-execution-metrics.html) o [Métricas de campaña](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) de la API de Amazon Pinpoint. La siguiente tabla muestra los campos que aparecen en los resultados de la consulta para cada tipo de actividad.
****
| Nombre de métrica | Se aplica a recorridos, campañas o ambos | Description (Descripción) |
| --- | --- | --- |
| ENDPOINT\$1PRODUCED | Ambos | El número de puntos de conexión generados inicialmente a partir del segmento o evento antes de cualquier filtrado. |
| ENDPOINTS\$1FROM\$1USER | Ambos | Si el cliente tiene un segmento solo con el ID de usuario, se agregarán todos los puntos de conexión de esos usuarios. Esta métrica mide la cantidad de puntos de conexión que se agregan de esta manera. |
| ENDPOINT\$1OPT\$1OUT | Ambos | El punto de conexión se desactivó y no ingresó en la campaña ni en el recorrido. |
| ENDPOINT\$1INACTIVE | Ambos | El punto de conexión estaba inactivo y no ingresó en la campaña ni en el recorrido. |
| FILTERED\$1OUT\$1BY\$1SEGMENT | Ambos | El punto de conexión no coincidió con los filtros de segmentos y no ingresó en la campaña ni en el recorrido. |
| ENDPOINT\$1MISSING\$1ADDRESS | Ambos | Al punto de conexión le faltaba una dirección y no ingresó en la campaña ni en el recorrido. |
| ENDPOINT\$1MISSING\$1CHANNEL | Ambos | Al punto de conexión le faltaba un canal y no ingresó en la campaña ni en el recorrido. |
| ENDPOINT\$1MISSING\$1TIMEZONE | Ambos | Al punto de conexión le faltaba un valor para la zona horaria y se filtró. Esto solo ocurre cuando se requiere un valor de zona horaria. |
| ENDPOINT\$1TIMEZONE\$1MISMATCH | Ambos | El punto de conexión estaba en una zona horaria que no estaba incluida en la ejecución en ese momento. |
| ENDPOINT\$1CHANNEL\$1MISMATCH | Campaigns (Campañas) | La campaña no tiene un mensaje configurado para este tipo de canal de punto de conexión. |
| DUPLICATE\$1ENDPOINT | Ambos | Se encontraron puntos de conexión duplicados y se eliminaron los duplicados. |
| DUPLICATE\$1USER | Ambos | Se encontraron usuarios duplicados y se eliminaron de un segmento solo con ID de usuario. Si tienen el mismo ID de usuario, se emitirá una métrica igual a 1. |
| PAUSED | Journeys | Se retiró de la ejecución porque el recorrido estaba en pausa. |
| ENDED | Journeys | Se retiró de la ejecución porque el recorrido se terminó. |
| TREATMENT\$1HOLDOUT | Campaigns (Campañas) | Esto se emite en A/B las campañas, para los puntos de enlace cuyas cohortes no coinciden con el tratamiento actual. Por ejemplo, si A/B se divide al 50%, el 50% de los puntos finales emitirán esta métrica para cada tratamiento |
| ENDPOINT\$1ESTIMATED\$1TIMEZONE | Journeys | La estimación de la zona horaria permitió estimar una zona horaria para el punto de conexión. |
# Consultar datos de análisis de Amazon Pinpoint para campañas
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 y participación de las campañas.
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 una o más campañas. Puede utilizar una métrica para, por ejemplo, averiguar el número de puntos de enlace a los que se envió un mensaje de una campaña o cuántos de esos mensajes se entregaron a los puntos de enlace previstos.
Amazon Pinpoint recopila y agrega automáticamente estos datos de todas las campañas. Almacena los datos durante 90 días. Si integró una aplicación móvil con Amazon Pinpoint mediante un SDK AWS móvil, Amazon Pinpoint amplía esta compatibilidad para incluir métricas adicionales, como el porcentaje de notificaciones push que abrieron los destinatarios. Para obtener información sobre la integración de una aplicación móvil, consulte [Integrar Amazon Pinpoint con la aplicación](integrate.md).
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, la campaña 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 sobre cómo elegir estas opciones y consultar los datos de una o varias campañas.
## Requisitos previos
Antes de consultar los datos de análisis de una o varias campañas, es recomendable recopilar la siguiente información, que después utilizará para definir la consulta:
+ **Project ID**: es el identificador único para el proyecto que está asociado a la campaña o campañas. 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**.
+ **ID de campaña**: el identificador único de la campaña, si quiere consultar los datos de una sola campaña. En la API de Amazon Pinpoint, este valor se almacena en la propiedad `campaign-id`. Este valor no se muestra en la consola.
+ **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.
+ **Tipo de métrica**: el tipo de métrica que se va a consultar. Hay dos tipos de métricas: las *métricas de aplicación* y las *métricas de campaña*. Una *métrica de aplicación* proporciona datos para todas las campañas asociadas a un proyecto, también denominado *aplicación*. Una *métrica de campaña* proporciona datos de una sola campaña.
+ **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](analytics-standard-metrics.md).
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 porcentaje de mensajes entregados a los destinatarios de una campaña. Una de estas métricas agrupa automáticamente los datos por fecha (`successful-delivery-rate-grouped-by-date`). Otra métrica agrupa automáticamente los datos por ejecución de campaña (`successful-delivery-rate-grouped-by-campaign-activity`). Una tercera métrica simplemente devuelve un único valor: el porcentaje de mensajes que se entregaron a los destinatarios en todas las campañas realizadas (`successful-delivery-rate`).
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](analytics-permissions.md).
# Consultar datos de análisis de Amazon Pinpoint para una campaña
Para consultar los datos de una campaña, utilice la API [Métricas de campaña](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html) y especifique valores para los siguientes parámetros obligatorios:
+ **application-id**: el ID del proyecto, que es el identificador único del proyecto asociado a la campaña. En Amazon Pinpoint, los términos *proyecto* y *aplicación* tienen el mismo significado.
+ **campaign-id**: el identificador único de la campaña.
+ **kpi-name**: el nombre de la métrica que se va a consultar. 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. 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](analytics-standard-metrics.md).
También puede aplicar un filtro que consulte los datos de un intervalo de fechas determinado. Si no especifica un intervalo de fechas, Amazon Pinpoint devuelve los datos de los 31 días naturales anteriores. Para filtrar los datos por fechas diferentes, utilice los parámetros de intervalo de fechas admitidos para especificar la primera y la última fecha y hora del intervalo de fechas. Los valores deben estar en formato ISO 8601 extendido y utilizar la hora universal coordinada (UTC), por ejemplo, `2019-07-19T20:00:00Z` para 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.
En los siguientes ejemplos se muestra cómo consultar los datos de análisis de una campaña mediante la API REST de Amazon Pinpoint AWS CLI, la y la. AWS SDK para Java Puede usar cualquier AWS SDK compatible para consultar los datos de análisis de una campaña. Los AWS CLI ejemplos están formateados para Microsoft Windows. Para Unix, Linux y macOS, reemplace el carácter de continuación de línea de intercalación (^) por una barra invertida (\$1).
------
#### [ REST API ]
Para consultar los datos de análisis de una campaña mediante la API de REST de Amazon Pinpoint, envíe una solicitud HTTP(S) GET al URI [Métricas de campaña](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html). En el URI, especifique los valores apropiados para los parámetros de ruta requeridos:
```
https://endpoint/v1/apps/application-id/campaigns/campaign-id/kpis/daterange/kpi-name
```
Donde:
+ *endpoint*es el punto de enlace de Amazon Pinpoint para la AWS región que aloja el proyecto asociado a la campaña.
+ *application-id* es el identificador único del proyecto asociado a la campaña.
+ *campaign-id* es el identificador único de la campaña.
+ *kpi-name*es el `kpi-name` valor de la métrica que se va a consultar.
Todos los parámetros deben tener codificación URL.
Para aplicar un filtro que consulta los datos de un intervalo de fechas específico, agregue los parámetros de consulta `start-time` y `end-time` y los valores al URI. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Utilice un signo ampersand (&) para separar los parámetros.
Por ejemplo, la siguiente solicitud recupera el número de puntos de enlace únicos a los que se entregaron los mensajes, en todas las ejecuciones de una campaña, desde el 19 de julio de 2019 hasta el 26 de julio de 2019:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/campaigns/80b8efd84042ff8d9c96ce2f8example/kpis/daterange/unique-deliveries?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
Donde:
+ `pinpoint.us-east-1.amazonaws.com` es el punto de conexión de Amazon Pinpoint de la región de AWS que aloja el proyecto.
+ `1234567890123456789012345example` es el identificador único del proyecto asociado a la campaña.
+ `80b8efd84042ff8d9c96ce2f8example` es el identificador único de la campaña.
+ `unique-deliveries` es el valor `kpi-name` de la métrica de campaña *entregas a puntos de enlace* que es la métrica que informa sobre el número de puntos de enlace únicos a los que se entregaron los mensajes en todas las ejecuciones de una campaña.
+ `2019-07-19T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-07-26T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
#### [ AWS CLI ]
Para consultar los datos de análisis de una campaña mediante el AWS CLI, utilice el **get-campaign-date-range-kpi** comando y especifique los valores adecuados para los parámetros necesarios:
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id application-id ^
--campaign-id campaign-id ^
--kpi-name kpi-name
```
Donde:
+ *application-id* es el identificador único del proyecto asociado a la campaña.
+ *campaign-id* es el identificador único de la campaña.
+ *kpi-name*es el `kpi-name` valor de la métrica que se va a consultar.
Para aplicar un filtro que consulte los datos de un intervalo de fechas específico, agregue los parámetros `start-time` y `end-time` a la consulta. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Por ejemplo, la siguiente solicitud recupera el número de puntos de enlace únicos a los que se entregaron los mensajes, en todas las ejecuciones de una campaña, desde el 19 de julio de 2019 hasta el 26 de julio de 2019:
```
C:\> aws pinpoint get-campaign-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--campaign-id 80b8efd84042ff8d9c96ce2f8example ^
--kpi-name unique-deliveries ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
Donde:
+ `1234567890123456789012345example` es el identificador único del proyecto asociado a la campaña.
+ `80b8efd84042ff8d9c96ce2f8example` es el identificador único de la campaña.
+ `unique-deliveries` es el valor `kpi-name` de la métrica de campaña *entregas a puntos de enlace* que es la métrica que informa sobre el número de puntos de enlace únicos a los que se entregaron los mensajes en todas las ejecuciones de una campaña.
+ `2019-07-19T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-07-26T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
#### [ SDK for Java ]
Para consultar los datos de análisis de una campaña mediante el AWS SDK para Java, utilice el **GetCampaignDateRangeKpiRequest** método de la API [Campaign Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns-campaign-id-kpis-daterange-kpi-name.html). Especifique los valores apropiados para los parámetros requeridos:
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("applicationId")
.withCampaignId("campaignId")
.withKpiName("kpiName")
```
Donde:
+ *applicationId* es el identificador único del proyecto asociado a la campaña.
+ *campaignId* es el identificador único de la campaña.
+ *kpiName*es el `kpi-name` valor de la métrica que se va a consultar.
Para aplicar un filtro que consulte los datos de un intervalo de fechas específico, incluya los parámetros `startTime` y `endTime` y los valores en la consulta. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Por ejemplo, la siguiente solicitud recupera el número de puntos de enlace únicos a los que se entregaron los mensajes, en todas las ejecuciones de una campaña, desde el 19 de julio de 2019 hasta el 26 de julio de 2019:
```
GetCampaignDateRangeKpiRequest request = new GetCampaignDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withCampaignId("80b8efd84042ff8d9c96ce2f8example")
.withKpiName("unique-deliveries")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
Donde:
+ `1234567890123456789012345example` es el identificador único del proyecto asociado a la campaña.
+ `80b8efd84042ff8d9c96ce2f8example` es el identificador único de la campaña.
+ `unique-deliveries` es el valor `kpi-name` de la métrica de campaña *entregas a puntos de enlace* que es la métrica que informa sobre el número de puntos de enlace únicos a los que se entregaron los mensajes en todas las ejecuciones de una campaña.
+ `2019-07-19T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-07-26T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
Después de enviar la consulta, Amazon Pinpoint devuelve los resultados de la consulta en una respuesta JSON. La estructura de los resultados varía en función de la métrica que haya consultado. Algunas métricas solo devuelven un valor. Por ejemplo, la métrica de la campaña *entregas a puntos de conexión* (`unique-deliveries`), que se utiliza en los ejemplos anteriores, devuelve un valor: el número de puntos de conexión únicos a los que se entregaron los mensajes en todas las tiradas de una campaña. En este caso, la respuesta JSON es la siguiente:
```
{
"CampaignDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"CampaignId":"80b8efd84042ff8d9c96ce2f8example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
Otras métricas devuelven varios valores y agrupan los valores por un campo relevante. Si una métrica devuelve 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](analytics-query-results.md).
# Consultar datos de análisis de Amazon Pinpoint para varias campañas
Existen dos formas de consultar los datos de varias campañas. La mejor forma depende de si desea consultar los datos de las campañas asociadas al mismo proyecto. Si es así, también depende de si desea consultar los datos de todas las campañas o solo o subconjunto de ellas.
Para consultar los datos de las campañas asociadas a diferentes proyectos o solo de un subconjunto de campañas asociadas al mismo proyecto, lo mejor es crear y ejecutar una serie de consultas individuales, una para cada campaña para la que desee consultar los datos. En la sección anterior se explica cómo consultar los datos de una sola campaña.
Para consultar los datos de todas las campañas asociadas al mismo proyecto, puede utilizar la API [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Especifique valores para los siguientes parámetros obligatorios:
+ **application-id**: el ID del proyecto, que es el identificador único del proyecto. En Amazon Pinpoint, los términos *proyecto* y *aplicación* tienen el mismo significado.
+ **kpi-name**: el nombre de la métrica que se va a consultar. 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. 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](analytics-standard-metrics.md).
También puede filtrar los datos por intervalo de fechas. Si no especifica un intervalo de fechas, Amazon Pinpoint devuelve los datos de los 31 días naturales anteriores. Para filtrar los datos por fechas diferentes, utilice los parámetros de intervalo de fechas admitidos para especificar la primera y la última fecha y hora del intervalo de fechas. Los valores deben estar en formato ISO 8601 extendido y utilizar la hora universal coordinada (UTC), por ejemplo, `2019-07-19T20:00:00Z` para 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.
En los siguientes ejemplos se muestra cómo consultar los datos de análisis de una campaña mediante la API REST de Amazon Pinpoint AWS CLI, la y la. AWS SDK para Java Puede usar cualquier AWS SDK compatible para consultar los datos de análisis de una campaña. Los AWS CLI ejemplos están formateados para Microsoft Windows. Para Unix, Linux y macOS, reemplace el carácter de continuación de línea de intercalación (^) por una barra invertida (\$1).
------
#### [ REST API ]
Para consultar los datos de análisis de varias campañas mediante la API de REST de Amazon Pinpoint, envíe una solicitud HTTP(S) GET al URI [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). En el URI, especifique los valores apropiados para los parámetros de ruta requeridos:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Donde:
+ *endpoint*es el punto de enlace de Amazon Pinpoint para la AWS región que aloja el proyecto asociado a las campañas.
+ *application-id* es el identificador único del proyecto asociado a las campañas.
+ *kpi-name*es el `kpi-name` valor de la métrica que se va a consultar.
Todos los parámetros deben tener codificación URL.
Para aplicar un filtro que recupere los datos de un intervalo de fechas específico, agregue los parámetros de consulta `start-time` y `end-time` y los valores al URI. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Utilice un signo ampersand (&) para separar los parámetros.
Por ejemplo, la siguiente solicitud recupera el número de puntos de enlace únicos a los que se entregaron los mensajes, en todas las campañas de un proyecto, desde el 19 de julio de 2019 hasta el 26 de julio de 2019:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/unique-deliveries-grouped-by-campaign?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
```
Donde:
+ `pinpoint.us-east-1.amazonaws.com` es el punto de conexión de Amazon Pinpoint de la región de AWS que aloja el proyecto.
+ `1234567890123456789012345example` es el identificador único del proyecto asociado a las campañas.
+ `unique-deliveries-grouped-by-campaign` es el valor `kpi-name` de la métrica de aplicación *entregas a puntos de enlace, agrupadas por campaña* que es la métrica que devuelve el número de puntos de enlace únicos a los que se entregaron los mensajes por campaña.
+ `2019-07-19T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-07-26T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
#### [ AWS CLI ]
Para consultar los datos de análisis de varias campañas mediante el AWS CLI, utilice el **get-application-date-range-kpi** comando y especifique los valores adecuados para los parámetros necesarios:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Donde:
+ *application-id* es el identificador único del proyecto asociado a las campañas.
+ *kpi-name*es el `kpi-name` valor de la métrica que se va a consultar.
Para aplicar un filtro que recupere los datos de un intervalo de fechas específico, incluya los parámetros `start-time` y `end-time` y los valores en la consulta. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Por ejemplo, la siguiente solicitud recupera el número de puntos de enlace únicos a los que se entregaron los mensajes, en todas las campañas de un proyecto, desde el 19 de julio de 2019 hasta el 26 de julio de 2019:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name unique-deliveries-grouped-by-campaign ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
```
Donde:
+ `1234567890123456789012345example` es el identificador único del proyecto asociado a la campaña.
+ `unique-deliveries-grouped-by-campaign` es el valor `kpi-name` de la métrica de aplicación *entregas a puntos de enlace, agrupadas por campaña* que es la métrica que devuelve el número de puntos de enlace únicos a los que se entregaron los mensajes por campaña.
+ `2019-07-19T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-07-26T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
#### [ SDK for Java ]
Para consultar los datos de análisis de varias campañas mediante la AWS SDK para Java, utilice el **GetApplicationDateRangeKpiRequest** método de la API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Especifique los valores apropiados para los parámetros requeridos:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Donde:
+ *applicationId* es el identificador único del proyecto asociado a las campañas.
+ *kpiName*es el `kpi-name` valor de la métrica que se va a consultar.
Para aplicar un filtro que recupere los datos de un intervalo de fechas específico, incluya los parámetros `startTime` y `endTime` y los valores en la consulta. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Por ejemplo, la siguiente solicitud recupera el número de puntos de enlace únicos a los que se entregaron los mensajes, en todas las campañas de un proyecto, desde el 19 de julio de 2019 hasta el 26 de julio de 2019:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("unique-deliveries-grouped-by-campaign")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
```
Donde:
+ `1234567890123456789012345example` es el identificador único del proyecto asociado a las campañas.
+ `unique-deliveries-grouped-by-campaign` es el valor `kpi-name` de la métrica de aplicación *entregas a puntos de enlace, agrupadas por campaña* que es la métrica que devuelve el número de puntos de enlace únicos a los que se entregaron los mensajes por campaña.
+ `2019-07-19T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-07-26T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
Después de enviar la consulta, Amazon Pinpoint devuelve los resultados de la consulta en una respuesta JSON. La estructura de los resultados varía en función de la métrica que haya consultado. Algunas métricas solo devuelven un valor. Otras métricas devuelven varios valores y esos valores se agrupan por campo relevante. Si una métrica devuelve varios valores, la respuesta JSON incluye un campo que indica qué campo se utilizó para agrupar los datos.
Por ejemplo, la métrica de la aplicación *entregas de puntos de conexión, agrupadas por campaña* (`unique-deliveries-grouped-by-campaign`), que se utiliza en los ejemplos anteriores, devuelve valores múltiples: el número de puntos de conexión únicos a los que se entregaron los mensajes, para cada campaña asociada a un proyecto. En este caso, la respuesta JSON es la siguiente:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
```
En este caso, el campo `GroupedBys` indica que los valores están agrupados por ID de campaña (`CampaignId`).
Para obtener más información sobre la estructura de los resultados de la consulta, lea [Usar resultados de consultas JSON](analytics-query-results.md).
# 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](analytics-standard-metrics.md).
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](analytics-permissions.md).
# Consultar datos de Amazon Pinpoint para mensajes de correo electrónico transaccionales
Para consultar los datos de los mensajes de correo electrónico transaccionales enviados para un proyecto, utilice la API [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) y especifique valores para los siguientes parámetros obligatorios:
+ **application-id**: el ID del proyecto, que es el identificador único del proyecto. En Amazon Pinpoint, los términos *proyecto* y *aplicación* tienen el mismo significado.
+ **kpi-name**: el nombre de la métrica que se va a consultar. 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. 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](analytics-standard-metrics.md).
También puede aplicar un filtro que consulte los datos de un intervalo de fechas determinado. Si no especifica un intervalo de fechas, Amazon Pinpoint devuelve los datos de los 31 días naturales anteriores. Para filtrar los datos por fechas diferentes, utilice los parámetros de intervalo de fechas admitidos para especificar la primera y la última fecha y hora del intervalo de fechas. Los valores deben estar en formato ISO 8601 extendido y utilizar la hora universal coordinada (UTC), por ejemplo, `2019-09-06T20:00:00Z` para el 6 de septiembre 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.
En los siguientes ejemplos se muestra cómo consultar los datos de análisis de los mensajes de correo electrónico transaccionales mediante la API REST de Amazon Pinpoint, AWS CLI la y la. AWS SDK para Java Puede utilizar cualquier SDK de AWS compatible para consultar los datos de análisis de mensajes transaccionales. Los AWS CLI ejemplos están formateados para Microsoft Windows. Para Unix, Linux y macOS, reemplace el carácter de continuación de línea de intercalación (^) por una barra invertida (\$1).
------
#### [ REST API ]
Para consultar los datos de análisis de mensajes de correo electrónico transaccionales mediante la API de REST de Amazon Pinpoint, envíe una solicitud HTTP(S) GET al URI [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). En el URI, especifique los valores apropiados para los parámetros de ruta requeridos:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Donde:
+ *endpoint*es el punto de enlace de Amazon Pinpoint para la AWS región que aloja el proyecto.
+ *application-id* es el identificador único del producto.
+ *kpi-name*es el `kpi-name` valor de la métrica que se va a consultar.
Todos los parámetros deben tener codificación URL.
Para aplicar un filtro que consulta los datos de un intervalo de fechas específico, agregue los parámetros de consulta `start-time` y `end-time` y los valores al URI. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Utilice un signo ampersand (&) para separar los parámetros.
Por ejemplo, la siguiente solicitud recupera el número de mensajes de correo electrónico transaccionales enviados para un proyecto desde el 6 de septiembre de 2019 hasta el 13 de septiembre de 2019:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-emails-sent?start-time=2019-09-06T00:00:00Z&end-time=2019-09-13T23:59:59Z
```
Donde:
+ `pinpoint.us-east-1.amazonaws.com` es el punto de conexión de Amazon Pinpoint de la región de AWS que aloja el proyecto.
+ `1234567890123456789012345example` es el identificador único del producto.
+ `txn-emails-sent` es el valor `kpi-name` de la métrica de aplicación *envíos* que es la métrica que informa sobre el número de mensajes de correo electrónico transaccionales enviados para un proyecto.
+ `2019-09-06T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-09-13T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
#### [ AWS CLI ]
Para consultar los datos de análisis de los mensajes de correo electrónico transaccionales mediante el AWS CLI, utilice el **get-application-date-range-kpi** comando y especifique los valores adecuados para los parámetros necesarios:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Donde:
+ *application-id* es el identificador único del producto.
+ *kpi-name*es el `kpi-name` valor de la métrica que se va a consultar.
Para aplicar un filtro que consulte los datos de un intervalo de fechas específico, agregue los parámetros `start-time` y `end-time` a la consulta. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Por ejemplo, la siguiente solicitud recupera el número de mensajes de correo electrónico transaccionales enviados para un proyecto desde el 6 de septiembre de 2019 hasta el 13 de septiembre de 2019:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-emails-sent ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-13T23:59:59Z
```
Donde:
+ `1234567890123456789012345example` es el identificador único del producto.
+ `txn-emails-sent` es el valor `kpi-name` de la métrica de aplicación *envíos* que es la métrica que informa sobre el número de mensajes de correo electrónico transaccionales enviados para un proyecto.
+ `2019-09-06T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-09-13T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
#### [ SDK for Java ]
Para consultar los datos de análisis de los mensajes de correo electrónico transaccionales mediante el AWS SDK para Java**GetApplicationDateRangeKpiRequest** método de la API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). Especifique los valores apropiados para los parámetros requeridos:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Donde:
+ *applicationId* es el identificador único del producto.
+ *kpiName*es el `kpi-name` valor de la métrica que se va a consultar.
Para aplicar un filtro que consulte los datos de un intervalo de fechas específico, incluya los parámetros `startTime` y `endTime` y los valores en la consulta. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Por ejemplo, la siguiente solicitud recupera el número de mensajes de correo electrónico transaccionales enviados para un proyecto desde el 6 de septiembre de 2019 hasta el 13 de septiembre de 2019:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-emails-sent")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-13T23:59:59Z")));
```
Donde:
+ `1234567890123456789012345example` es el identificador único del producto.
+ `txn-emails-sent` es el valor `kpi-name` de la métrica de aplicación *envíos* que es la métrica que informa sobre el número de mensajes de correo electrónico transaccionales enviados para un proyecto.
+ `2019-09-06T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-09-13T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
Después de enviar la consulta, Amazon Pinpoint devuelve los resultados de la consulta en una respuesta JSON. La estructura de los resultados varía en función de la métrica que haya consultado. Algunas métricas solo devuelven un valor. Por ejemplo, la métrica de la aplicación *envíos* (`txn-emails-sent`), que se utiliza en los ejemplos anteriores, devuelve un valor: el número de mensajes de correo electrónico transaccionales que se enviaron desde un proyecto. En este caso, la respuesta JSON es la siguiente:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-13T23:59:59Z",
"KpiName":"txn-emails-sent",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"TxnEmailsSent",
"Type":"Double",
"Value":"62.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
Otras métricas devuelven varios valores y agrupan los valores por un campo relevante. Si una métrica devuelve 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](analytics-query-results.md).
# Consultar datos de Amazon Pinpoint para mensajes SMS transaccionales
Para consultar los datos de los mensajes SMS transaccionales enviados para un proyecto, utilice la API [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) y especifique valores para los siguientes parámetros obligatorios:
+ **application-id**: el ID del proyecto, que es el identificador único del proyecto. En Amazon Pinpoint, los términos *proyecto* y *aplicación* tienen el mismo significado.
+ **kpi-name**: el nombre de la métrica que se va a consultar. 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. 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](analytics-standard-metrics.md).
También puede aplicar un filtro que consulte los datos de un intervalo de fechas determinado. Si no especifica un intervalo de fechas, Amazon Pinpoint devuelve los datos de los 31 días naturales anteriores. Para filtrar los datos por fechas diferentes, utilice los parámetros de intervalo de fechas admitidos para especificar la primera fecha y hora y la última fecha y hora del intervalo de fechas. Los valores deben estar en formato ISO 8601 extendido y utilizar la hora universal coordinada (UTC), por ejemplo, `2019-09-06T20:00:00Z` para el 6 de septiembre 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.
Los siguientes ejemplos muestran cómo consultar datos analíticos para mensajes SMS transaccionales mediante la API REST de Amazon Pinpoint, AWS CLI la y la. AWS SDK para Java Puede usar cualquier AWS SDK compatible para consultar los datos de análisis de los mensajes transaccionales. Los AWS CLI ejemplos están formateados para Microsoft Windows. Para Unix, Linux y macOS, reemplace el carácter de continuación de línea de intercalación (^) por una barra invertida (\$1).
------
#### [ REST API ]
Para consultar los datos de análisis de mensajes SMS transaccionales mediante la API de REST de Amazon Pinpoint, envíe una solicitud HTTP(S) GET al URI [Métricas de aplicación](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html). En el URI, especifique los valores apropiados para los parámetros de ruta requeridos:
```
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
```
Donde:
+ *endpoint*es el punto de enlace de Amazon Pinpoint para la AWS región que aloja el proyecto.
+ *application-id* es el identificador único del producto.
+ *kpi-name*es el `kpi-name` valor de la métrica que se va a consultar.
Todos los parámetros deben tener codificación URL.
Para aplicar un filtro que recupere los datos de un intervalo de fechas específico, agregue los parámetros de consulta `start-time` y `end-time` y los valores al URI. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Utilice un signo ampersand (&) para separar los parámetros.
Por ejemplo, la siguiente solicitud recupera el número de mensajes SMS transaccionales enviados cada día desde el 6 de septiembre de 2019 hasta el 8 de septiembre de 2019:
```
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/txn-sms-sent-grouped-by-date?start-time=2019-09-06T00:00:00Z&end-time=2019-09-08T23:59:59Z
```
Donde:
+ `pinpoint.us-east-1.amazonaws.com` es el punto de conexión de Amazon Pinpoint de la región de AWS que aloja el proyecto.
+ `1234567890123456789012345example` es el identificador único del producto.
+ `txn-sms-sent-grouped-by-date` es el valor `kpi-name` de los *envíos, agrupados por fecha* que es la métrica que devuelve el número de mensajes SMS transaccionales enviados cada día durante el intervalo de fechas.
+ `2019-09-06T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-09-08T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
#### [ AWS CLI ]
Para consultar los datos analíticos de los mensajes SMS transaccionales mediante el AWS CLI, utilice el **get-application-date-range-kpi** comando y especifique los valores adecuados para los parámetros necesarios:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
```
Donde:
+ *application-id* es el identificador único del producto.
+ *kpi-name*es el `kpi-name` valor de la métrica que se va a consultar.
Para aplicar un filtro que recupere los datos de un intervalo de fechas específico, incluya los parámetros `start-time` y `end-time` y los valores en la consulta. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Por ejemplo, la siguiente solicitud recupera el número de mensajes SMS transaccionales enviados cada día desde el 6 de septiembre de 2019 hasta el 8 de septiembre de 2019:
```
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name txn-sms-sent-grouped-by-date ^
--start-time 2019-09-06T00:00:00Z ^
--end-time 2019-09-08T23:59:59Z
```
Donde:
+ `1234567890123456789012345example` es el identificador único del producto.
+ `txn-sms-sent-grouped-by-date` es el valor `kpi-name` de los *envíos, agrupados por fecha* que es la métrica que devuelve el número de mensajes SMS transaccionales enviados cada día durante el intervalo de fechas.
+ `2019-09-06T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-09-08T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
#### [ SDK for Java ]
Para consultar los datos analíticos de los mensajes SMS transaccionales mediante el AWS SDK para Java, utilice el **GetApplicationDateRangeKpiRequest** método de la API [Application Metrics](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-kpis-daterange-kpi-name.html) y especifique los valores adecuados para los parámetros necesarios:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
```
Donde:
+ *applicationId* es el identificador único del producto.
+ *kpiName*es el `kpi-name` valor de la métrica que se va a consultar.
Para aplicar un filtro que recupere los datos de un intervalo de fechas específico, incluya los parámetros `startTime` y `endTime` y los valores en la consulta. Estos parámetros permiten especificar la primera y última fecha y hora, en formato ISO 8601 ampliado, de un intervalo de fechas inclusivo para recuperar los datos. Por ejemplo, la siguiente solicitud recupera el número de mensajes SMS transaccionales enviados cada día desde el 6 de septiembre de 2019 hasta el 8 de septiembre de 2019:
```
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("txn-sms-sent-grouped-by-date")
.withStartTime(Date.from(Instant.parse("2019-09-06T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-09-08T23:59:59Z")));
```
Donde:
+ `1234567890123456789012345example` es el identificador único del producto.
+ `txn-sms-sent-grouped-by-date` es el valor `kpi-name` de los *envíos, agrupados por fecha* que es la métrica que devuelve el número de mensajes SMS transaccionales enviados cada día durante el intervalo de fechas.
+ `2019-09-06T00:00:00Z` es la primera fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
+ `2019-09-08T23:59:59Z` es la última fecha y hora para recuperar datos dentro de un intervalo de fechas inclusivo.
------
Después de enviar la consulta, Amazon Pinpoint devuelve los resultados de la consulta en una respuesta JSON. La estructura de los resultados varía en función de la métrica que haya consultado. Algunas métricas solo devuelven un valor. Otras métricas devuelven varios valores y agrupan estos valores por un campo relevante. Si una métrica devuelve varios valores, la respuesta JSON incluye un campo que indica qué campo se utilizó para agrupar los datos.
Por ejemplo, la métrica de la aplicación *envíos, agrupados por fecha* (`txn-sms-sent-grouped-by-date`), que se utiliza en los ejemplos anteriores, devuelve varios valores: el número de mensajes SMS transaccionales que se enviaron durante cada día del intervalo de fechas especificado. En este caso, la respuesta JSON es la siguiente:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-09-08T23:59:59Z",
"KpiName":"txn-sms-sent-grouped-by-date",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-06"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"29.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-07"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"35.0"
}
]
},
{
"GroupedBys":[
{
"Key":"Date",
"Type":"String",
"Value":"2019-09-08"
}
],
"Values":[
{
"Key":"TxnSmsSent",
"Type":"Double",
"Value":"10.0"
}
]
}
]
},
"StartTime":"2019-09-06T00:00:00Z"
}
}
```
En este caso, el campo `GroupedBys` indica que los valores se agrupan por día natural (`Date`). Esto significa que:
+ El 6 de septiembre de 2019 se enviaron 29 mensajes.
+ El 7 de septiembre de 2019 se enviaron 35 mensajes.
+ El 8 de septiembre de 2019 se enviaron 10 mensajes.
Para obtener más información sobre la estructura de los resultados de la consulta, lea [Usar resultados de consultas JSON](analytics-query-results.md).
# Usar resultados de consultas JSON de análisis de Amazon Pinpoint
Cuando utiliza Amazon Pinpoint Analytics APIs para consultar datos de análisis, Amazon Pinpoint devuelve los resultados en una respuesta JSON. Para las métricas de aplicación, las métricas de campaña y las métricas de interacción del recorrido, los datos de la respuesta siguen un esquema JSON estándar a la hora de generar informes de datos de análisis de Amazon Pinpoint.
Esto significa que puede utilizar el lenguaje de programación o la herramienta de su elección para implementar una solución personalizada que consulte los datos de una o más de estas métricas, capture los resultados de cada consulta y, a continuación, escriba los resultados en una tabla, en un objeto o en otra ubicación. Luego podrá trabajar con los resultados de la consulta en esa ubicación con otro servicio o aplicación.
Por ejemplo, puede hacer lo siguiente:
+ Crear un panel personalizado que consulte regularmente un conjunto de métricas y muestre los resultados en el marco de visualización de datos preferido.
+ Crear un informe que realice un seguimiento de las tasas de interacción a partir de las métricas adecuadas y mostrar los resultados en un gráfico u otro tipo de informe que haya diseñado.
+ Analizar y escribir datos de análisis en un formato de almacenamiento determinado y, a continuación, trasladar los resultados a una solución de almacenamiento a largo plazo.
Tenga en cuenta que Amazon Pinpoint Analytics APIs no está diseñado para crear ni almacenar ningún objeto persistente que pueda leer o utilizar posteriormente en un proyecto de Amazon Pinpoint o en su cuenta de Amazon Pinpoint. Por el contrario, APIs están diseñados para ayudarle a recuperar datos analíticos y transferirlos a otros servicios y aplicaciones para su posterior análisis, almacenamiento o elaboración de informes. Utilizan en parte la misma estructura de respuesta y esquema JSON para todos los datos de análisis que se puede consultar mediante programación para métricas de aplicación, métricas de campaña y métricas de interacción del recorrido.
En este tema se explica la estructura, los objetos y los campos de una respuesta JSON a una consulta para métricas de aplicación, métricas de campaña y métricas de interacción del recorrido. Para obtener información sobre los campos de una respuesta JSON a una consulta para una métrica de ejecución de recorrido o una métrica de ejecución de actividad de recorrido, consulte [Métricas estándar que se aplican a los proyectos, campañas y recorridos de Amazon Pinpoint](analytics-standard-metrics.md).
## Estructura JSON
Para ayudarle a analizar y utilizar los resultados de las consultas, Amazon Pinpoint Analytics APIs utiliza la misma estructura de respuesta JSON para todos los datos de Amazon Pinpoint Analytics, que puede consultar mediante programación para obtener métricas de aplicaciones, métricas de campañas y métricas de interacción con el recorrido. Cada respuesta JSON especifica los valores que definieron la consulta, como el ID del proyecto (`ApplicationId`). La respuesta también incluye un (solo) objeto `KpiResult`. El objeto `KpiResult` contiene el conjunto de resultados generales de una consulta.
Cada objeto `KpiResult` contiene un objeto `Rows`. Se trata de una matriz de objetos que contiene resultados de consulta y los metadatos relevantes sobre los valores de esos resultados. La estructura y el contenido de un objeto `Rows` tienen las siguientes características generales:
+ Cada fila de resultados de la consulta es un objeto JSON separado, denominado `Values`, en el objeto `Rows`. Por ejemplo, si una consulta devuelve tres valores, el objeto `Rows` contiene tres objetos `Values`. Cada objeto `Values` contiene un resultado individual para la consulta.
+ Cada columna de los resultados de consulta es una propiedad del objeto `Values` al que se aplica. El nombre de la columna se almacena en el campo `Key` del objeto `Values`.
+ Para los resultados de consultas agrupadas, cada objeto `Values` tiene un objeto `GroupedBys` asociado. El objeto `GroupedBys` indica qué campo se utilizó para agrupar los resultados. También proporciona el valor de agrupación para el objeto `Values` asociado.
+ Si los resultados de la consulta de una métrica son nulos, el objeto `Rows` estará vacío.
Además de estas características generales, la estructura y el contenido del objeto `Rows` varía según la métrica. Esto se debe a que Amazon Pinpoint admite dos tipos de métricas: las *métricas de valor único* y las *métricas de varios valores*.
Una *métrica de valor único* solo proporciona un valor acumulativo. Un ejemplo es el porcentaje de mensajes entregados a los destinatarios por todas las ejecuciones de una campaña. Una *métrica de varios valores* proporciona más de un valor y los agrupa por campo relevante. Un ejemplo es el porcentaje de mensajes entregados a los destinatarios en cada ejecución de una campaña, agrupados por ejecución de campaña.
Para determinar rápidamente si una métrica es de valor único o de varios valores observe el nombre de la métrica. Si el nombre no contiene `grouped-by`, se tratará de una métrica de valor único. Si lo contiene, será una métrica de varios valores. Para obtener una lista completa de las métricas que puede consultar mediante programación, visite [Métricas estándar que se aplican a los proyectos, campañas y recorridos de Amazon Pinpoint](analytics-standard-metrics.md).
### Métricas de valor único
En una métrica de valor único, el objeto `Rows` contiene un objeto `Values` que:
+ Especifica el nombre descriptivo de la métrica que se consultó.
+ Proporciona el valor de la métrica que se consultó.
+ Identifica el tipo de datos del valor devuelto.
Por ejemplo, la siguiente respuesta JSON contiene los resultados de la consulta para una métrica de valor único. Esta métrica comunica el número de puntos de enlace únicos a los que se entregaron mensajes por todas las campañas asociadas a un proyecto, desde el 1 de agosto de 2019 hasta el 31 de agosto de 2019:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
{
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"1368.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
En este ejemplo, la respuesta indica que todas las campañas del proyecto enviaron mensajes a 1368 puntos de enlace únicos desde el 1 de agosto de 2019 hasta el 31 de agosto de 2019, donde:
+ `Key` es el nombre descriptivo de la métrica cuyo valor se especifica en el campo `Value` (`UniqueDeliveries`).
+ `Type` es el tipo de datos del valor especificado en el campo `Value` (`Double`).
+ `Value` es el valor real de la métrica que se consultó, incluidos los filtros que se aplicaron (`1368.0`).
Si los resultados de la consulta para una métrica de un solo valor son nulos (no mayor o igual a cero), el objeto de `Rows` está vacío. Amazon Pinpoint devuelve un valor nulo para una métrica si no hay ningún dato que devolver para la métrica. Por ejemplo:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"2345678901234567890123456example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries",
"KpiResult":{
"Rows":[
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
### Métricas de varios valores
La estructura y el contenido del objeto `Rows` para una métrica de varios valores suelen ser las mismos que para una métrica de valor único. El objeto `Rows` de una métrica de valores múltiples también contiene un objeto `Values`. El objeto `Values` especifica el nombre descriptivo de la métrica consultada, proporciona el valor de esa métrica e identifica el tipo de datos de ese valor.
Sin embargo, el objeto `Rows` de una métrica de valores múltiples también contiene uno o más objetos `GroupedBy`. Hay un objeto `GroupedBy` para cada objeto `Values` en los resultados de la consulta. El objeto `GroupedBy` indica qué campo se utilizó para agrupar los datos en los resultados y el tipo de datos de ese campo. También indica el valor de agrupación para ese campo (para el objeto `Values` asociado).
Por ejemplo, la siguiente respuesta JSON contiene los resultados de la consulta de una métrica de varios valores que informa sobre el número de puntos de enlace únicos a los que se entregaron mensajes en cada campaña asociada a un proyecto desde el 1 de agosto de 2019 hasta el 31 de agosto de 2019:
```
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-08-31T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-08-01T00:00:00Z"
}
}
```
En este ejemplo, la respuesta indica que tres de las campañas del proyecto entregaron mensajes a puntos de enlace únicos desde el 1 de agosto de 2019 hasta el 31 de agosto de 2019. Para cada una de estas campañas, el desglose de los recuentos de entregas es el siguiente:
+ La campaña `80b8efd84042ff8d9c96ce2f8example` entregó mensajes a 123 puntos de enlace únicos.
+ La campaña `810c7aab86d42fb2b56c8c966example` entregó mensajes a 456 puntos de enlace únicos.
+ La campaña `42d8c7eb0990a57ba1d5476a3example` entregó mensajes a 789 puntos de enlace únicos.
Donde la estructura general de los objetos y campos es la siguiente:
+ `GroupedBys.Key`: el nombre de la propiedad o el campo que almacena el valor de agrupamiento especificado en el campo `GroupedBys.Value` (`CampaignId`).
+ `GroupedBys.Type`: el tipo de datos del valor especificado en el campo `GroupedBys.Value` (`String`).
+ `GroupedBys.Value`: el valor real del campo que se utilizó para agrupar los datos, tal como se especifica en el campo `GroupedBys.Key` (ID de campaña).
+ `Values.Key`: es el nombre descriptivo de la métrica cuyo valor se especifica en el campo `Values.Value` (`UniqueDeliveries`).
+ `Values.Type`: el tipo de datos del valor especificado en el campo `Values.Value` (`Double`).
+ `Values.Value`: el valor real de la métrica que se consultó, incluidos los filtros que se aplicaron.
Si los resultados de la consulta de una métrica de varios valores son nulos (ni mayor ni igual a cero) para un proyecto, campaña u otro recurso específico, Amazon Pinpoint no devuelve ningún objeto ni campo para el recurso. Si los resultados de la consulta de una métrica de varios valores son nulos para todos los recursos, Amazon Pinpoint devuelve un objeto `Rows` vacío.
## Objetos y campos JSON
Además de especificar los valores que definieron una consulta, como el ID del proyecto (`ApplicationId`), cada respuesta JSON a una consulta para métricas de aplicación, métricas de campaña o métricas de interacción del recorrido incluye un objeto `KpiResult`. Este objeto contiene el conjunto de resultados generales de una consulta, que puede analizar para enviar los datos de análisis a otro servicio o aplicación. Cada objeto `KpiResult` contiene algunos o todos los objetos y campos estándar siguientes, dependiendo de la métrica.
| Objeto o campo | Description (Descripción) |
| --- | --- |
| Rows | Matriz de objetos que contiene el conjunto de resultados de una consulta. |
| Rows.GroupedBys | En una métrica de varios valores, es una matriz de campos que define el campo y los valores utilizados para agrupar datos en los resultados de la consulta. |
| Rows.GroupedBys.Key | En una métrica de varios valores, es el nombre de la propiedad o del campo que almacena el valor especificado en el campo GroupedBys.Value. |
| Rows.GroupedBys.Type | En una métrica de varios valores, es el tipo de dato del valor especificado en el campo GroupedBys.Value. |
| Rows.GroupedBys.Value | En una métrica de varios valores, es el valor real del campo que se utilizó para agrupar datos en los resultados de la consulta. Este valor se correlaciona con un objeto Values asociado. |
| Rows.Values | Matriz de campos que contiene los resultados de la consulta. |
| Rows.Values.Key | El nombre descriptivo de la métrica que se consultó. El valor de la métrica se especifica en el campo Values.Value. |
| Rows.Values.Type | Tipo de datos del valor especificado en el campo Values.Value. |
| Rows.Values.Value | Valor real de la métrica que se consultó, incluidos los filtros que se aplicaron. |
Para obtener información sobre los campos de una respuesta JSON a una consulta para una métrica de ejecución de recorrido o una métrica de ejecución de actividad de recorrido, consulte [Métricas estándar que se aplican a los proyectos, campañas y recorridos de Amazon Pinpoint](analytics-standard-metrics.md).