Transferências do Search Ads 360

Com o serviço de transferência de dados do BigQuery para Search Ads 360 (anteriormente conhecido como Doubleclick Search), é possível programar e gerenciar automaticamente jobs de carregamento recorrentes dos dados de relatórios do Search Ads 360.

Relatórios compatíveis

No momento, o serviço de transferência de dados do BigQuery para Search Ads 360 é compatível com as opções de relatório a seguir:

Para saber como os relatórios do Search Ads 360 são transformados em tabelas e visualizações do serviço de transferência de dados do BigQuery, consulte Transformações de relatórios do Search Ads 360.

Opção de relatório Suporte
Versão da API compatível

v2

Programação

Diariamente, no horário em que a transferência foi criada pela primeira vez (padrão)

É possível configurar a hora do dia.

Janela de atualização

Últimos 7 dias (padrão)

Configurável para até 30 dias

Os snapshots de tabelas de correspondência são produzidos uma vez por dia e armazenados na partição referente à data de execução mais recente. Esses snapshots NÃO são atualizados quanto a preenchimentos ou dias carregados por meio da janela de atualização. Para informações sobre quais tabelas de correspondência não são atualizadas pela janela de atualização, consulte Configurar um preenchimento.

Duração máxima do preenchimento

Sem limite

O Search Ads 360 não tem limites conhecidos de retenção de dados, mas o serviço de transferência de dados do BigQuery tem restrições em relação a quantos dias podem ser solicitados em um único preenchimento. Para mais informações sobre preenchimentos, consulte Configurar um preenchimento.

Antes de começar

Antes de criar uma transferência do Search Ads 360:

Permissões exigidas

Veja se a pessoa que está criando a transferência tem as permissões necessárias a seguir:

  • Serviço de transferência de dados do 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ões bigquery.transfers.update e bigquery.datasets.update. Para mais informações sobre os papéis do IAM no serviço de transferência de dados do BigQuery, consulte a Referência do controle de acesso.

  • Google Cloud:

    • Permissões serviceusage.services.use para fazer o download de dados do Search Ads 360 no projeto.

    Os papéis do IAM predefinidos editor, owner e serviceusage.serviceUsageConsumer incluem as permissões serviceusage.services.use. Para mais informações sobre papéis do IAM no Service Usage, consulte Referência de controle de acesso.

  • Google Search Ads 360: acesso de leitura aos IDs de anunciante e agência do Google Search Ads 360 usados na configuração da transferência. Para mais informações, consulte Criar uma Conta do Google e receber permissões do SA360.

Como configurar uma transferência de dados do Search Ads 360

Para configurar uma transferência de dados dos relatórios do Search Ads 360, é preciso fazer o seguinte:

Para criar uma transferência de dados dos relatórios do Search Ads 360:

Console

  1. Acesse a página do BigQuery no Console do Cloud.

    Acessar a página do BigQuery

  2. Clique em Transferências.

  3. Clique em Criar transferência.

  4. Na página Criar transferência:

    • Na seção Tipo de origem, em Origem, escolha Search Ads 360 (antigamente "DoubleClick Search").

      Fonte da transferência

    • 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.

      Nome da transferência

    • Na seção Opções de programação, não altere o valor padrão de Programação (Começar agora). Se preferir, clique em Começar no horário definido.

      • Em Repetições, escolha uma opção para a frequência de execução da transferência:

        • Diário (padrão)
        • Semanal
        • Mensal
        • Personalizada
        • Sob demanda
      • Em Data e hora de início, insira a data e a hora para iniciar a transferência. Se você escolher Iniciar agora, essa opção ficará desativada.

        Programação da transferência

    • Na seção Configurações de destino, em Conjunto de dados de destino, escolha o conjunto criado para armazenar seus dados.

      Conjunto de dados da transferência

    • Na seção Detalhes da origem de dados:

      • Em ID de agência, insira seu ID de agência.
      • Em ID de anunciante, insira seu ID de anunciante.
      • Marque a opção incluir itens removidos para adicionar as entidades e métricas removidas a serem transferidas.
      • Opcional: em Filtro de tabela, deixe esse campo em branco para carregar todas as tabelas. Para importar dados de apenas algumas tabelas compatíveis, liste o prefixo do nome delas, separando por espaços. Por exemplo: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Consulte Transformação de relatórios do Search Ads 360 para acessar todos os nomes de tabelas compatíveis.

        Detalhes da origem do Search Ads 360

      • Opcional: em Variáveis personalizadas do Floodlight, deixe esse campo em branco para importar somente as colunas predefinidas na transformação de relatórios do Search Ads 360.
        Para importar variáveis personalizadas do Floodlight criadas no Search Ads 360, nomeie esses campos no formato JSON, como neste exemplo:

        • [{
            "cfv_name": "variable_name",
            "cfv_type": "metric or dimension",
            "campaign_manager_type": "number or string",
            "destination_table_name": "table_name",
            "bigquery_column_name": "custom_column_name"
          },{
            "cfv_name": "variable_name_2",
            "cfv_type": "metric or dimension",
            "campaign_manager_type": "number or string",
            "destination_table_name": "table_name_2",
            "bigquery_column_name": "custom_column_name_2"
          }]
          
        • Para cada item na lista JSON, inclua o seguinte:
          • cfv_name: é o nome simplificado que você especificou ao criar a variável personalizada do Floodlight no Campaign Manager. Ele também é exibido na IU do Search Ads 360 ao configurar métricas e dimensões personalizadas.
          • cfv_type: precisa ser metric ou dimension e corresponder à forma como você configura a variável personalizada do Floodlight na IU do Search Ads 360.
          • campaign_manager_type: precisa ser number ou string e corresponder à forma como você configura a variável personalizada do Floodlight na IU do Search Ads 360.
          • destination_table_name: é o prefixo do nome da tabela de destino a que você adicionará a variável personalizada do Floodlight. Por exemplo: AccountDeviceStats.
          • bigquery_column_name: é o nome da coluna que essa variável personalizada do Floodlight terá na tabela de destino do serviço de transferência de dados do BigQuery. Esse nome precisa atender aos [requisitos de formato dos nomes de coluna do serviço de transferência de dados do BigQuery](https://cloud.google.com/bigquery/docs/schemas#column_names

        Console das variáveis personalizadas do Floodlight do Search Ads 360

    • 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 falha.
      • Em Selecionar um tópico do Pub/Sub, escolha o nome do seu 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.
  5. Clique em Salvar.

IU clássica

  1. Acesse a IU clássica da Web do BigQuery.

    Acessar a IU clássica da Web do BigQuery

  2. Clique em Transfers.

  3. Clique em Adicionar transferência.

  4. Na página Nova transferência:

    • Em Origem, escolha Search Ads 360 (antigamente "DoubleClick Search").
    • Em Nome de exibição, digite um nome para a transferência, como My Transfer. Ele pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la no futuro.
    • Em Período de atualização, insira o número de dias a serem incluídos na transferência de dados. Se você inserir 1, não haverá preenchimento diário. Inserir 0 configura o período de atualização padrão de sete dias. O valor máximo é 30. Para mais informações, consulte Como determinar a atualidade dos dados.

      Nome legado da transferência

    • Em Programação, mantenha o valor padrão, que é de 24 horas a partir do horário de criação da transferência, ou clique em Editar para alterá-lo.

      Programação do Search Ads 360

    • Na seção Configurações de destino, em Conjunto de dados de destino, escolha o conjunto criado para armazenar seus dados.

      Destino legado do Search Ads 360

    • Em ID de agência, insira seu ID de agência.

    • Em ID de anunciante, insira seu ID de anunciante.

    • Marque a opção incluir itens removidos para adicionar as entidades e métricas removidas a serem transferidas.

    • Opcional: em Filtro de tabela, deixe esse campo em branco para carregar todas as tabelas. Para importar dados de apenas algumas tabelas compatíveis, liste o prefixo do nome delas, separando por espaços. Por exemplo: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Consulte Transformação de relatórios do Search Ads 360 para acessar todos os nomes de tabelas compatíveis.

      Detalhes da origem legada do Search Ads 360

    • Opcional: em Variáveis personalizadas do Floodlight, deixe esse campo em branco para importar somente as colunas predefinidas na transformação de relatórios do Search Ads 360.
      Para importar variáveis personalizadas do Floodlight criadas no Search Ads 360, nomeie esses campos no formato JSON, como neste exemplo:

      • [{
            "cfv_name": "variable_name",
            "cfv_type": "metric or dimension",
            "campaign_manager_type": "number or string",
            "destination_table_name": "table_name",
            "bigquery_column_name": "custom_column_name"
        },{
            "cfv_name": "variable_name_2",
            "cfv_type": "metric or dimension",
            "campaign_manager_type": "number or string",
            "destination_table_name": "table_name_2",
            "bigquery_column_name": "custom_column_name_2"
        }]
        
      • Para cada item na lista JSON, inclua o seguinte:

        • cfv_name: é o nome simplificado que você especificou ao criar a variável personalizada do Floodlight no Campaign Manager. Ele também é exibido na IU do Search Ads 360 ao configurar métricas e dimensões personalizadas.
        • cfv_type: precisa ser metric ou dimension e corresponder à forma como você configura a variável personalizada do Floodlight na IU do Search Ads 360.
        • campaign_manager_type: precisa ser number ou string e corresponder à forma como você configura a variável personalizada do Floodlight na IU do Search Ads 360.
        • destination_table_name: é o prefixo do nome da tabela de destino a que você adicionará a variável personalizada do Floodlight. Por exemplo: AccountDeviceStats.
        • bigquery_column_name: é o nome da coluna que essa variável personalizada do Floodlight terá na tabela de destino do serviço de transferência de dados do BigQuery. Esse nome precisa atender aos requisitos de formato dos nomes de coluna do serviço de transferência de dados do BigQuery.

        Variável personalizada do Floodlight legada do Search Ads 360

    • (Opcional) Expanda a seção Avançado e configure as notificações de execução da transferência.

      • Em Tópico do Pub/Sub, insira o nome do seu tópico. Por exemplo: projects/myproject/topics/mytopic.
      • Marque Enviar notificações por e-mail para permitir notificações por e-mail sobre falhas na execução da transferência.
      • Não marque Desativada ao configurar uma transferência. Para desativar transferências, consulte Como trabalhar com transferências.

        Tópico do Pub/Sub

  5. Clique em Adicionar.

  6. Quando solicitado, clique em Permitir para autorizar o serviço de transferência do BigQuery a acessar e controlar os dados nele próprio e gerenciar os dados de relatórios do Search Ads 360. É necessário permitir pop-ups do endereço bigquery.cloud.google.com para ver a janela de permissões.

    Permitir transferência

bq

Digite o comando bq mk e forneça a sinalização de criação da transferência --transfer_config. As sinalizações a seguir também são obrigatórias:

  • --data_source
  • --target_dataset
  • --display_name
  • --params

Também é possível fornecer a sinalização --project_id para especificar um projeto determinado. Se --project_id não for especificado, o projeto padrão será usado.

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source

Onde:

  • 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 Search Ads 360, você precisa fornecer os parâmetros advertiser_id e agency_id. Também é possível definir os parâmetros a seguir:

    • Opcional: defina table_filter para importar dados de apenas algumas tabelas compatíveis e listar o prefixo do nome delas, separando por espaços. Por exemplo: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Consulte Transformação de relatórios do Search Ads 360 para acessar todos os nomes de tabelas compatíveis.
    • Opcional: defina custom_floodlight_variables para importar variáveis personalizadas do Floodlight criadas no Search Ads 360 e nomear esses campos no formato JSON, como neste exemplo:
      • [{
          "cfv_name": "variable_name",
          "cfv_type": "metric or dimension",
          "campaign_manager_type": "number or string",
          "destination_table_name": "table_name",
          "bigquery_column_name": "custom_column_name"
        },{
          "cfv_name": "variable_name_2",
          "cfv_type": "metric or dimension",
          "campaign_manager_type": "number or string",
          "destination_table_name": "table_name_2",
          "bigquery_column_name": "custom_column_name_2"
        }]
        
      • Para cada item na lista JSON, inclua o seguinte:
        • cfv_name: é o nome simplificado que você especificou ao criar a variável personalizada do Floodlight no Campaign Manager. Ele também é exibido na IU do Search Ads 360 ao configurar métricas e dimensões personalizadas.
        • cfv_type: precisa ser metric ou dimension e corresponder à forma como você configura a variável personalizada do Floodlight na IU do Search Ads 360.
        • campaign_manager_type: precisa ser number ou string e corresponder à forma como você configura a variável personalizada do Floodlight na IU do Search Ads 360.
        • destination_table_name: é o prefixo do nome da tabela de destino a que você adicionará a variável personalizada do Floodlight. Por exemplo: AccountDeviceStats.
        • bigquery_column_name: é o nome da coluna que essa variável personalizada do Floodlight terá na tabela de destino do serviço de transferência de dados do BigQuery. Esse nome precisa atender aos requisitos de formato dos nomes de coluna do serviço de transferência de dados do BigQuery.
    • Opcional: defina include_removed_entities como verdadeiro para incluir entidades e métricas removidas a serem transferidas.
  • data_source é a fonte de dados: doubleclick_search.

Por exemplo, com o comando a seguir, você cria uma transferência do Search Ads chamada My Transfer usando o ID de anunciante 123, o ID de agência 123 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='{"agency_id":"123", "advertiser_id":"123","include_removed_items":"true"}' \
--data_source=doubleclick_search

Ao executar o comando pela primeira vez, você recebe uma mensagem como 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.

Como solucionar problemas de configuração de transferência do Search Ads 360

Se você tiver problemas ao configurar a transferência, consulte Solução de problemas de configuração da transferência do serviço de transferência de dados do BigQuery.

Como consultar dados

Quando os dados são movidos para o serviço de transferência do BigQuery, eles são gravados em tabelas particionadas por tempo de ingestão. 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.

Possíveis problemas de cota

A API do Google Search Ads 360 atribui uma cota diária referente ao número de solicitações que o projeto do Google pode enviar. Se você usa o mesmo projeto no serviço de transferência de dados do BigQuery e em outros, eles dividirão a mesma cota e poderão alcançar o limite dela.

Para evitar esse possível problema e não impactar os fluxos de trabalho atuais, considere estas opções:

  • Configure um projeto separado para o serviço de transferência de dados do BigQuery.

    Exemplo de união de tabelas entre projetos:

      #standardSQL
      select count(a.item1)
      from (select item1, item2 from project-A.data_set_a.table_name_a) a
      inner join
      (select item3, item4 from project-B.data_set_b.table_name_b) b
      on a.item1 = b.item3
    

  • Entre em contato com o suporte do Search Ads 360 e solicite mais cota. Para mais informações, consulte Solicitar mais cota.