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á.
Integração com o Google Analytics
Com o conector de ação do Google Analytics, você pode acessar o Google Analytics diretamente no Amazon Quick por meio de linguagem natural. Você pode gerar relatórios, recuperar dados do público, monitorar eventos importantes e acessar métricas em tempo real sem sair do Amazon Quick.
O Amazon Quick oferece suporte a vários métodos de autenticação para o Google Analytics. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização.
-
Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Você se autentica diretamente com sua conta do Google.
-
Aplicativo OAuth personalizado — usa um cliente OAuth gerenciado pelo cliente criado no Console do Google Cloud. Essa opção dá à sua organização controle total sobre a configuração do OAuth.
Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.
Antes de começar
Verifique se você tem o seguinte antes de configurar a integração.
-
Uma conta do Google com acesso às propriedades e dados do Google Analytics que você deseja usar.
-
Para um aplicativo OAuth personalizado: acesso ao Console do Google Cloud
no site do Google com permissões para criar clientes OAuth. -
Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.
Configurando o Google Cloud
Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e acesse. Configurando o conector no Amazon Quick
Para a autenticação personalizada do aplicativo OAuth, conclua as etapas a seguir no Console do Google Cloud antes de configurar o Amazon Quick. Ao ativar a API na etapa 3, pesquise e ative a API de dados do Google Analytics.
Crie um cliente OAuth no Google Cloud Console
Crie um cliente OAuth no Console do Google Cloud para obter as credenciais de cliente necessárias para o Amazon Quick. Para obter mais informações, consulte Como usar o OAuth 2.0 para acessar as APIs do Google no site
-
Faça login no Console do Google Cloud
no site do Google. -
Crie um novo projeto ou selecione um projeto existente.
-
No painel de navegação esquerdo, escolha APIs e serviços e, em seguida, escolha Biblioteca. Pesquise a API que sua integração exige e escolha Ativar.
-
Escolha a tela de consentimento do OAuth e escolha Começar.
-
Configure a tela de consentimento:
-
Insira o nome do aplicativo e selecione um e-mail de suporte ao usuário.
-
Em Audience, escolha Interno (somente para sua organização) ou Externo (qualquer usuário do Google).
-
Adicione os detalhes de contato do desenvolvedor e escolha Criar.
-
-
Escolha Criar cliente OAuth.
-
Configure o cliente:
-
Em Tipo de aplicativo, escolha Aplicativo Web.
-
Insira um nome para seu cliente.
-
Em URIs de redirecionamento autorizados, adicione o URL de retorno de chamada do Amazon Quick:
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
-
Escolha Criar.
-
Registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick.
-
ID do cliente
-
Segredo do cliente
-
Escopos recomendados
Os escopos a seguir são solicitados quando você se conecta ao Google Analytics.
| Escopo | Description |
|---|---|
https://www.googleapis.com/auth/analytics.readonly |
Lê os dados e a configuração do Analytics. |
https://www.googleapis.com/auth/analytics.edit |
Edita a configuração e os dados do Analytics. |
openid |
Autentica a identidade do usuário. |
email |
Lê o endereço de e-mail do usuário. |
nota
Os email escopos openid e são incluídos automaticamente no fluxo de consentimento do OAuth para autenticação do usuário. Eles não são necessários para o Service-to-Service OAuth.
Configurando o conector no Amazon Quick
Conecte-se a partir da guia Disponível
Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.
-
No console do Amazon Quick, escolha Conectores.
-
Na guia Disponível, encontre o Google Analytics e escolha Connect.
-
Conclua o fluxo de login do Google e conceda as permissões solicitadas.
Em vez disso, para configurar um conector com o aplicativo OAuth personalizado, use a guia Criar para sua equipe, conforme descrito abaixo.
Crie a partir da guia Criar para sua equipe
Depois de concluir qualquer configuração necessária do Google Cloud, crie o conector no Amazon Quick.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
Encontre e escolha o Google Analytics.
nota
Se um conector do Google Analytics já existir, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha Não, criar novo.
-
Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.
-
Em Tipo de conexão, escolha Rede pública.
-
Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.
-
Para o aplicativo OAuth padrão:
Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.
-
Para o aplicativo OAuth personalizado, configure os seguintes campos:
-
URL base (opcional) — O URL base da API do Google Analytics. Exemplo:
https://analyticsdata.googleapis.com -
ID do cliente — O ID do cliente do Google Cloud OAuth.
-
Segredo do cliente — O segredo do cliente do Google Cloud OAuth.
-
URL do token — O endpoint do token. Exemplo:
https://oauth2.googleapis.com/token -
URL de autorização — O endpoint de autorização. Exemplo:
https://accounts.google.com/o/oauth2/v2/auth -
URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.
-
-
-
Escolha Próximo.
-
Se você escolher o aplicativo OAuth padrão ou o aplicativo OAuth personalizado, uma janela de autorização do Google será aberta. Revise as permissões solicitadas e escolha Permitir.
-
Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.
-
Na página Publicar, escolha quem pode acessar o conector. Você pode habilitar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.
-
Selecione Publish.
Ações disponíveis
Depois de configurar o conector, as ações a seguir estarão disponíveis.
| Categoria | Ação | Description |
|---|---|---|
| Relatórios | Criar relatório | Gera um relatório para uma propriedade. |
| Relatórios | Relatório de criação em lote | Executa vários relatórios em uma única solicitação. |
| Relatórios | Criar relatório em tempo real | Executa um relatório em tempo real para uma propriedade. |
| Relatórios | Criar relatório de funil | Executa um relatório de funil para uma propriedade. |
| Públicos | Listar públicos | Lista os públicos de uma propriedade. |
| Públicos | Criar lista de públicos-alvo | Cria uma lista de públicos para exportação. |
| Públicos | Listar listas de públicos | Lista as listas de público de uma propriedade. |
| Públicos | Obtenha a lista de públicos | Recupera dados de uma lista de públicos. |
| Públicos | Criar exportação de público | Cria uma exportação de público. |
| Públicos | Obtenha o Audience Export | Recupera dados de uma exportação de público. |
| Contas | Listar resumos de contas | Lista os resumos da conta acessíveis ao usuário. |
| Contas | Listar contas | Lista todas as contas acessíveis ao usuário. |
| Contas | Obter conta | Recupera detalhes de uma conta específica. |
| Propriedades | Adquira a propriedade | Recupera detalhes de uma propriedade específica. |
| Propriedades | Pesquisar propriedades | Pesquisa propriedades com filtragem. |
| Propriedades | Obtenha cotas de propriedade | Recupera o uso da cota de uma propriedade. |
| Eventos | Listar os principais eventos | Lista os principais eventos (conversões) de uma propriedade. |
| Metadados | Obter metadados | Recupera as dimensões e métricas disponíveis para geração de relatórios. |
| Metadados | Obtenha compatibilidade | Verifica a compatibilidade das dimensões e métricas de um relatório. |
| Anotações | Listar anotações | Lista as anotações de dados de relatórios de uma propriedade. |
nota
As ações que você pode usar dependem das propriedades e contas do Analytics acessíveis ao usuário autenticado.
Gerenciamento e solução de problemas
Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.
Problemas comuns de autenticação do Google
-
Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado) — Verifique se sua conta do Google está ativa e se você pode fazer login diretamente no site do
Google. Para o aplicativo OAuth personalizado, confirme se o URI de redirecionamento em seu cliente Google Cloud OAuth corresponde ao URL de retorno de chamada do Amazon Quick. -
Aplicativo bloqueado pelo administrador: se o administrador do Google Workspace restringir o acesso a aplicativos de terceiros, talvez você veja um erro ao tentar fazer login. Entre em contato com seu administrador do Google Workspace para permitir o aplicativo Amazon Quick.
-
Credenciais de cliente inválidas (aplicativo OAuth personalizado) — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores do seu cliente Google Cloud OAuth.
-
O pop-up de autenticação falha — Verifique se seu navegador permite pop-ups do domínio do console Amazon Quick. Tente usar um navegador diferente ou limpar o cache do navegador.
-
Permissões revogadas — Se você revogou anteriormente o Amazon Quick Access nas configurações de permissões da sua Conta do Google, você precisa se autenticar novamente editando o conector e fazendo login novamente.
-
Limitação da taxa de API do Google — o Google pode limitar as solicitações durante períodos de alto uso. Se as ações falharem, tente novamente após alguns minutos.
Analytics-specific Problemas do Google
-
API de dados do Google Analytics não ativada — verifique se a API de dados do Google Analytics está ativada em seu projeto do Google Cloud em APIs e serviços, biblioteca.
-
Nenhuma propriedade visível — verifique se a conta do Google autenticada tem acesso às propriedades do Google Analytics que você deseja consultar.
