Consultar dados de análise do Amazon Pinpoint para campanhas - 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 campanhas

Além de usar as páginas de análise no console do Amazon Pinpoint, é possível usar as APIs do Amazon Pinpoint Analytics para consultar dados de análise de um subconjunto de métricas padrão que fornecem informações sobre as tendências de entrega e engajamento para campanhas.

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 uma ou mais campanhas. Por exemplo, você pode usar uma métrica a fim de descobrir para quantos endpoints uma mensagem de campanha foi enviada ou quantas dessas mensagens foram entregues nos endpoints desejados.

O Amazon Pinpoint coleta e agrega automaticamente esses dados para todas as suas campanhas. Os dados são armazenados por 90 dias. Se você integrou um aplicativo móvel ao Amazon Pinpoint usando um AWS Mobile SDK, o Amazon Pinpoint estenderá esse suporte para incluir métricas adicionais, como a porcentagem de notificações por push que foram abertas pelos destinatários. Para obter informações sobre como integrar um aplicativo móvel, consulte Integrar o Amazon Pinpoint à sua aplicação.

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, a campanha 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 os dados de uma ou mais campanhas.

Pré-requisitos

Antes de consultar dados de análise para uma ou mais campanhas, é útil reunir as seguintes informações, usadas para definir a consulta:

  • ID do projeto: o identificador exclusivo do projeto associado à campanha ou às campanhas. 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.

  • ID da campanha: o identificador exclusivo da campanha, se você quiser consultar os dados de apenas uma campanha. Na API do Amazon Pinpoint, esse valor é armazenado na propriedade campaign-id. Esse valor não é exibido no console.

  • 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.

  • Tipo de métrica: o tipo de métrica a consultar. Existem dois tipos: métricas de aplicativo e métricas de campanha. Uma métrica de aplicativo fornece dados para todas as campanhas associadas a um projeto, também chamadas de aplicativo. Uma métrica de campanha fornece dados para apenas uma campanha.

  • 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 a porcentagem de mensagens que foram entregues aos destinatários de uma campanha. Uma dessas métricas agrupa automaticamente os dados por data (successful-delivery-rate-grouped-by-date). Outra métrica agrupa automaticamente os dados por execução de campanha (successful-delivery-rate-grouped-by-campaign-activity). Uma terceira métrica simplesmente retorna um único valor: a porcentagem de mensagens que foram entregues aos destinatários por todas as execuções de campanha (successful-delivery-rate).

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.