Visão geral para configuração da conta do Ads Data Hub
Esta visão geral fornece um resumo detalhado das etapas necessárias para configurar uma conta do Ads Data Hub:
- Determine a estrutura da sua conta: escolha entre uma conta de nível único (recomendada para a maioria das organizações) ou uma conta de nível duplo para estruturas complexas com vários anunciantes.
- Configure seus projetos na nuvem do Google Cloud: designe um projeto na nuvem do Google Cloud como seu projeto de administrador, ative a API Ads Data Hub (
adsdatahub.googleapis.com) e a API BigQuery (bigquery.googleapis.com), crie um conjunto de dados do BigQuery e conceda à conta de serviço do Ads Data Hub (um agente de serviço por produto e por projeto do Google Cloud ou P4SA) permissão para ler e gravar nos seus conjuntos de dados. - Provisionar o acesso do usuário: atribua papéis de acesso do usuário aos usuários na sua conta do Ads Data Hub e configure as permissões do IAM do BigQuery.
- Vincular dados à sua conta do Ads Data Hub: conecte suas contas da plataforma de publicidade do Google vinculando contas no Ads Data Hub.
Estruturar sua conta do Ads Data Hub
Confira os dois tipos de estrutura de conta nas seções a seguir. Depois de determinar a estrutura necessária para sua organização, informe seu representante do Google. Se você achar que nenhuma delas atende aos seus requisitos, consulte o representante do Google.
Conta de camada única
A conta da camada única é uma conta do Ads Data Hub sem subcontas. É a estrutura recomendada e mais comum para a maioria dos clientes. Nesse tipo de estrutura, os dados de anúncios são vinculados diretamente à sua conta do Ads Data Hub, e o acesso aos dados é determinado exclusivamente pelas funções de acesso do usuário.
Conta de camada dupla
Se você precisa que sua conta do Ads Data Hub pareça uma estrutura organizacional complexa, é necessário ter uma conta de camada dupla. Nesse tipo de estrutura, sua conta do Ads Data Hub (chamada de conta principal) contém várias contas secundárias. Os dados de anúncios são vinculados às contas secundárias, e o acesso do usuário pode ser restrito pela atribuição de usuários a contas secundárias específicas. O relacionamento entre as contas mãe e filha é imutável, ou seja, não é possível mover contas filhas para outra conta mãe. Cada conta do Ads Data Hub (e cada conta secundária) precisa de um projeto na nuvem distinto do Google Cloud designado como o único projeto de administrador para essa conta do Ads Data Hub. Essa relação precisa ser de 1 para 1: um único projeto do Google Cloud não pode servir como projeto de administrador para várias contas do Ads Data Hub.
Os conjuntos de dados do BigQuery precisam estar na mesma região da sua conta do Ads Data Hub (US, EU, asia-northeast1 ou australia-southeast1). Todas as contas secundárias herdam a região da conta principal do Ads Data Hub.
Este gráfico compara os dois tipos de estrutura de conta:
| Camada única | Camada dupla | |
|---|---|---|
| Casos de uso típicos | Anunciantes | Agências Anunciantes com uma estrutura organizacional complexa |
| Exemplo de diagrama |
|
|
| Vinculação de dados | ||
| Pressupõe que o proprietário da conta do Ads Data Hub também é o proprietário da conta da plataforma de publicidade. | ||
| As contas da plataforma de publicidade do Google estão vinculadas diretamente à sua conta do Ads Data Hub. | ||
| Contas filhas, que representam anunciantes específicos, são criadas na sua conta do Ads Data Hub. | ||
| As contas da plataforma de publicidade do Google são associadas às suas contas filhas do Ads Data Hub usando dados de anúncios dos IDs. Um ID da plataforma de publicidade pode ser associado a cada dado do anúncio do ID. | ||
| Gerenciamento de usuários | ||
| Gerenciamento de usuários simples. Os usuários são provisionados diretamente na sua conta do Ads Data Hub. Os usuários com acesso a essa conta podem conferir todos os dados dos anúncios vinculados dela. |
||
| Gerenciamento de usuários granular. Os usuários provisionados diretamente na sua conta do Ads Data Hub podem acessar todos os dados de anúncios vinculados a todas as contas filhas. Os usuários provisionados em uma determinada conta filha podem acessar todos os dados de anúncios vinculados a ela. Eles não podem acessar dados de outras contas filhas. |
||
| Requisitos do Cloud | ||
| É necessário ter um projeto administrativo do Google Cloud para sua conta do Ads Data Hub (relação de 1 para 1). | ||
| É necessário ter um projeto administrativo do Google Cloud para sua conta do Ads Data Hub, além de um projeto distinto do Google Cloud para cada conta secundária (cada um em uma relação de 1 para 1). | ||
| Os dados podem ser importados de várias regiões do Cloud para a mesma conta do Ads Data Hub. | ||
| Combinação de dados | ||
| Os dados de diferentes contas da plataforma de publicidade vinculadas à mesma conta (ou à mesma conta secundária) podem ser agrupados na mesma consulta. Não é possível mesclar dados de diferentes contas secundárias na mesma consulta. | ||
Configurar seus projetos do Google Cloud (configuração manual)
O projeto do Google Cloud contém os resultados do Ads Data Hub e todos os dados próprios usados para gravar agregações próprias. Além disso, os projetos do Google Cloud são a base do faturamento e do uso dos serviços do Cloud.
Saiba como o Ads Data Hub funciona com o BigQuery.
Saiba como criar um projeto do Google Cloud.
Designar um projeto de administrador
Para fins administrativos, sua conta do Ads Data Hub é criada inicialmente com um projeto designado do Google Cloud, conhecido como projeto de administrador. Depois de definida, essa designação de projeto de administrador não pode ser alterada. Essa relação é estritamente de 1 para 1: um único projeto do Google Cloud não pode ser designado como o projeto de administrador de várias contas (ou contas secundárias) do Ads Data Hub.
Além do projeto de administrador designado, sua conta do Ads Data Hub pode ler dados de entrada e gravar resultados de saída em conjuntos de dados do BigQuery em qualquer número de projetos na nuvem do Google Cloud. O acesso a esses conjuntos de dados é controlado pela concessão à conta de serviço do Ads Data Hub (um agente de serviço por produto e por projeto do Google Cloud, ou P4SA) das permissões apropriadas do BigQuery nos conjuntos de dados ou projetos na nuvem necessários, que podem ser atualizados a qualquer momento.
Não é possível designar outro projeto de administrador após a seleção inicial. Se você mudar o projeto de administrador, é possível que sua conta do Ads Data Hub seja corrompida. Portanto, é essencial indicar um projeto permanente do Google Cloud ao configurar a conta. Desativar a API Ads Data Hub do seu projeto de administrador ou excluir esse projeto pode causar perda de dados e criar problemas ao acessar sua conta do Ads Data Hub. Além disso, antecipe todas as mudanças futuras na organização (como convenções de nomenclatura) que podem exigir a mudança do projeto de administrador.
Se o projeto de administrador for excluído acidentalmente ou se você precisar de ajuda para restaurar o acesso à sua conta, entre em contato com o suporte do Ads Data Hub.
Exemplos de configurações de projetos do Google Cloud
A maioria dos usuários pode utilizar um único projeto (a configuração padrão) que gerencia todas as funcionalidades. Isso inclui dados de entrada e saída. Essa é a configuração recomendada, porque a introdução de mais projetos aumenta a complexidade e a sobrecarga. No entanto, se a configuração do projeto único não atender às suas necessidades, trabalhe com seu representante do Google para determinar qual estrutura vai funcionar melhor.
A configuração padrão, um único projeto usado para todas as funcionalidades:

Projeto de entrada diferente, projeto de administrador para administração e saída:

Ativar a API no seu projeto de administrador
Antes de criar uma conta do Ads Data Hub, é necessário ativar a
API Ads Data Hub
(nome do serviço: adsdatahub.googleapis.com,
"API para executar consultas do Ads Data Hub") e a
API BigQuery
(nome do serviço: bigquery.googleapis.com,
"Uma plataforma de dados para os clientes criarem, gerenciarem, compartilharem e consultarem dados") no seu
projeto de administrador.
O usuário que ativa as APIs precisa ter a permissão serviceusage.services.enable no projeto de administrador. Pode ser alguém de fora da sua organização.
Saiba como ativar a API Ads Data Hub.
Criar um conjunto de dados do BigQuery
Os conjuntos de dados do BigQuery são onde os resultados do Ads Data Hub são gravados e um dos lugares onde você pode analisar melhor as informações.
Durante a criação da conta, um conjunto de dados padrão é inserido nas configurações da sua conta do Ads Data Hub. Esse conjunto de dados é onde os resultados são gravados quando você não especifica um conjunto de dados durante a execução da consulta.
O ID do conjunto de dados consiste nos nomes padrão do projeto e do conjunto de dados, por exemplo: projectName.datasetName.
Saiba como criar conjuntos de dados no BigQuery.
Os conjuntos de dados de entrada e saída do BigQuery precisam estar no local correspondente à região da sua conta do Ads Data Hub:
- Contas dos EUA: especifique a multirregião
US. - Contas da UE: especifique a multirregião
EU. - Contas da Ásia-Pacífico: especifique
asia-northeast1(Tóquio) ouaustralia-southeast1(Sydney), de acordo com sua conta.
Os jobs vão falhar se o local de um conjunto de dados não corresponder à região da sua conta (por exemplo, especificar us-east1 para uma conta na multirregião dos EUA ou especificar US para uma conta em asia-northeast1).
A localização geográfica da veiculação de anúncios e da segmentação por público-alvo é totalmente separada da localização de dados do BigQuery usada ao executar consultas do Ads Data Hub. Não importa onde seus anúncios são veiculados ou onde os públicos-alvo residem globalmente, os conjuntos de dados de entrada e saída do BigQuery ainda precisam estar no local correspondente à região da sua conta do Ads Data Hub.
Autorizar a conta de serviço do Ads Data Hub
Para que o Ads Data Hub leia dados e grave resultados, você precisa conceder à conta de serviço do Ads Data Hub (P4SA) acesso aos conjuntos de dados relevantes do BigQuery:
- Conjuntos de dados de saída: conceda o papel de Editor de dados do BigQuery (
roles/bigquery.dataEditor) para permitir que o Ads Data Hub grave os resultados da consulta no seu conjunto de dados. - Conjuntos de dados de entrada (dados próprios): conceda o papel de Leitor de dados do BigQuery (
roles/bigquery.dataViewer) para permitir que o Ads Data Hub leia seus dados próprios para mesclagens.
É possível conceder permissões no nível do conjunto de dados ou do projeto:
- Nível do conjunto de dados (recomendado): no console do BigQuery, selecione o conjunto de dados, clique em Compartilhar > Gerenciar permissões e adicione o principal da conta de serviço.
- Nível do projeto: adicione o principal da conta de serviço na página do Identity and Access Management (IAM) no console do Google Cloud.
O e-mail (principal) da conta de serviço do Ads Data Hub (P4SA) está disponível em Configurações > Detalhes > Conta de serviço na sua conta do Ads Data Hub.
Dar acesso aos usuários
Os usuários precisam ter acesso ao Ads Data Hub e ao BigQuery. No Ads Data Hub, eles criam e executam consultas e, no BigQuery, eles trabalham com os resultados coletados no Ads Data Hub.
Os usuários são adicionados à sua conta do Ads Data Hub em Configurações > Usuários e recebem acesso baseado em função (como Superusuário, Analista ou Somente leitura) para escrever e executar consultas.
No Google Cloud, os papéis do IAM do BigQuery (como roles/bigquery.dataViewer e
roles/bigquery.user) controlam quem pode visualizar e consultar as tabelas de saída
resultantes no BigQuery.
Saiba mais sobre o acesso com base em funções no Ads Data Hub Saiba mais sobre o controle de acesso no BigQuery
Vincular dados à sua conta do Ads Data Hub
Se quiser consultar dados de anúncios no Ads Data Hub, faça a vinculação à conta associada ao produto de anúncio do Google usado pela sua equipe.
A vinculação de contas é um processo de duas etapas:
- Inicie o pedido de vinculação: o pedido é iniciado na plataforma de publicidade do Google usada pela sua equipe (como Google Ads, Display & Video 360, Campaign Manager 360 ou YouTube Reserve).
- Aprovar o pedido de vinculação: o pedido é aprovado na sua conta do Ads Data Hub, seja na interface do Ads Data Hub em Configurações > Contas vinculadas ou de forma programática usando a API
CustomerService.BatchApproveAdsDataLinks.