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 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ê escolher Compartilhar dados de atributos do usuário com o Amazon Pinpoint na configuração do Analytics para seu cliente do aplicativo no menu Clientes do aplicativo no console do Amazon Cognito, o Amazon Pinpoint criará endpoints adicionais para endereços de e-mail e números de telefone dos usuários.
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. O diretor do IAM que adiciona sua configuração de análise deve ter CreateServiceLinkedRolepermissões. A função vinculada ao serviço é. 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 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 (Bahrein)
-
Ásia Pacifico (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 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 do AWS . -
Selecione User Pools (Grupos de usuários) e escolha um grupo de usuários existente na lista.
-
Escolha o menu Clientes do aplicativo e selecione o cliente do aplicativo que você deseja atualizar.
-
Na guia Análise, em Pinpoint analytics, escolha 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.
-
Escolha Salvar alterações.
Especificação das configurações de análise AWS CLI ( AWS e API) do Amazon Pinpoint
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 -
AWS API: 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 -
AWS API: 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 um aplicativo com uma interface de usuário (UI) personalizada. Você não pode transmitir metadados de análise para usuários federados ou locais que fazem login por meio do login gerenciado. 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. 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?
