Consultar dados de análise do Amazon Pinpoint para mensagens transacionais

Além de usar as páginas de análise no console do Amazon Pinpoint, você pode usar o Amazon Pinpoint APIs Analytics para consultar dados analíticos de um subconjunto de métricas padrão que fornecem informações sobre as tendências de entrega e engajamento das mensagens transacionais enviadas para um projeto.

Cada métrica é um valor mensurável, também chamado de indicador-chave de desempenho (KPI), que pode ajudá-lo a monitorar e avaliar o desempenho de mensagens transacionais. Por exemplo, você pode usar uma métrica para descobrir quantas mensagens transacionais de e-mail ou SMS você enviou ou quantas dessas mensagens foram entregues aos destinatários. O Amazon Pinpoint coleta e agrega automaticamente esses dados para todas as mensagens transacionais de e-mail e SMS que você envia para um projeto. Os dados são armazenados por 90 dias.

Se você usa o Amazon Pinpoint Analytics APIs para consultar dados, você pode escolher várias opções que definem o escopo, os dados, o agrupamento e os filtros para sua consulta. Faça isso usando parâmetros que especificam o projeto e a métrica que você deseja consultar, além de qualquer filtro baseado em datas que você deseja aplicar.

Este tópico explica e fornece exemplos de como escolher essas opções e consultar dados de mensagens transacionais para um projeto.

Pré-requisitos

Antes de consultar dados analíticos para mensagens transacionais, ele ajuda a coletar as seguintes informações, usadas para definir sua consulta:

• ID do projeto: o identificador exclusivo do projeto do qual as mensagens foram enviadas. Na API do Amazon Pinpoint, esse valor é armazenado na propriedade application-id. No console do Amazon Pinpoint, esse valor é exibido como o ID do projeto na página Todos os projetos.

• Intervalo de datas: opcionalmente, a primeira e a última data e hora do intervalo de datas para o qual consultar dados. Os intervalos de datas são inclusivos e devem estar limitados a 31 dias ou menos. Além disso, eles devem começar em menos de 90 dias a partir do dia atual. Se você não especificar um intervalo de datas, o Amazon Pinpoint consultará automaticamente os dados dos 31 dias corridos anteriores.

• Métrica: o nome da métrica a ser consultada, mais especificamente o valor kpi-name da métrica. Para obter uma lista completa das métricas compatíveis e o valor kpi-name de cada uma, consulte Métricas padrão para projetos, campanhas e jornadas.

Também ajuda determinar se você deseja agrupar os dados por um campo relevante. Se o fizer, poderá simplificar a análise e a emissão de relatórios escolhendo uma métrica projetada para agrupar dados automaticamente para você. Por exemplo, o Amazon Pinpoint fornece várias métricas padrão que relatam o número de mensagens SMS transacionais que foram entregues aos destinatários. Uma dessas métricas agrupa automaticamente os dados por data (txn-sms-delivered-grouped-by-date). Outra métrica agrupa automaticamente os dados por país ou região (txn-sms-delivered-grouped-by-country). Uma terceira métrica simplesmente retorna um único valor: a quantidade de mensagens que foram entregues aos destinatários (txn-sms-delivered). Se você não conseguir encontrar uma métrica padrão que agrupe dados da maneira desejada, poderá desenvolver uma série de consultas que retornem os dados desejados. Depois, é possível dividir manualmente ou combinar os resultados da consulta em grupos personalizados criados.

Por fim, é importante verificar se você está autorizado a acessar os dados que deseja consultar. Para obter mais informações, consulte Políticas do IAM para consulta de dados de análise do Amazon Pinpoint.