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. Especifique valores para los siguientes parámetros obligatorios:

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 de REST de Amazon Pinpoint, la AWS CLI y AWS SDK para Java. Puede utilizar cualquier SDK de AWS compatible para consultar datos de análisis de una campaña. Los ejemplos de AWS CLI tienen el formato de Microsoft Windows. Para Unix, Linux y macOS, reemplace el carácter de continuación de línea de intercalación (^) por una barra invertida (\).

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.