Consultar dados de análise do Amazon Pinpoint para mensagens transacionais - Amazon Pinpoint
Pré-requisitos

Aviso de fim do suporte: em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para obter mais informações, consulte Fim do suporte do Amazon Pinpoint. Observação: APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 as APIs do Amazon Pinpoint 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 para as 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ê usar as APIs do Amazon Pinpoint Analytics para consultar dados, poderá escolher várias opções que definem o escopo, os dados, o agrupamento e os filtros para a 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.