Transferências do Google Ad Manager

Com o serviço de transferência de dados do BigQuery para Google Ad Manager, é possível programar e gerenciar automaticamente jobs de carregamento recorrentes de dados de relatórios do Google Ad Manager (antigo DoubleClick for Publishers).

Relatórios compatíveis

No momento, o serviço de transferência de dados do BigQuery para Google Ad Manager é compatível com as opções de relatórios a seguir:

Para mais informações sobre como os relatórios do Google Ad Manager são transformados em tabelas e visualizações do BigQuery, consulte esta página.

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:

  • 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 enviados pela equipe do Google Ad Manager a um intervalo do Cloud Storage. Para ter acesso aos arquivos DT do Google Ad Manager, conclua as etapas a seguir. Sujeito a cobranças extras da equipe do Google Ad Manager.

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

  • Ative o acesso à API para sua rede do Google Ad Manager.
  • Se você quiser criar transferências usando a IU clássica da Web do BigQuery, permita os pop-ups de bigquery.cloud.google.com. Assim, será possível ver a janela de permissões. É preciso que a permissão do serviço de transferência de dados do BigQuery gerencie seus dados do Google Ad Manager para que a transferência seja realizada.
  • Se você pretende configurar notificações de transferência, é necessário ter as permissões 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 saber mais informações, consulte Notificações de execução do serviço de transferência de dados do BigQuery.
  • Permissões exigidas

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

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

    Como configurar uma transferência do Google Ad Manager

    Requisitos para configurar uma transferência de dados do BigQuery para Google Ad Manager:

    • Intervalo do Cloud Storage: o URI do intervalo do Cloud Storage referente aos arquivos DT do Google Ad Manager, conforme descrito em Antes de começar. O nome do intervalo é 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:

    Console

    1. Acesse a IU da Web do BigQuery.

      Acesse a IU da Web 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 o Google Ad Manager.

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

        Transferir conjunto de dados

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

        • Em Intervalo do Cloud Storage, insira o nome do intervalo 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.

          Detalhes da origem do Google Ad Manager

      • 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 quando uma execução de transferência falha.
        • 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 para sua transferência.
    5. Clique em Save.

    IU clássica

    1. Acesse a IU da Web do BigQuery.

      Acessar a IU da Web do BigQuery

    2. Clique em Transferências.

    3. Clique em Adicionar transferência.

    4. Na página Nova transferência:

      • Em Origem, escolha Google Ad Manager (antigo DFP).
      • Em Nome de exibição, insira 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 Destination dataset, escolha o conjunto apropriado.
      • Em Intervalo do Cloud Storage, insira o nome do intervalo 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.

        Transferência de canal

      • (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. Consulte Como trabalhar com transferências para desativar as transferências atuais.

          Tópico do Pub/Sub

    5. Clique em Add.

    6. Quando solicitado, clique em Permitir para conceder ao serviço de transferência de dados do BigQuery permissão para acessar os dados de relatórios do Google Ad Manager e gerenciá-los no BigQuery. É necessário permitir pop-ups do endereço bigquery.cloud.google.com para ver a janela de permissões.

      Permitir transferência

    CLI

    Insira o comando bq mk e forneça a sinalização de criação da transferência --transfer_config. As sinalizações abaixo 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 da transferência. Ele pode ter qualquer valor que identifique facilmente a transferência, caso seja necessário modificá-la no futuro;
    • parameters contém os parâmetros para a configuração da transferência criada no formato JSON. Por exemplo, --params='{"param":"param_value"}'. No Google Ad Manager, você precisa fornecer os parâmetros bucket e network_code. bucket é o intervalo 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 determinado projeto. 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 intervalo 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.

    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ção do serviço de transferência de dados do BigQuery.

    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 direto as tabelas, em vez de usar visualizações geradas automaticamente. Para mais informações, veja Como consultar tabelas particionadas.

    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 as variáveis como dataset pelos 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
        

    CLI

        # 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
        

    CLI

            # 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
        

    CLI

        # 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
        

    CLI

        # 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'