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á.
Como usar análise do Amazon Pinpoint com grupos de usuários do Amazon Cognito
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 à análise do Amazon Pinpoint em grupos de usuários do Amazon Cognito, você pode rastrear inscrições, logins, falhas de autenticação do grupo de usuários, DAUs (usuários ativos diários) e MAUs (usuários ativos mensais) no console do Amazon Pinpoint. 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 no grupo de usuários com o console do Amazon Cognito, você também cria um perfil vinculado ao serviço que o Amazon Cognito assume quando faz uma solicitação de API ao Amazon Pinpoint para o grupo de usuários. A entidade principal do IAM que adiciona sua configuração de análise deve ter permissões CreateServiceLinkedRole. O perfil vinculado ao serviço é denominado AWSServiceRoleForAmazonCognitoIdp
Ao aplicar uma AnalyticsConfiguration ao cliente da aplicação na API do Amazon Cognito, você pode atribuir um perfil do IAM personalizado ao Amazon Pinpoint e um ID externo para assumir o perfil. 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 mapeamentos de Região da AWS entre o Amazon Cognito e o Amazon Pinpoint que atendem a uma das condições a seguir.
-
É 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 (Bahrein)
-
Á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 todas as Regiões da AWS exceto aquelas na tabela anterior, o Amazon Cognito só pode usar um projeto do Amazon Pinpoint na mesma região do 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 o grupo de usuários para se associar a um projeto do Amazon Pinpoint, você deverá incluir AnalyticsMetadata em suas solicitações de API. Para obter mais informações, consulte Integrar sua aplicação ao Amazon Pinpoint.
Para especificar as configurações de análise
-
Acesse o console do Amazon Cognito
. Podem ser solicitadas suas credenciais da AWS. -
Selecione User Pools (Grupos de usuários) e escolha um grupo de usuários existente na lista.
-
Escolha a guia App integration (Integração da aplicação).
-
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.
-
Em Pinpoint analytics (Análise do Pinpoint), selecione Enable (Habilitar).
-
Escolha uma Pinpoint Region (Região do Pinpoint).
-
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.
-
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.
-
Save changes (Salvar alterações).
Como especificar configurações de análise do Amazon Pinpoint (AWS CLI e API da AWS)
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
-
AWS CLI:
aws cognito-idp create-user-pool-client -
API da AWS: CreateUserPoolClient
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
-
AWS CLI:
aws cognito-idp update-user-pool-client -
API da AWS: UpdateUserPoolClient
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 nativos do Amazon Cognito na API de grupos de usuários.
- 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.
- API de grupos de usuários
-
As operações que você pode integrar a um AWS SDK usando uma aplicação 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 Referência de API do Amazon Cognito para ter uma lista de operações da API de grupos de usuários.
Depois de configurar seu grupo de usuários para publicar em uma campanha, o Amazon Cognito transmite metadados ao Amazon Pinpoint para as operações de API a seguir.
-
AdminInitiateAuth -
AdminRespondToAuthChallenge -
ConfirmForgotPassword -
ConfirmSignUp -
ForgotPassword -
InitiateAuth -
ResendConfirmationCode -
RespondToAuthChallenge -
SignUp
Para transmitir metadados sobre a sessão do usuário à sua campanha do Amazon Pinpoint, inclua um valor AnalyticsEndpointId no parâmetro AnalyticsMetadata da solicitação de API. Para ver um exemplo de JavaScript, 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?
Como configurar a análise do grupo de usuários
Usando a análise do Amazon Pinpoint, você pode rastrear cadastros, logins, falhas de autenticação do grupo de usuários, usuários ativos diariamente (DAUs) e usuários ativos mensalmente (MAUs) do Amazon Cognito. Você também pode configurar atributos de usuário específicos para sua aplicação usando o AWS Mobile SDK for Android ou o AWS Mobile SDK for iOS. Eles poderão ser usados para segmentar seus usuários no Amazon Pinpoint e enviar a eles notificações por push direcionadas.
Na guia Integração de aplicações em Clientes e análises de aplicativos, você pode navegar até um cliente de aplicação existente ou criar um. Na configuração do seu cliente de aplicativo, você pode especificar um projeto do Amazon Pinpoint que deseja usar com sua aplicação. Para obter mais informações, consulte Usar análise do Amazon Pinpoint com grupos de usuários do Amazon Cognito.
nota
O Amazon Pinpoint está disponível em várias regiões da AWS na América do Norte, Europa, Ásia e Oceania. As regiões do Amazon Pinpoint incluem a API do Amazon Pinpoint. Se uma região do Amazon Pinpoint for compatível com o Amazon Cognito, o Amazon Cognito enviará eventos para projetos do Amazon Pinpoint dentro da mesma região do Amazon Pinpoint. Se uma região não for comportada pelo Amazon Pinpoint, o Amazon Cognito somente poderá enviar eventos na região us-east-1. Para obter informações detalhadas sobre regiões do Amazon Pinpoint, consulte Endpoints e cotas do Amazon Pinpoint e Usar análise do Amazon Pinpoint com grupos de usuários do Amazon Cognito.
Para adicionar análises e campanhas
-
Selecione Add analytics and campaigns.
-
Selecione um Cognito app client na lista.
-
Para mapear sua aplicação do Amazon Cognito para um Projeto do Amazon Pinpoint, escolha o projeto do Amazon Pinpoint na lista.
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.
-
Escolha Share user attribute data with Amazon Pinpoint (Compartilhar dados do atributo do usuário com o Amazon Pinpoint) se você quiser que o Amazon Cognito envie endereços de e-mail e números de telefone para o Amazon Pinpoint para criar endpoints adicionais para os usuários.
nota
Um endpoint identifica exclusivamente um dispositivo de usuário ao qual você pode enviar notificações por push com o Amazon Pinpoint. Para obter mais informações sobre endpoints, consulte Adicionar endpoints no Guia do desenvolvedor do Amazon Pinpoint.
-
Insira uma função do IAM que você já criou ou selecione Create new role (Criar nova função) para criar uma nova função no console do IAM.
-
Save changes (Salvar alterações).
-
Para especificar mapeamentos de aplicações adicionais, escolha Add app mapping (Adicionar mapeamento de aplicações).
-
Save changes (Salvar alterações).
