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, 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 tendências de entrega e engajamento de 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 SDK AWS móvel, o Amazon Pinpoint estende esse suporte para incluir métricas adicionais, como a porcentagem de notificações 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ê 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, 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.