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

Actualmente, 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 Transformaciones de informes de Google Ad Manager.

Opción de informe Compatibilidad
Versión de la API compatible v201802
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 los informes de descripción general de transferencia de datos.
    • En la esquina superior derecha de la página, haz clic en Contáctanos.
    • 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.
  • Asegúrate de que la persona que crea la transferencia tenga los siguientes permisos obligatorios:
    • Google Ad Manager: Acceso de lectura para los archivos de Google Ad Manager DT almacenado en Cloud Storage. Los permisos para Google Ad Manager DT los administra el equipo de Google Ad Manager.
    • BigQuery: Permisos bigquery.transfers.update para crear la transferencia y permisos bigquery.datasets.update en el conjunto de datos de destino. La función de IAM bigquery.admin a nivel de proyecto predefinida incluye los permisos bigquery.transfers.update y bigquery.datasets.update. Para obtener más información sobre las funciones de IAM en BigQuery, consulta Control de acceso.
  • Si quieres crear transferencias con la IU web de BigQuery, habilita las ventanas emergentes de bigquery.cloud.google.com para que puedas ver la ventana de permisos. Debes otorgarle permiso al Servicio de transferencia de datos de BigQuery para que administre tus campañas de Google Ad Manager para que la transferencia se realice con éxito.
  • Actualmente, las notificaciones de ejecución de transferencias se encuentran en versión Alpha. Si quieres configurar las notificaciones de transferencia, debes tener los permisos pubsub.topics.setIamPolicy para Cloud Pub/Sub. Los permisos de Cloud Pub/Sub no son necesarios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta Notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Cómo configurar una transferencia de Google Ad Manager

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

  • Un depósito de Cloud Storage: El URI del depósito de Cloud Storage para tus archivos de Google Ad Manager como se describe en Antes de comenzar. El nombre del depósito debe verse de la siguiente manera:

    gdfp-12345678
  • Un 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 el código de tu red. Para obtener más información, consulta Comenzar a usar Google Ad Manager.

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

IU web

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transferencias.

  3. Haz clic en Agregar transferencia.

  4. En la página New Transfer (Transferencia nueva), sigue estos pasos:

    • En Source (Fuente), selecciona Google Ad Manager (formerly DFP) (anteriormente DFP).
    • En Display name (Nombre visible), ingresa un nombre para la transferencia, como por ejemplo, My Transfer. El nombre visible puede ser cualquier valor que te permita identificar con facilidad la transferencia si necesitas modificarla más tarde.
    • En Destination dataset (Conjunto de datos de destino), selecciona el conjunto de datos que corresponda.
    • En Cloud Storage bucket (Depósito de Cloud Storage), 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 Network code (Código de red), ingresa el código de tu red.

      Transferencia de canal

    • (Opcional) Expande la sección Advanced (Avanzado) y configura las notificaciones de ejecución para tu transferencia. Actualmente, las notificaciones de ejecución de transferencias se encuentran en versión Alpha.

      • En Cloud Pub/Sub topic (Tema de Cloud Pub/Sub), ingresa el nombre de tu tema, por ejemplo, projects/myproject/topics/mytopic.
      • Marca Send email notifications (Enviar notificaciones por correo electrónico) para activar las notificaciones por correo de las ejecuciones de transferencia con errores.
      • No marques Disabled (Inhabilitado) cuando configuras una transferencia. Consulta Cómo trabajar con transferencias para inhabilitar las transferencias existentes.

        Tema de Pub/Sub de Cloud

  5. Haz clic en Add (Agregar).

  6. Cuando se te solicite, haz clic en Allow (Permitir) para otorgarle al Servicio de transferencia de datos de BigQuery el permiso para administrar tus datos de informes de Google Ad Manager, y para acceder y administrar los datos en BigQuery. Debes permitir las ventanas emergentes de bigquery.cloud.google.com para ver la ventana de permisos.

    Permitir transferencia

Línea de comandos

Ingresa el comando bq mk y proporciona la marca de creación de transferencia --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]
    

Donde:

  • --project_id es el ID de tu proyecto.
  • --target_dataset es el conjunto de datos meta para la configuración de la transferencia.
  • --display_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 adelante.
  • --params contiene los parámetros para la configuración de la transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}'. En Google Ad Manager, debes proporcionar los parámetros bucket y network_code. bucket es el depósito de Cloud Storage que contiene tus archivos de Google Ad Manager. network_code es el código de tu 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 meta 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 proporciona una instancia del recurso TransferConfig.

Cómo solucionar problemas para la configuración de una transferencia de Google Ad Manager

Si tienes problemas con la configuración de tu transferencia, consulta Problemas de transferencia de Google Ad Manager en Solución de problemas de la configuración de transferencia del Servicio de transferencia de datos de BigQuery.

Cómo consultar tus datos

Cuando tus datos se transfieren a BigQuery, estos se escriben en tablas con particiones en tiempo de transferencia. Para obtener más información, consulta Tablas particionadas.

Si consultas tus tablas de forma directa en lugar de usar las vistas generadas de manera automática, debes usar la pseudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, visita Consultar tablas con particiones.

Puede utilizar las siguientes consultas de muestra de Google Ad Manager para analizar los datos transferidos. También puedes utilizar las consultas en una herramienta de visualización como Cloud Datalab o 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.

Estas muestras usan la asistencia de BigQuery para SQL estándar. Usa la etiqueta #standardSQL para hacerle saber a BigQuery que deseas usar SQL estándar. Para obtener más información sobre el prefijo #standardSQL, consulta Cómo configurar un prefijo de consulta.

En cada una de las siguientes consultas, reemplaza [DATASET] por el nombre de tu conjunto de datos. 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.

IU web

#standardSQL
# 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].NetworkImpressions[NETWORK_CODE]`
WHERE
  _DATA_DATE BETWEEN [START_DATE] AND [END_DATE]
GROUP BY City, Date

Línea de comandos

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

IU web

#standardSQL
# 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].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

Línea de comandos

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

IU web

#standardSQL
# 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].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

Línea de comandos

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

IU web

#standardSQL
# 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].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

Línea de comandos

# 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'
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.