Com o serviço de transferência de dados do BigQuery para Google Ad Manager, é possível criar e gerenciar automaticamente jobs de carregamento recorrentes de dados de relatório do Google Ad Manager (antigo DoubleClick for Publishers).
Relatórios compatíveis
Atualmente, o serviço de transferência de dados do BigQuery para o Google Ad Manager é compatível com as seguintes opções de relatórios:
- Arquivos de transferência de dados (DT do Google Ad Manager)
- Campos de transferência de dados
- Tabelas de correspondência conforme fornecidas via PQL
- Tabelas de correspondência do CompanyService (v201908)
- Tabelas de correspondência do OrderService (v201908)
- Tabelas de correspondência do PlacementService (v201908)
Para informações sobre como os relatórios do Google Ad Manager são transformados em tabelas e visualizações do BigQuery, consulte este artigo.
Opção de relatório | Suporte |
---|---|
Versão da API compatível | v201908 |
Programação | A cada 8 horas, com base no tempo de criação. Não configurável |
Atualizar janela | Últimos 2 dias Não configurável |
Duração máxima do preenchimento | Últimos 60 dias O Google Ad Manager mantém os arquivos da transferência de dados por até 60 dias. Arquivos com mais de 60 dias são excluídos pelo Google Ad Manager. |
Antes de começar
Antes de criar uma transferência do Google Ad Manager, siga estas recomendações:
- Verifique se você realizou todas as ações necessárias para ativar o serviço de transferência de dados do BigQuery.
- Crie um conjunto de dados do BigQuery para armazenar os dados do Google Ad Manager.
-
Certifique-se de que sua organização tenha acesso aos arquivos de transferência de dados do Google Ad Manager (DT do Google Ad Manager). Esses arquivos são entregues pela equipe do Google Ad Manager a um bucket do Cloud Storage. Para ter acesso aos arquivos DT do Google Ad Manager, conclua as etapas a seguir. A equipe do Google Ad Manager poderá enviar cobranças extras.
- Leia a visão geral dos relatórios de transferência de dados.
- No canto superior direito da página, clique em Fale conosco.
- Clique em Relatórios.
- Envie um e-mail ou converse com um representante e pergunte sobre o acesso aos arquivos de transferência de dados do Google Ad Manager.
Após concluir esta etapa, você receberá um bucket do Cloud Storage semelhante a este:
gdfp-12345678
A equipe do Google Cloud NÃO pode gerar ou conceder acesso a arquivos DT do Google Ad Manager em seu nome. Entre em contato com o suporte do Google Ad Manager para ter acesso aos arquivos DT.
- Ative o acesso da API à sua rede do Google Ad Manager.
pubsub.topics.setIamPolicy
do Pub/Sub.
As permissões do Pub/Sub não serão necessárias caso você configure
notificações por e-mail. Para mais informações, consulte Notificações de execução do serviço de transferência de dados do BigQuery.
Permissões necessárias
BigQuery: verifique se a pessoa que está criando a transferência tem as permissões a seguir no BigQuery:
- Permissões
bigquery.transfers.update
para criar a transferência - Permissões
bigquery.datasets.update
no conjunto de dados de destino
O papel predefinido
bigquery.admin
do IAM inclui permissõesbigquery.transfers.update
ebigquery.datasets.update
. Para mais informações sobre papéis do IAM no serviço de transferência de dados do BigQuery, consulte Referência de controle de acesso.- Permissões
Google Ad Manager: acesso de leitura aos arquivos DT do Google Ad Manager armazenados no Cloud Storage. As permissões para arquivos DT do Google Ad Manager são gerenciadas pela equipe do Google Ad Manager. Além dos arquivos DT do Google Ad Manager, a pessoa que cria a transferência precisa ser adicionada à rede do Google Ad Manager, com acesso de leitura a todas as entidades necessárias para criar as várias tabelas de correspondências (item de linha, pedido, bloco de anúncios etc.).
Como configurar uma transferência do Google Ad Manager
Requisitos para configurar uma transferência de dados do BigQuery para o Google Ad Manager:
Bucket do Cloud Storage: o URI do bucket do Cloud Storage referente aos arquivos DT do Google Ad Manager, conforme descrito em Antes de começar. O nome do bucket é semelhante a este:
gdfp-12345678
Código de rede: você verá o código de rede do Google Ad Manager no URL quando estiver conectado à rede. Por exemplo, no URL
https://admanager.google.com/2032576#delivery
,2032576
é o código de rede. Para mais informações, consulte Primeiros passos com o Google Ad Manager.
Para criar um serviço de transferência de dados do BigQuery para o Google Ad Manager, faça o seguinte:
Console
Acesse a página do BigQuery no Console do Cloud.
Clique em Transferências de dados.
Clique em Criar transferência.
Na página Criar transferência:
Na seção Tipo de origem, em Origem, escolha o Google Ad Manager.
No campo Nome da configuração de transferência da seção Nome de exibição, insira um nome para a transferência, como
My Transfer
. Esse nome pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la futuramente.Na seção Configurações de destino, em Conjunto de dados de destino, escolha o conjunto criado para armazenar seus dados.
Na seção Detalhes da origem de dados:
- Em bucket do Cloud Storage, insira o nome do bucket do Cloud Storage que armazena os arquivos de transferência de dados. Ao inserir esse nome, não inclua
gs://
. Em Código de rede, insira o código da rede.
- Em bucket do Cloud Storage, insira o nome do bucket do Cloud Storage que armazena os arquivos de transferência de dados. Ao inserir esse nome, não inclua
Opcional: na seção Opções de notificação:
- Clique no botão para ativar as notificações por e-mail. Quando você ativa essa opção, o administrador de transferência recebe uma notificação por e-mail se uma execução de transferência falhar.
- Em Selecionar um tópico do Pub/Sub, escolha o nome do tópico ou clique em Criar um tópico. Essa opção configura notificações de execução do Pub/Sub da sua transferência.
Clique em Salvar.
bq
Insira o comando bq mk
e forneça a sinalização de execução da transferência
--transfer_config
. As sinalizações a seguir também são obrigatórias:
--data_source
--target_dataset
--display_name
--params
bq mk --transfer_config \ --project_id=project_id \ --target_dataset=dataset \ --display_name=name \ --params='parameters' \ --data_source=data_source
Em que:
- project_id é o ID do projeto.
- dataset é o conjunto de dados de destino na configuração da transferência.
- name é o nome de exibição da configuração de transferência. Esse nome pode ser qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la futuramente.
- parameters contém os parâmetros da configuração da
transferência criada no formato JSON. Por exemplo,
--params='{"param":"param_value"}'
. No Google Ad Manager, você precisa fornecer os parâmetrosbucket
enetwork_code
.bucket
é o bucket do Cloud Storage que contém seus arquivos DT do Google Ad Manager.network_code
é seu código de rede; - data_source é a fonte de dados:
dfp_dt
(Google Ad Manager).
Também é possível fornecer a sinalização --project_id
para especificar um
projeto específico. Se --project_id
não for especificado, o projeto padrão será usado.
Por exemplo, com o comando a seguir, você cria uma transferência do Google Ad Manager chamada My Transfer
usando o código de rede 12345678
, o bucket do Cloud Storage gdfp-12345678
e o conjunto de dados de destino mydataset
. A transferência é criada no projeto padrão:
bq mk --transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"bucket": "gdfp-12345678","network_code": "12345678"}' \
--data_source=dfp_dt
Após executar o comando, você recebe uma mensagem semelhante a esta:
[URL omitted] Please copy and paste the above URL into your web browser and
follow the instructions to retrieve an authentication code.
Siga as instruções e cole o código de autenticação na linha de comando.
API
Use o método projects.locations.transferConfigs.create
e forneça uma instância do recurso
TransferConfig
.
Java
Solução de problemas de configuração da transferência do Google Ad Manager
Se você tiver problemas para configurar a transferência, consulte Problemas de transferência do Google Ad Manager em Solução de problemas de configurações de transferência.
Como consultar dados
Quando os dados são transferidos para o BigQuery, eles são gravados em tabelas particionadas por tempo de processamento. Para mais informações, consulte Introdução às tabelas particionadas.
Use a pseudocoluna _PARTITIONTIME
para consultar suas tabelas diretamente em vez de usar visualizações geradas automaticamente. Para mais informações, veja Como consultar tabelas particionadas.
Consultas de amostra do Google Ad Manager
Use as consultas de amostra do Google Ad Manager a seguir para analisar seus dados transferidos. Também é possível usar as consultas em uma ferramenta de visualização, como o Google Data Studio. Essas consultas são fornecidas para você começar a consultar seus dados do Google Ad Manager com o BigQuery. Se tiver mais dúvidas sobre o que é possível fazer com esses relatórios, entre em contato com seu representante técnico do Google Ad Manager.
Em todas as consultas a seguir, substitua variáveis como dataset por seus valores. Por exemplo, substitua network_code pelo código de rede do Google Ad Manager.
Impressões e usuários únicos por cidade
Na seguinte consulta de amostra, o número de impressões e usuários únicos é analisado por cidade nos últimos 30 dias.
Console
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT City, _DATA_DATE AS Date, count(*) AS imps, count(distinct UserId) AS uniq_users FROM `dataset.NetworkImpressionsnetwork_code` WHERE _DATA_DATE BETWEEN start_date AND end_date GROUP BY City, Date
bq
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) bq query --use_legacy_sql=false \ 'SELECT City, _DATA_DATE AS Date, count(*) AS imps, count(distinct UserId) AS uniq_users FROM `dataset.NetworkImpressions_network_code` WHERE _DATA_DATE BETWEEN start_date AND end_date GROUP BY City, Date'
Impressões e usuários únicos por tipo de item de linha
Na seguinte consulta de amostra, o número de impressões e usuários únicos é analisado por tipo de item de linha nos últimos 30 dias.
Console
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT MT.LineItemType AS LineItemType, DT._DATA_DATE AS Date, count(*) AS imps, count(distinct UserId) AS uniq_users FROM `dataset.NetworkImpressionsnetwork_code` AS DT LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT ON DT.LineItemId = MT.Id WHERE DT._DATA_DATE BETWEEN start_date AND end_date GROUP BY LineItemType, Date ORDER BY Date desc, imps desc
bq
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) bq query --use_legacy_sql=false \ 'SELECT MT.LineItemType AS LineItemType, DT._DATA_DATE AS Date, count(*) AS imps, count(distinct UserId) AS uniq_users FROM `dataset.NetworkImpressions_network_code` AS DT LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT ON DT.LineItemId = MT.Id WHERE DT._DATA_DATE BETWEEN start_date AND end_date GROUP BY LineItemType, Date ORDER BY Date desc, imps desc'
Impressões por bloco de anúncios
Na seguinte consulta de amostra, o número de impressões é analisado por bloco de anúncios nos últimos 30 dias.
Console
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT MT.AdUnitCode AS AdUnitCode, DT.DATA_DATE AS Date, count(*) AS imps FROM `dataset.NetworkImpressionsnetwork_code` AS DT LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT ON DT.AdUnitId = MT.Id WHERE DT._DATA_DATE BETWEEN start_date AND end_date GROUP BY AdUnitCode, Date ORDER BY Date desc, imps desc
bq
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) bq query --use_legacy_sql=false \ 'SELECT MT.AdUnitCode AS AdUnitCode, DT._DATA_DATE AS Date, count(*) AS imps FROM `dataset.NetworkImpressions_network_code` AS DT LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT ON DT.AdUnitId = MT.Id WHERE DT._DATA_DATE BETWEEN start_date AND end_date GROUP BY AdUnitCode, Date ORDER BY Date desc, imps desc'
Impressões por item de linha
Na seguinte consulta de amostra, o número de impressões é analisado por item de linha nos últimos 30 dias.
Console
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT MT.Name AS LineItemName, DT._DATA_DATE AS Date, count(*) AS imps FROM `dataset.NetworkImpressionsnetwork_code` AS DT LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT ON DT.LineItemId = MT.Id WHERE DT._DATA_DATE BETWEEN start_date AND end_date GROUP BY LineItemName, Date ORDER BY Date desc, imps desc
bq
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) bq query --use_legacy_sql=false \ 'SELECT MT.Name AS LineItemName, DT._DATA_DATE AS Date, count(*) AS imps FROM `dataset.NetworkImpressions_network_code` AS DT LEFT JOIN `dataset.MatchTableLineItem_network_code` AS MT ON DT.LineItemId = MT.Id WHERE DT._DATA_DATE BETWEEN start_date AND end_date GROUP BY LineItemName, Date ORDER BY Date desc, imps desc'