16.3 Conecte o GCP e o BigQuery à Adobe Experience Platform

Objetivos

  • Explore a API e os serviços na plataforma do Google Cloud
  • Familiarize-se com o OAuth Playground para testar as APIs do Google
  • Criar sua primeira conexão BigQuery na Adobe Experience Platform

Contexto

A Adobe Experience Platform fornece um conector dentro de Fontes que ajudará você a trazer conjuntos de dados BigQuery para a Adobe Experience Platform. Esse conector de dados é baseado na API do Google BigQuery. Portanto, é importante preparar apropriadamente sua plataforma da Google Cloud e seu ambiente BigQuery para receber chamadas de API da Adobe Experience Platform.

Para configurar o Conector de fonte BigQuery na Adobe Experience Platform, você precisará desses quatro valores:

  • projeto
  • clientId
  • clientSecret
  • refreshToken

Até agora, você tem apenas o primeiro, o ID do projeto. Este valor ID do projeto é uma ID aleatória que foi gerada pelo Google quando você criou seu projeto BigQuery durante o exercício 16.1.

Copie a ID do projeto em um arquivo de texto separado.

Credencial Nomenclatura Exemplo
ID do projeto random parent-task-306413

Você pode verificar a ID do projeto a qualquer momento clicando em seu Nome do projeto na barra do menu superior:

demonstração

Você verá a ID do projeto no lado direito:

demonstração

Neste exercício, você aprenderá a obter os outros 3 campos obrigatórios:

  • clientId
  • clientSecret
  • refreshToken

16.3.1 API e serviços da Google Cloud

Para iniciar, volte para a página inicial da Google Cloud Platform. Para fazer isso, basta clicar no logotipo no canto superior esquerdo da tela.

demonstração

Quando estiver na home page, vá para o menu esquerdo e clique em APIs & Services, em seguida, clique em Dashboard.

demonstração

Agora você verá a página inicial das APIs & Services.

demonstração

Nesta página, você pode ver o uso de suas várias conexões de API do Google. Para configurar uma conexão de API para que a Adobe Experience Platform possa ler a partir do BigQuery, siga estas etapas:

  • Primeiro, você precisa criar uma tela de consentimento do OAuth para ativar autenticações futuras. Os motivos de segurança do Google também exigem que um ser humano faça a primeira autenticação, antes que um acesso programático seja permitido.
  • Em segundo lugar, você precisa de credenciais de API (clientId e clientSecret) que serão usadas para autenticação de API e acesso ao seu BigQuery Connector.

16.3.2 Tela de consentimento do OAuth

Vamos começar com a criação da Tela de consentimento do OAuth. No menu esquerdo da página inicial APIs & Services, clique em Tela de consentimento OAuth.

demonstração

Você verá isso:

demonstração

Selecione o Tipo de Usuário: Externo. Em seguida, clique em CREATE.

demonstração

Em seguida, você estará na janela Configuração da tela de consentimento OAuth.

A única coisa a fazer aqui é inserir o nome da tela de consentimento no campo Application name e selecionar o User support email. Para o nome do Aplicativo, use esta convenção de nomenclatura:

Nomenclatura Exemplo
ldap - AEP BigQuery Connector vangeluw - Conector Platform BigQuery

demonstração

Em seguida, role para baixo até ver Developer contact information e preencha um endereço de email.

demonstração

Clique em SALVAR E CONTINUAR.

demonstração

Você verá isso. Clique em SALVAR E CONTINUAR.

demonstração

Você verá isso. Clique em SALVAR E CONTINUAR.

demonstração

Você verá isso. Clique em VOLTAR PARA O PAINEL.

demonstração

Você verá isso. Clique em PUBLICAR APLICATIVO.

demonstração

Clique em CONFIRM.

demonstração

Você verá isso.

demonstração

Na próxima etapa, você concluirá a configuração da API e obterá as credenciais da API.

16.3.3 Credenciais da API do Google: Segredo do cliente e ID do cliente

No menu esquerdo, clique em Credentials. Você verá isso:

demonstração

Clique no botão + CRIAR CREDENCIAIS.

demonstração

Você verá 3 opções. Clique no ID de cliente OAuth:

demonstração

Na próxima tela, selecione Web application.

demonstração

Vários novos campos aparecerão. Agora é necessário inserir o Name da ID do cliente OAuth e também inserir os URIs de redirecionamento autorizados.

Siga esta convenção de nomenclatura:

Campo Valor Exemplo
Nome ldap - AEP BigQuery Connector vangeluw - Conector Platform BigQuery
URIs de redirecionamento autorizados https://developers.google.com/oauthplayground https://developers.google.com/oauthplayground

O campo Authorized redirect URIs é um campo muito importante porque você precisará dele posteriormente para obter o RefreshToken, é necessário concluir a configuração do Conector de fonte do BigQuery na Adobe Experience Platform.

demonstração

Antes de continuar, é necessário pressionar fisicamente o botão Enter depois de inserir o URL para armazenar o valor no campo URIs de redirecionamento autorizados. Se você não clicar no botão Enter, encontrará problemas posteriormente, no Espaço de trabalho OAuth 2.0.

Em seguida, clique em Criar:

demonstração

Agora você verá sua ID do cliente e seu Segredo do cliente.

demonstração

Copie estes dois campos e cole-os em um arquivo de texto na área de trabalho. Você sempre pode acessar essas credenciais posteriormente, mas é mais fácil salvá-las em um arquivo de texto ao lado da ID do projeto BigQuery.

Como recapitulação da configuração do BigQuery Source Connector na Adobe Experience Platform, agora você já tem esses valores disponíveis:

Credenciais do Conector BigQuery Valor
ID do projeto sua própria ID do projeto (por exemplo,: parent-task-306413)
clientid yourclientid
cilentsecret yourclientsecret

Você ainda não tem o refreshToken. O refreshToken é um requisito por motivos de segurança. No mundo das APIs, os tokens normalmente expiram a cada 24 horas. Portanto, o refreshToken é necessário para atualizar o token de segurança a cada 24 horas, para que a configuração do Conector de origem possa continuar a se conectar à Google Cloud Platform e ao BigQuery.

16.3.4 API BigQuery e refreshToken

Há muitas maneiras de obter um refreshToken para acessar as APIs da plataforma Google Cloud. Uma dessas opções é, por exemplo, usar o Postman.
No entanto, o Google criou algo mais fácil de testar e reproduzir com suas APIs, uma ferramenta chamada OAuth 2.0 Playground.

Para acessar OAuth 2.0 Playground, vá para https://developers.google.com/oauthplayground.

Você verá a página inicial do OAuth 2.0 Playground.

demonstração

Clique no ícone engrenagem no lado superior direito da tela:

demonstração

Certifique-se de que suas configurações sejam as mesmas que você pode ver na imagem acima.

Verifique novamente as configurações para ter 100% de certeza.

Quando terminar, marque a caixa de Use suas próprias credenciais do OAuth

demonstração

Dois campos devem aparecer e você tem o valor para eles.

demonstração

Preencha os campos após esta tabela:

Configurações da API de reprodução Suas credenciais da API do Google
ID do cliente OAuth sua própria ID do cliente (no arquivo de texto da área de trabalho)
Segredo do Cliente OAuth seu próprio Segredo do cliente (no arquivo de texto da área de trabalho)

demonstração

Copie o ID do cliente e o Segredo do cliente do arquivo de texto criado na área de trabalho.

demonstração

Depois de preencher suas credenciais, clique em Fechar

demonstração

No menu esquerdo, você pode ver todas as APIs do Google disponíveis. Procure por API BigQuery v2.

demonstração

Em seguida, selecione o escopo conforme indicado na imagem abaixo:

demonstração

Depois de selecioná-los, você deve ver um botão azul que diz Autorizar APIs. Clique nele.

demonstração

Selecione a conta do Google que você usou para configurar GCP e BigQuery.

Você pode ver um grande aviso: Este aplicativo não foi verificado. Isso ocorre porque o Platform BigQuery Connector ainda não foi revisado formalmente, então o Google não sabe se é um aplicativo autêntico ou não. Você deve ignorar esta notificação.

Clique em Avançado.

demonstração

Em seguida, clique em Ir para ldap - AEP BigQuery Connector (não seguro).

demonstração

Você será redirecionado para nossa Tela de consentimento do OAuth criada.

demonstração

Se usar a Autenticação de dois fatores (2FA), digite o código de verificação enviado para você.

demonstração

O Google agora mostrará oito diferentes prompts de Permissão. Clique em Permitir para todas as oito solicitações de permissão. (Esse é um procedimento que deve ser seguido e confirmado uma vez por um ser humano real, antes que a API permita solicitações programáticas)

Novamente, oito janelas pop-up diferentes não serão exibidas, você precisa clicar em Permitir para todas elas.

demonstração

Após as oito solicitações de permissão, você verá essa visão geral. Clique em Permitir para concluir o processo.

demonstração

Após o último Allow-click, você será enviado de volta para o ambiente de reprodução OAuth 2.0 e você verá isso:

demonstração

Clique em Código de autorização de troca para tokens.

demonstração

Após alguns segundos, o Step 2 - Exchange authorization code for tokens view será fechado automaticamente e você verá Step 3 - Configure request to API.

Você precisa voltar para Etapa 2 Código de autorização do Exchange para tokens, então clique em Etapa 2 Código de autorização do Exchange para tokens novamente para visualizar o Atualizar token.

demonstração

Agora você verá o Atualizar token.

demonstração

Copie o Atualizar token e cole-o no arquivo de texto na área de trabalho juntamente com as outras Credenciais do Conector de Origem do BigQuery:

Credenciais do Conector de Origem BigQuery Valor
ID do projeto sua própria ID de projeto aleatória (por exemplo,: apt-verão-273608)
clientid yourclientid
cilentsecret yourclientsecret
atualizar token yourrefreshtoken

Em seguida, vamos configurar seu Conector de origem na Adobe Experience Platform.

Exercício 16.3.5 - Conecte a plataforma com sua própria tabela BigQuery

Faça logon na Adobe Experience Platform acessando este URL: https://experience.adobe.com/platform.

Depois de fazer logon, você será direcionado para a página inicial da Adobe Experience Platform.

Assimilação de dados

Antes de continuar, é necessário selecionar uma sandbox e. A sandbox a ser selecionada é chamada de --aepSandboxId--. Você pode fazer isso clicando no texto Production Prod na linha azul na parte superior da tela.

Assimilação de dados

Depois de selecionar a sandbox apropriada, você verá a tela mudar e agora estará na sandbox dedicada.

Assimilação de dados

No menu esquerdo, vá para Fontes.

demonstração

Você verá a página inicial Fontes. No menu Fontes, clique em Bancos de Dados.

demonstração

Clique no cartão Google BigQuery. Em seguida, clique em + Configurar.

demonstração

Agora você deve criar uma nova conexão.

Clique em Nova conta. Agora é necessário preencher todos os campos abaixo, com base na configuração realizada em GCP e BigQuery.

demonstração

Vamos começar nomeando a conexão:

Use esta convenção de nomenclatura:

Credenciais do Conector BigQuery Valor Exemplo
Nome da conta ldap - Conexão BigQuery vangeluw - Conexão BigQuery
Descrição ldap - Conexão BigQuery vangeluw - Conexão BigQuery

O que deve lhe dar algo como isto:

demonstração

Em seguida, preencha os detalhes da API GCP e BigQuery Autenticação de Conta que você armazenou em um arquivo de texto no desktop:

Credenciais do Conector BigQuery Valor
ID do projeto sua própria ID de projeto aleatória (por exemplo,: apt-verão-273608)
clientId
cilentSecret
refreshToken

Seus detalhes da Autenticação de Conta agora devem ser iguais a:

demonstração

Depois de preencher todos esses campos, clique em Conectar à fonte.

demonstração

Se os detalhes de Autenticação de Conta foram preenchidos corretamente, você deverá ver uma confirmação visual de que a conexão está funcionando corretamente, vendo a confirmação Conectado.

demonstração

Agora que sua conexão foi criada, clique em Next:

demonstração

Agora você verá o conjunto de dados BigQuery criado durante o exercício 16.2.

demonstração

Muito bem! No próximo exercício, você carregará os dados dessa tabela e os mapeará em relação a um esquema e conjunto de dados na Adobe Experience Platform.

Próxima etapa: 16.4 Carregar dados do BigQuery na Adobe Experience Platform

Voltar ao Módulo 16

Voltar para todos os módulos

Nesta página