Usando o Amazon Pinpoint para análise de grupos de usuários - Amazon Cognito

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

Usando o Amazon Pinpoint para análise de grupos de usuários

Os grupos de usuários do Amazon Cognito são integrados ao Amazon Pinpoint para fornecer análise para grupos de usuários do Amazon Cognito e para enriquecer os dados do usuário para campanhas do Amazon Pinpoint. O Amazon Pinpoint fornece análise e campanhas direcionadas para promover o envolvimento dos usuários em aplicações móveis usando notificações por push. Com o suporte analítico do Amazon Pinpoint nos grupos de usuários do Amazon Cognito, você pode rastrear inscrições, logins, autenticações falhadas, usuários ativos diários () e usuários ativos mensais DAUs () no console do Amazon Pinpoint. MAUs Você pode analisar os dados em diferentes faixas de datas ou de atributos, como plataforma de dispositivos, local do dispositivo e versão do aplicativo.

Também é possível configurar atributos personalizados para a aplicação. Eles poderão ser usados para segmentar seus usuários no Amazon Pinpoint e enviar notificações por push direcionadas a eles. Se você selecionar Share user attribute data with Amazon Pinpoint (Compartilhar dados de atributos do usuário com o Amazon Pinpoint) na guia Analytics (Análise) no console do Amazon Cognito, o Amazon Pinpoint cria endpoints adicionais para os endereços de e-mail e números de telefone do usuário.

Ao ativar a análise do Amazon Pinpoint em seu grupo de usuários com o console do Amazon Cognito, você também cria uma função vinculada ao serviço que o Amazon Cognito assume ao fazer uma API solicitação ao Amazon Pinpoint para seu grupo de usuários. O IAM diretor que adiciona sua configuração de análise deve ter CreateServiceLinkedRolepermissões. A função vinculada ao serviço é. AWSServiceRoleForAmazonCognitoIdp Para obter mais informações, consulte Como usar funções vinculadas a serviço para o Amazon Cognito.

Ao aplicar um AnalyticsConfiguration ao seu cliente de aplicativo no Amazon CognitoAPI, você pode atribuir uma IAM função personalizada para o Amazon Pinpoint e uma ID externa para assumir a função. O perfil deve confiar na entidade principal do serviço cognito-idp e, se a política de confiança do perfil exigir um ID externo, ela deverá corresponder à sua AnalyticsConfiguration. Você deve conceder as permissões cognito-idp:Describe* do perfil e as permissões a seguir a seu projeto do Amazon Pinpoint.

  • mobiletargeting:UpdateEndpoint

  • mobiletargeting:PutEvents

Disponibilidade de regiões do Amazon Cognito e Amazon Pinpoint

A tabela a seguir mostra os Região da AWS mapeamentos entre o Amazon Cognito e o Amazon Pinpoint que atendem a uma das seguintes condições.

  • É possível usar somente um projeto do Amazon Pinpoint na região Leste dos EUA (Norte da Virgínia) (us-east-1).

  • É possível usar um projeto do Amazon Pinpoint na mesma região ou na região Leste dos EUA (Norte da Virgínia) (us-east-1).

Por padrão, o Amazon Cognito só pode enviar análises para um projeto do Amazon Pinpoint na mesma Região da AWS. As exceções a essa regra são as regiões na tabela a seguir e as regiões em que o Amazon Pinpoint não está disponível.

O Amazon Pinpoint já está disponível nas regiões a seguir. Os grupos de usuários do Amazon Cognito nessas regiões não são compatíveis com a análise.

  • Europa (Milão)

  • Oriente Médio (Barém)

  • Ásia-Pacífico (Osaka)

  • Israel (Tel Aviv)

  • África (Cidade do Cabo)

  • Ásia-Pacífico (Jacarta)

A tabela mostra a relação entre a região em que você criou o grupo de usuários do Amazon Cognito e a região correspondente no Amazon Pinpoint. É necessário configurar o projeto do Amazon Pinpoint em uma região disponível para integrá-lo ao Amazon Cognito.

Região do grupo de usuários do Amazon Cognito Região do projeto do Amazon Pinpoint

ap-northeast-1

us-east-1

ap-northeast-2

us-east-1

ap-south-1

us-east-1, ap-south-1

ap-southeast-1

us-east-1

ap-southeast-2

us-east-1, ap-southeast-2

ca-central-1

us-east-1

eu-central-1

us-east-1, eu-central-1

eu-west-1

us-east-1, eu-west-1

eu-west-2

us-east-1

us-east-1

us-east-1

us-east-2

us-east-1

us-west-2

us-east-1, us-west-2

Exemplos de mapeamento de região

  • Se criar um grupo de usuários na região ap-northeast-1, você poderá criar o projeto do Amazon Pinpoint na região us-east-1.

  • Se criar um grupo de usuários na região ap-south-1, você poderá criar o projeto do Amazon Pinpoint na região us-east-1 ou ap-south-1.

nota

Para todos Regiões da AWS , exceto aqueles na tabela anterior, o Amazon Cognito só pode usar um projeto Amazon Pinpoint na mesma região do seu grupo de usuários. Se o Amazon Pinpoint não estiver disponível na região onde você criou o grupo de usuários e não estiver listado na tabela, o Amazon Cognito não será compatível com as análises do Amazon Pinpoint nessa região. Para obter informações detalhadas sobre Região da AWS , consulte Amazon Pinpoint endpoints and quotas (Endpoints e cotas do Amazon Pinpoint).

Como especificar configurações de análise do Amazon Pinpoint (AWS Management Console)

É possível configurar o grupo de usuários do Amazon Cognito para enviar dados de análise ao Amazon Pinpoint. O Amazon Cognito só envia dados de análise ao Amazon Pinpoint para usuários locais. Depois de configurar seu grupo de usuários para se associar a um projeto do Amazon Pinpoint, você deve incluir AnalyticsMetadata em suas API solicitações. Para obter mais informações, consulte Integrar sua aplicação ao Amazon Pinpoint.

Para especificar as configurações de análise
  1. Acesse o console do Amazon Cognito. Podem ser solicitadas suas credenciais da AWS .

  2. Selecione User Pools (Grupos de usuários) e escolha um grupo de usuários existente na lista.

  3. Escolha a guia Integração do aplicativo ().

  4. Em App clients and analytics (Clientes e análise da aplicação), escolha um App client name (Nome do cliente da aplicação) existente na lista.

  5. Em Pinpoint analytics (Análise do Pinpoint), selecione Enable (Habilitar).

  6. Escolha uma Pinpoint Region (Região do Pinpoint).

  7. Escolha um Amazon Pinpoint project (Projeto do Amazon Pinpoint) ou selecione Create Amazon Pinpoint project (Criar projeto do Amazon Pinpoint.

    nota

    O ID de projeto do Amazon Pinpoint é uma string de 32 caracteres exclusiva para seu projeto do Amazon Pinpoint. Ele está listado no console do Amazon Pinpoint.

    É possível mapear várias aplicações do Amazon Cognito em um único projeto do Amazon Pinpoint. No entanto, cada aplicação do Amazon Cognito pode ser mapeada somente em um projeto do Amazon Pinpoint.

    No Amazon Pinpoint, cada projeto deve ser uma única aplicação. Por exemplo, se um desenvolvedor de jogos tiver dois jogos, cada jogo deverá ser um projeto do Amazon Pinpoint separado, mesmo se os dois jogos usarem o mesmo grupo de usuários do Amazon Cognito. Para obter mais informações sobre projetos do Amazon Pinpoint, consulte Criar um projeto no Amazon Pinpoint.

  8. Em User data sharing (Compartilhamento de dados de usuários), selecione Share user data with Amazon Pinpoint (Compartilhar dados de usuários com o Amazon Pinpoint) se quiser que o Amazon Cognito envie endereços de e-mail e números de telefone ao Amazon Pinpoint e crie endpoints adicionais para os usuários. Depois que os usuários verificarem o endereço de e-mail e número de telefone, o Amazon Cognito só compartilhará esses dados com o Amazon Pinpoint se eles estiverem disponíveis para a conta do usuário.

    nota

    Um endpoint identifica exclusivamente um dispositivo de usuário ao qual você pode enviar notificações por push com o Amazon Pinpoint. Para mais informações sobre endpoints, consulte Adicionar endpoints no Guia do desenvolvedor do Amazon Pinpoint.

  9. Escolha Salvar alterações.

Especificação das configurações AWS CLI de análise do Amazon Pinpoint (e) AWS API

Use os comandos a seguir para especificar as configurações de análise do Amazon Pinpoint para seu grupo de usuários.

Para especificar as configurações de análise para o aplicativo cliente existente de seu grupo de usuários no momento da criação do aplicativo
Para atualizar as configurações de análise para o aplicativo cliente existente de seu grupo de usuários no momento da criação do aplicativo
nota

O Amazon Cognito oferece suporte a integrações na região quando você usa o ApplicationArn

Integrar sua aplicação ao Amazon Pinpoint

Você pode publicar metadados de análise no Amazon Pinpoint para usuários locais do Amazon Cognito nos grupos de usuários. API

Usuários locais

Usuários que se cadastraram em uma conta ou foram criados em seu grupo de usuários, em vez daqueles que fazem login por meio de um provedor de identidades (IdP) de terceiros.

Grupos de usuários API

As operações que você pode integrar com um AWS SDK, usando um aplicativo com uma interface de usuário (UI) personalizada. Você não pode transmitir metadados de análise para usuários federados ou nativos que fazem login por meio da interface do usuário hospedada. Consulte a APIReferência do Amazon Cognito para obter uma lista de operações de grupos API de usuários.

Depois de configurar seu grupo de usuários para publicar em uma campanha, o Amazon Cognito passa os metadados para o Amazon Pinpoint para as seguintes operações. API

  • AdminInitiateAuth

  • AdminRespondToAuthChallenge

  • ConfirmForgotPassword

  • ConfirmSignUp

  • ForgotPassword

  • InitiateAuth

  • ResendConfirmationCode

  • RespondToAuthChallenge

  • SignUp

Para passar metadados sobre a sessão do seu usuário para sua campanha do Amazon Pinpoint, inclua AnalyticsEndpointId um valor no parâmetro AnalyticsMetadata da API sua solicitação. JavaScript Por exemplo, consulte Por que minhas análises do grupo de usuários do Amazon Cognito não estão aparecendo no meu painel do Amazon Pinpoint? no Centro de AWS Conhecimento.