Transferencias de Google Ad Manager

El Servicio de transferencia de datos de BigQuery para Google Ad Manager te permite programar y administrar de manera automática los datos de informe de trabajos de carga recurrentes para Google Ad Manager (antes conocido como DoubleClick for Publishers).

Informes compatibles

Por el momento, el Servicio de transferencia de datos de BigQuery para Google Ad Manager es compatible con las siguientes opciones de informes:

Para obtener información sobre cómo los informes de Google Ad Manager se transforman en tablas y vistas de BigQuery, consulta la página sobre transformaciones de informes de Google Ad Manager.

Opción de informe Compatibilidad
Versión de la API compatible v201908
Programa

Cada 8 horas, según la hora de creación

No configurable

Período de actualización

Últimos 2 días

No configurable

Duración máxima del reabastecimiento

Últimos 60 días

Google Ad Manager retiene los archivos de transferencia de datos hasta por 60 días. Google Ad Manager borra los archivos de más de 60 días.

Antes de comenzar

Antes de crear una transferencia de Google Ad Manager, haz lo siguiente:

  • Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery.
  • Crea un conjunto de datos de BigQuery para almacenar los datos de Google Ad Manager.
  • Asegúrate de que tu organización tenga acceso a los archivos de Transferencia de datos de Google Ad Manager (Google Ad Manager DT). Estos archivos los entrega el equipo de Google AD Manager a un depósito de Google Cloud Storage. Para obtener acceso a los archivos de transferencia de datos de Google Ad Manager DT, completa los siguientes pasos. Se pueden aplicar cargos adicionales del equipo de Google Ad Manager.

    • Revisa la página sobre la descripción general de los informes de Transferencia de datos.
    • En la esquina superior derecha de la página, haz clic en Contactarse.
    • Haz clic en Informes.
    • Envía un correo electrónico o chatea con un representante y consulta sobre el acceso a los archivos de transferencia de datos de Google Ad Manager.

    Después de completar este paso, recibirás un depósito de Cloud Storage similar al siguiente:

    gdfp-12345678

    El equipo de Google Cloud NO tiene la capacidad de generar los archivos de Google Ad Manager DT o conceder acceso a ellos en tu nombre. Comunícate con la asistencia de Google Ad Manager para acceder a los archivos de Google Ad Manager DT.

  • Habilita el acceso a la API para tu red de Google Ad Manager.
  • Si deseas configurar las notificaciones de transferencia, debes tener permisos pubsub.topics.setIamPolicy para Pub/Sub. Los permisos de Pub/Sub no son necesarios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta las notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.
  • Permisos necesarios

    • BigQuery: Asegúrate de que la persona que crea la transferencia tenga los siguientes permisos en BigQuery:

      • permisos bigquery.transfers.update para crear la transferencia
      • Los permisos bigquery.datasets.update en el conjunto de datos de destino

      La función predefinida de IAM bigquery.admin incluye los permisos bigquery.transfers.update y bigquery.datasets.update. Para obtener más información sobre las funciones de IAM en el Servicio de transferencia de datos de BigQuery, consulta la referencia del control de acceso.

    • Google Ad Manager: Acceso de lectura a los archivos de Google Ad Manager DT almacenados en Cloud Storage. Los permisos para los archivos de Google Ad Manager DT los administra el equipo de Google Ad Manager.

    Configura una transferencia de Google Ad Manager

    Para configurar una transferencia de datos para Google Ad Manager se requiere lo siguiente:

    • Depósito de Cloud Storage: El URI del depósito de Cloud Storage para tus archivos de Google Ad Manager DT como se describe en Antes de comenzar El nombre del depósito debe parecerse a este:

      gdfp-12345678
    • Código de red: Encontrarás el código de red de Google Ad Manager en la URL cuando accedas a tu red. Por ejemplo, en la URL https://admanager.google.com/2032576#delivery, 2032576 es tu código de red. Para obtener más información, consulta la página sobre cómo comenzar a usar Google Ad Manager.

    Para crear una transferencia con el Servicio de transferencia de datos de BigQuery para Google Ad Manager:

    Console

    1. Ve a la página de BigQuery en Cloud Console.

      Ir a la página de BigQuery

    2. Haz clic en Transferencias.

    3. Haz clic en Crear transferencia.

    4. En la página Crear transferencia, sigue estos pasos:

      • En la sección Tipo de fuente (Source type), para Fuente (Source), selecciona Google Ad Manager.

        Fuente de transferencia

      • En la sección Nombre de la configuración de transferencia (Transfer config name), en Nombre visible (Display name), ingresa el nombre de la transferencia, como My Transfer. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.

        Nombre de la transferencia

      • En la sección Opciones de programa (Schedule options), en Programa, deja el valor predeterminado, Comenzar ahora (Start now), o haz clic en Comenzar a una hora determinada (Start at a set time).

        • En Repeticiones (Repeats), selecciona una opción para la frecuencia con la que se ejecutará la transferencia.
          • Diaria (predeterminada)
          • Semanal
          • Mensual
          • Personalizada
          • A pedido
        • En Fecha de inicio y hora de ejecución (Start date and run time), ingresa la fecha y hora para iniciar la transferencia. Si seleccionas Comenzar ahora (Start now), esta opción se inhabilitará.

          Programa de la transferencia

      • En la sección Configuración de destino (Destination settings), en Conjunto de datos de destino (Destination dataset), selecciona el conjunto de datos que creaste para almacenar tus datos.

        Conjunto de datos de la transferencia

      • En la sección Detalles de fuente de datos (Data source details), haz lo siguiente:

        • En Depósito de Cloud Storage (Cloud Storage bucket), ingresa el nombre del depósito de Cloud Storage que contiene tus archivos de Transferencia de datos. Cuando ingreses el nombre del depósito, no incluyas gs://.
        • En Código de red (Network code), ingresa el código de tu red.

          Detalles de la fuente de Google Ad Manager

      • De forma opcional, en la sección Opciones de notificación, haz lo siguiente:

        • Haz clic en el botón de activación para habilitar las notificaciones por correo electrónico. Cuando habilitas esta opción, el administrador de transferencias recibe una notificación por correo electrónico cuando falla una ejecución de transferencia.
        • En Seleccionar un tema de Cloud Pub/Sub (Select a Cloud Pub/Sub topic), elige el nombre de tu tema o haz clic en Crear un tema (Create a topic). Con esta opción, se configuran las notificaciones de ejecución de Pub/Sub para tu transferencia.
    5. Haga clic en Save.

    bq

    Ingresa el comando bq mk y suministra la marca de creación de transferencias --transfer_config. También se requieren las siguientes marcas:

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

    Aquí:

    • project_id es el ID del proyecto.
    • dataset es el conjunto de datos de destino para la configuración de la transferencia.
    • name es el nombre visible de la configuración de transferencia. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si necesitas modificarla más tarde.
    • parameters contiene los parámetros para la configuración de la transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}' Para Google Ad Manager, debes proporcionar los parámetros bucket y network_code. bucket es el depósito de Cloud Storage que contiene los archivos de Google Ad Manager DT. network_code es el código de red.
    • data_source es la fuente de datos, dfp_dt (Google Ad Manager).

    También puedes proporcionar la marca --project_id para especificar un proyecto en particular. Si no se especifica --project_id, se usa el proyecto predeterminado.

    Por ejemplo, el siguiente comando crea una transferencia de Google Ad Manager llamada My Transfer mediante el código de red 12345678, el depósito gdfp-12345678 de Cloud Storage y el conjunto de datos de destino mydataset. La transferencia se crea en el proyecto predeterminado:

    bq mk --transfer_config \
    --target_dataset=mydataset \
    --display_name='My Transfer' \
    --params='{"bucket": "gdfp-12345678","network_code": "12345678"}' \
    --data_source=dfp_dt
    

    Después de ejecutar el comando, recibirás un mensaje como el siguiente:

    [URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

    Sigue las instrucciones y pega el código de autenticación en la línea de comandos.

    API

    Usa el método projects.locations.transferConfigs.create y suministra una instancia del recurso TransferConfig.

    Soluciona problemas para la configuración de una transferencia de Google Ad Manager

    Si tienes problemas con la configuración de tu transferencia, consulta la sección sobre cómo solucionar problemas de transferencia de Google Ad Manager en la página acerca de cómo solucionar problemas de la configuración de transferencia del Servicio de transferencia de datos de BigQuery.

    Consulta tus datos

    Cuando tus datos se transfieren a BigQuery, se escriben en tablas particionadas por tiempo de transferencia. Para obtener más información, consulta Introducción a las tablas particionadas.

    Si consultas tus tablas directamente en lugar de usar las vistas generadas de manera automática, debes usar la seudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, visita Consulta tablas particionadas.

    Puedes usar las siguientes consultas de muestra de Google Ad Manager para analizar los datos transferidos. También puedes usar las consultas en una herramienta de visualización, como Google Data Studio. Estas consultas se proporcionan para ayudarte a comenzar a consultar tus datos de Google Ad Manager con BigQuery. Si tienes preguntas adicionales sobre lo que puedes hacer con estos informes, comunícate con tu representante técnico de Google Ad Manager.

    En cada una de las siguientes consultas, reemplaza variables como dataset por tus valores. Por ejemplo, reemplaza network_code por tu código de red de Google Ad Manager.

    Impresiones y usuarios únicos por ciudad

    La siguiente consulta de muestra analiza el número de impresiones y usuarios únicos por ciudad en los últimos 30 días.

    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'
    

    Impresiones y usuarios únicos por tipo de elemento de una sola línea

    La siguiente consulta de muestra analiza el número de impresiones y usuarios únicos por tipo de elemento de una sola línea en los últimos 30 días.

    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'
    

    Impresiones por bloque de anuncios

    La siguiente consulta de muestra analiza el número de impresiones por bloque de anuncios en los últimos 30 días.

    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'
    

    Impresiones por elemento de una sola línea

    La siguiente consulta de muestra analiza el número de impresiones por elemento de una sola línea en los últimos 30 días.

    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'