Integração do Looker: Segmentação por lista de clientes do Google Ads

As instâncias hospedadas pelo cliente podem não conseguir ativar ações do Hub de ações do Looker, principalmente ações que oferecem suporte a resultados transmitidos em streaming ou que usam OAuth, se a instância do Looker hospedada pelo cliente não atender aos requisitos do Hub de ações do Looker.

Consulte a página de documentação Compartilhamento de dados por meio de um hub de ações para conferir soluções sugeridas para esse possível problema.

O Looker oferece uma integração chamada segmentação por lista de clientes do Google Ads para que os usuários enviem segmentos e públicos-alvo com base em dados próprios do Looker diretamente para o Google Ads. É possível fazer a autenticação com suas credenciais do Google e enviar envios de dados únicos ou recorrentes para o destino do Google Ads.

Como ativar a ação

Um administrador do Looker precisa ativar essa ação seguindo estas etapas:

  1. Acesse a página Ações no painel Administrador do Looker.
  2. Ao lado da ação Correspondência de clientes do Google Ads, clique em Ativar. Clique no botão Atualizar se as ações não aparecerem na lista.
  3. Ative a opção Ativar e clique em Salvar.

Depois de ativada, essa ação vai aparecer como uma opção de destino para envios de dados no Programador.

Uma Conta do Google individual só pode ser conectada a uma instância do Looker.

Como configurar sua consulta do Looker

Antes de usar a ação de Segmentação por lista de clientes do Google Ads, verifique se as colunas rótulos da sua consulta do Looker estão mapeadas corretamente para os identificadores de usuário no Google Ads.

O Looker verifica cada rótulo de coluna na consulta em relação aos seguintes conjuntos de regex e mapeia o rótulo da coluna para os identificadores de usuário no Google Ads com base na primeira correspondência de regex. Todas as condições de regex não diferenciam maiúsculas de minúsculas.

Você pode fazer upload de dados do CRM ou de dispositivos móveis. Os dados de dispositivos móveis não podem ser combinados com outros tipos de dados do CRM.

Estas são as condições de regex para identificadores de usuários em dados de CRM: 

[/email/i, "hashed_email"],
[/phone/i, "hashed_phone_number"],
[/first/i, "address_info.hashed_first_name"],
[/last/i, "address_info.hashed_last_name"],
[/street|address/i, "address_info.hashed_street_address"],
[/city/i, "address_info.city"],
[/state/i, "address_info.state"],
[/country/i, "address_info.country_code"],
[/postal|zip/i, "address_info.postal_code"]

Estas são as condições de regex para identificadores de usuários de IDs de dispositivos móveis: 

  [/idfa|identifier.for.advertising/i, "mobile_id"],
  [/aaid|advertiser.assigned.user|google.advertising/i, "third_party_user_id"]

Isso significa que um campo pode ter um valor de rótulo de "AAID", "Usuário atribuído pelo anunciante" ou "Google Advertising", e qualquer rótulo será correspondente e mapeado para o identificador third_party_user_id.

Embora cada rótulo de coluna seja mapeado para apenas um identificador, pode haver vários rótulos de coluna mapeados para o mesmo identificador. Por exemplo, em uma consulta que contém apenas work_email e home_email, ambos serão mapeados para o identificador de e-mail.

Se os rótulos das colunas não corresponderem a nenhum identificador, um desenvolvedor do Looker poderá realizar uma das seguintes ações:

  • Atualize o rótulo da coluna no LookML da consulta para incluir o termo adequado para corresponder aos seus identificadores no Google Ads.
  • Usar um campo personalizado para duplicar a coluna e atribuir um novo rótulo

Como enviar dados para a Segmentação por lista de clientes do Google Ads

É possível enviar dados de análises e visualizações para o destino de ação da Segmentação por lista de clientes do Google Ads usando o Agendador do Looker.

Verifique se a sua conta do Google Ads atende aos critérios de lista de clientes e está ativada para a lista de clientes antes de usar essa integração do Looker.

Na página "Explorar" ou "Look" selecionada, clique no menu de engrenagem no canto superior direito. Para Looks ou Análises, selecione Enviar para entregas únicas. Para Looks, selecione Programar para entregas recorrentes. Para Análises, como não há a opção de envio recorrente, selecione Salvar e programar para salvar a Análise como um Look e, em seguida, programar o Look para um envio recorrente.

Para mais informações sobre como programar entregas de dados, consulte a página de documentação Como usar o Looker Scheduler para enviar conteúdo.

A seleção de uma opção de envio abre o Scheduler para Análises e Looks. Insira um título para a entrega. Para veicular para a Segmentação por lista de clientes do Google Ads:

  1. Selecione o ícone Público-alvo por lista de clientes do Google Ads na seção Para onde vão esses dados? do Programador:
  2. Na primeira vez que você enviar para esse destino, será necessário fazer a autenticação com suas credenciais do OAuth do Google. Na seção Correspondência de clientes do Google Ads do Programador, clique no botão Fazer login com o Google.
  3. Na tela Fazer login com o Google OAuth, selecione a Conta do Google apropriada. Marque a caixa ao lado das permissões que você quer conceder ao app Looker. Clique em Continuar para confirmar sua escolha e conceder as permissões solicitadas. Se o login for concluído, você vai receber uma mensagem para fechar a guia do navegador e retornar ao Programador. Uma Conta do Google individual só pode ser conectada a uma instância do Looker.
  4. Na seção Correspondência de clientes do Google Ads do Programador, clique no botão Verificar credenciais.
  5. Depois que suas credenciais forem verificadas, um campo Choose login account vai aparecer. Selecione a conta de login adequada no menu suspenso. Para redefinir a seleção, feche e abra o formulário novamente.
  6. Selecione uma conta de destino no menu suspenso Choose target account. A conta de destino é onde você quer enviar dados, como onde as listas de público-alvo são definidas no recurso "Correspondência de clientes".
  7. No menu suspenso Criar uma nova lista ou anexar a uma existente?, escolha se quer criar uma nova lista ou anexar a uma existente. O Looker recomenda anexar a lista para ajudar a otimizar o algoritmo de lances do Google Ads. Fazer upload de uma nova lista toda vez não é uma prática recomendada, porque isso redefine os algoritmos de lances.
    • Se você selecionar Anexar à lista atual, escolha a lista que você quer anexar no menu suspenso Escolher lista para atualizar.
    • Se você selecionar Criar nova lista, insira valores para o nome e a descrição da lista nos campos Nome da nova lista e Descrição da nova lista.
  8. Determine se você quer que os dados sejam codificados antes da entrega. Todos os dados pessoais precisam ser normalizados e criptografados com hash antes de serem enviados ao Google Ads. Se os dados ainda não tiverem hash, selecione Sim, e o Looker vai tentar gerar o hash de acordo com os requisitos do Google Ads. Se você selecionar Não, os dados serão enviados conforme aparecem no Looker, o que significa que eles já precisam estar normalizados e gerar hash no seu banco de dados.
    Se os dados não forem gerados corretamente, a lista de clientes não vai corresponder a nenhum público-alvo no Google Ads.
  9. Para entregas recorrentes, defina o gatilho. Para gatilhos de Intervalo recorrente, defina a frequência com que você quer enviar esses dados. Para gatilhos de Atualização do datagroup, escolha o datagroup acionado no menu suspenso Selecionar datagroup. Aplique outros filtros à entrega programada na seção Filtros do Programador.
  10. Abra o menu Opções avançadas no Programador. Selecione Todos os resultados. Para entregas recorrentes, selecione outras condições de programação que você gostaria de definir para a entrega.
  11. Revise suas configurações de entrega. Para entregas únicas, clique em Enviar. Para entregas recorrentes, clique em Salvar tudo.

Solução de problemas

  • Se a conta de destino selecionada na etapa 6 anterior não tiver pelo menos uma lista de usuários baseada em CRM aberta para associações, um erro vai aparecer se você selecionar Anexar ao existente. Para resolver esse problema, crie uma nova lista enviando a entrega como uma única vez ou criando uma lista no Google Ads. Depois que a lista for criada, ela vai estar disponível para seleção como uma opção quando "Anexar ao existente" for selecionado no menu suspenso Criar uma nova lista ou anexar ao existente?.
  • Se a sua conta do Google Ads não estiver ativada para a Segmentação por lista de clientes, não será possível usar essa integração do Looker. Confira se a sua conta do Google Ads atende aos requisitos da política de Segmentação por lista de clientes.
  • Uma Conta do Google individual pode ser conectada a apenas uma instância do Looker. Se você quiser conectar a ação de correspondência do cliente ao Google Ads de outra instância do Looker, remova o acesso do Looker à sua Conta do Google e reautorize o acesso do Looker à sua Conta do Google nessa instância.

Como remover a ação

Para remover essa integração, acesse sua Conta de usuário do Google e remova o acesso à conta do aplicativo Looker.