Programar uma transferência do Display & Video 360

O conector do serviço de transferência de dados do BigQuery para o Display & Video 360 permite que você agende e gerencie automaticamente trabalhos de carregamento recorrentes para dados de configuração e relatórios do Display & Video 360.

Relatórios compatíveis

O serviço de transferência de dados do BigQuery para Display & Video 360 é compatível com a seguinte opção de relatório:

• Arquivos de transferência de dados v2 (DTv2 do Display & Video)

Para saber como os relatórios do Display & Video 360 são transformados em tabelas e visualizações do BigQuery, consulte Transformação de dados do Display & Video 360.

O Display & Video 360 retém os arquivos de transferência de dados por até 60 dias.

Opção de relatório	Suporte
Repetir frequência	Diariamente, no horário em que a transferência de dados foi criada pela primeira vez (padrão) Você pode configurar a hora do dia.
Atualizar janela	Últimos 2 dias Não configurável
Duração máxima do preenchimento	Últimos 60 dias

Dados de configuração compatíveis

Além dos dados de relatórios, o serviço de transferência de dados do BigQuery também transfere os seguintes dados de configuração do Display & Video 360. Os dados de configuração são recuperados da API Display & Video 360 v3.

• Parceiro
• Anunciante
• LineItem
• LineItemTargeting
• Campaign
• CampaignTargeting
• InsertionOrder
• InsertionOrderTargeting
• AdGroup
• AdGroupTargeting
• AdGroupAd
• Criativo

Para mais informações sobre cada tipo de dados de configuração, consulte os links abaixo:

• Sobre os parceiros
• Criar um anunciante
• Criar um item de linha
• Criar uma campanha
• Criar um pedido de inserção
• Sobre itens de linha do YouTube e parceiros
• Gerenciar criativos

Ingestão de dados das transferências do Display & Video 360

Ao transferir dados do Display & Video 360 para o BigQuery, eles são carregados em tabelas do BigQuery particionadas por data. A partição da tabela em que os dados são carregados corresponde à data da fonte de dados. Se você programar várias transferências para a mesma data, o serviço de transferência de dados do BigQuery substituirá a partição dessa data específica pelos dados mais recentes. Várias transferências no mesmo dia ou preenchimentos não resultam em dados duplicados, e as partições de outras datas não são afetadas.

Atualizar janelas

Uma janela de atualização é o número de dias que uma transferência de dados recupera dados quando ocorre uma transferência de dados. Por exemplo, se a janela de atualização for de três dias e uma transferência diária ocorrer, o serviço de transferência de dados do BigQuery vai extrair todos os dados da tabela de origem dos últimos três dias. Nesse exemplo, quando uma transferência diária ocorre, o serviço de transferência de dados do BigQuery cria uma nova partição de tabela de destino do BigQuery com uma cópia dos dados da tabela de origem do dia atual e, em seguida, aciona automaticamente as execuções de preenchimento para atualizar as partições de tabela de destino do BigQuery com os dados da tabela de origem dos últimos dois dias. As execuções de preenchimento automático acionadas automaticamente vão substituir ou atualizar de forma incremental a tabela de destino do BigQuery, dependendo de se as atualizações incrementais são aceitas ou não pelo conector do serviço de transferência de dados do BigQuery.

Quando você executa uma transferência de dados pela primeira vez, a transferência de dados recupera todos os dados de origem disponíveis na janela de atualização. Por exemplo, se a janela de atualização for de três dias e você executar a transferência de dados pela primeira vez, o serviço de transferência de dados do BigQuery vai recuperar todos os dados de origem em três dias.

As janelas de atualização são mapeadas para o campo da APITransferConfig.data_refresh_window_days.

Para recuperar dados fora da janela de atualização, como dados históricos, ou para recuperar dados de interrupções ou lacunas de transferência, inicie ou programe uma execução de preenchimento.

Antes de começar

Consulte os pré-requisitos e informações a seguir antes de criar uma transferência de dados do Display & Video 360.

Pré-requisitos

• 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 dados do Display & Video 360.
• Verifique se você tem o ID do parceiro ou ID do anunciante do Display & Video 360. O ID do parceiro é o principal na hierarquia.
• Verifique se você tem permissões de leitura para acessar dados de parceiros ou anunciantes pela API Display & Video.

• Verifique se a organização tem acesso aos arquivos de transferência de dados v2 do Display & Video 360 (DTv2 do Display & Video 360). Esses arquivos são entregues pela equipe do Display & Video 360 em um bucket do Cloud Storage. A solicitação de acesso aos arquivos DTv2 do Display & Video 360 depende se você tem ou não um contrato direto com o Display & Video 360. Nos dois casos, é possível que haja a cobrança de taxas extras.

  • Se você tiver um contrato com o Display & Video 360, entre em contato com o suporte do Display & Video 360 para configurar os arquivos DTv2 do Display & Video 360.
  • Se você não tiver um contrato com o Display & Video 360, entre em contato com sua agência para ter acesso aos arquivos DTv2 do Display & Video 360.
  • Após concluir esta etapa, você receberá um dos seguintes nomes de bucket do Cloud Storage, dependendo se a configuração for para um parceiro ou um anunciante:
    • gs://dcdt_-dbm_partnerPARTNER_ID
    • gs://dcdt_-dbm_advertiserADVERTISER_ID
  Observação: a equipe do Google Cloud não pode gerar ou conceder acesso a arquivos DTv2 do Display & Video 360 em seu nome. Entre em contato com o suporte do Display & Video 360 ou com sua agência para acessar os arquivos DTv2 do Display & Video 360.

• Para configurar notificações de execução de transferência do Pub/Sub, você precisa ter permissões pubsub.topics.setIamPolicy. Para mais informações, consulte Notificações de execução do serviço de transferência de dados do BigQuery.

Encontrar seu ID do Display & Video 360

Para recuperar o ID do Display & Video 360, acesse a página Buckets do Cloud Storage no console do Google Cloud e examine os arquivos no bucket do Cloud Storage de transferência de dados do Display & Video 360. O ID do Display & Video 360 é usado para fazer a correspondência de arquivos no bucket do Cloud Storage fornecido. O ID fica incorporado no nome do arquivo, não no nome do bucket do Cloud Storage. Por exemplo:

• Em um arquivo chamado dbm_partner123_activity_*, o ID é 123.
• Em um arquivo chamado dbm_advertiser567_activity_*, o ID é 567.

Como encontrar o prefixo de nome de arquivo

Em alguns casos, os arquivos no bucket do Cloud Storage podem ter nomes de arquivo personalizados, fora do padrão que foram configurados para você pela equipe de serviços do Google Marketing Platform. Por exemplo:

Em um arquivo chamado dbm_partner123456custom_activity_*, o prefixo é dbm_partner123456custom.

Se precisar de ajuda com prefixos de nome de arquivo, entre em contato com o suporte do Display & Video 360.

Configurar uma transferência de dados do Display & Video 360

Selecione uma das seguintes opções:

Console

1. Acesse a página "Transferências de dados" no console do Google Cloud.

   Acesse Transferências de dados

2. Clique em Criar transferência.

3. Na página Criar transferência, realize estas ações:

   • Na seção Tipo de origem, em Origem, escolha Display & Video 360.
   • No campo Nome de exibição, na seção Nome de configuração da transferência, insira um nome para a transferência de dados. O nome da transferência pode ser qualquer valor que permita identificá-la, caso você precise modificá-la mais tarde.

4. Na seção Opções de programação, faça o seguinte:

   • Selecione Começar agora ou Começar no horário definido e apresente uma data de início e um horário de execução.
   • Em Repetições, escolha uma opção para a frequência de execução da transferência de dados. Se você selecionar Dias, forneça um horário válido em UTC.
     • Horas
     • Dias
     • Sob demanda

5. Na seção Configurações de destino, no menu Conjunto de dados de destino, selecione o conjunto de dados que você criou para armazenar os dados.

6. Na seção Detalhes da fonte de dados:

   • No campo Bucket do Cloud Storage DTV2 do DV360, insira o bucket do Cloud Storage que contém os arquivos DTv2 do Display & Video 360. Se você precisar configurar esse bucket, entre em contato com o suporte do Display & Video 360.
   • No campo ID do parceiro/anunciante do DV360, insira o ID do parceiro ou o ID do anunciante.
   • 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.
     • Clique no botão para ativar as notificações do Pub/Sub. Em Selecionar um tópico do Cloud 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.

7. 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 são necessá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 de dados.
• NAME: o nome de exibição da configuração da transferência de dados. O nome da transferência pode ser qualquer valor que permita identificá-la facilmente, caso precise modificá-la mais tarde.
• PARAMETERS é o parâmetro da configuração de transferência de dados criada no formato JSON. Por exemplo: --params='{"param":"param_value"}'. Para transferências do Display & Video 360, os parâmetros bucket e displayvideo_id são obrigatórios. O parâmetro file_name_prefix é opcional e usado apenas para nomes de arquivos raros e personalizados.
• DATA_SOURCE: a fonte de dados — displayvideo.

Por exemplo, o comando a seguir cria uma transferência de dados do Display & Video 360 chamada My Transfer usando o ID do Display & Video 360 123456, o bucket do Cloud Storage dcdt_-dbm_partner123456 e o conjunto de dados de destino mydataset.

A transferência de dados é criada no projeto padrão:

  bq mk --transfer_config \
  --target_dataset=mydataset \
  --display_name='My Transfer' \
  --params='{"bucket":"dcdt_-dbm_partner123456","displayvideo_id": "123456","file_name_prefix":"YYY"}' \
  --data_source=displayvideo

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 na mensagem 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.

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 a tabelas particionadas.

Recomendamos consultar as visualizações geradas de forma automática em vez de consultar as tabelas diretamente. No entanto, para consultar as tabelas diretamente, use a pseudocoluna _PARTITIONTIME. Para mais informações, veja Como consultar tabelas particionadas.