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:
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:
Você verá a ID do projeto no lado direito:
Neste exercício, você aprenderá a obter os outros 3 campos obrigatórios:
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.
Quando estiver na home page, vá para o menu esquerdo e clique em APIs & Services, em seguida, clique em Dashboard.
Agora você verá a página inicial das APIs & Services.
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:
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.
Você verá isso:
Selecione o Tipo de Usuário: Externo. Em seguida, clique em CREATE.
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 |
Em seguida, role para baixo até ver Developer contact information e preencha um endereço de email.
Clique em SALVAR E CONTINUAR.
Você verá isso. Clique em SALVAR E CONTINUAR.
Você verá isso. Clique em SALVAR E CONTINUAR.
Você verá isso. Clique em VOLTAR PARA O PAINEL.
Você verá isso. Clique em PUBLICAR APLICATIVO.
Clique em CONFIRM.
Você verá isso.
Na próxima etapa, você concluirá a configuração da API e obterá as credenciais da API.
No menu esquerdo, clique em Credentials. Você verá isso:
Clique no botão + CRIAR CREDENCIAIS.
Você verá 3 opções. Clique no ID de cliente OAuth:
Na próxima tela, selecione Web application.
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.
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:
Agora você verá sua ID do cliente e seu Segredo do cliente.
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.
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.
Clique no ícone engrenagem no lado superior direito da tela:
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
Dois campos devem aparecer e você tem o valor para eles.
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) |
Copie o ID do cliente e o Segredo do cliente do arquivo de texto criado na área de trabalho.
Depois de preencher suas credenciais, clique em Fechar
No menu esquerdo, você pode ver todas as APIs do Google disponíveis. Procure por API BigQuery v2.
Em seguida, selecione o escopo conforme indicado na imagem abaixo:
Depois de selecioná-los, você deve ver um botão azul que diz Autorizar APIs. Clique nele.
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.
Em seguida, clique em Ir para ldap - AEP BigQuery Connector (não seguro).
Você será redirecionado para nossa Tela de consentimento do OAuth criada.
Se usar a Autenticação de dois fatores (2FA), digite o código de verificação enviado para você.
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.
Após as oito solicitações de permissão, você verá essa visão geral. Clique em Permitir para concluir o processo.
Após o último Allow-click, você será enviado de volta para o ambiente de reprodução OAuth 2.0 e você verá isso:
Clique em Código de autorização de troca para tokens.
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.
Agora você verá o Atualizar token.
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.
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.
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.
Depois de selecionar a sandbox apropriada, você verá a tela mudar e agora estará na sandbox dedicada.
No menu esquerdo, vá para Fontes.
Você verá a página inicial Fontes. No menu Fontes, clique em Bancos de Dados.
Clique no cartão Google BigQuery. Em seguida, clique em + Configurar.
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.
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:
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:
Depois de preencher todos esses campos, clique em Conectar à fonte.
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.
Agora que sua conexão foi criada, clique em Next:
Agora você verá o conjunto de dados BigQuery criado durante o exercício 16.2.
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