Programa una transferencia de Display & Video 360

El conector del Servicio de transferencia de datos de BigQuery para Display & Video 360 te permite administrar y programar de manera automática trabajos de carga recurrentes para los informes y los datos de configuración de Display & Video 360.

Informes compatibles

El Servicio de transferencia de datos de BigQuery para Display & Video 360 admite la siguiente opción de informes:

Para obtener información sobre cómo los informes de Display & Video 360 se transforman en tablas y vistas de BigQuery, consulta la página sobre la transformación de datos de Display & Video 360.

Display & Video 360 retiene los archivos de transferencia de datos hasta por 60 días.

Opción de informe Asistencia
Frecuencia de repetición

Diariamente, en el momento en que se crea por primera vez la transferencia de datos (predeterminado)

Puedes configurar la hora del día.

Período de actualización

Últimos 2 días

No configurable

Duración máxima del reabastecimiento

Últimos 60 días

Datos de configuración compatibles

Además de los datos de informes, el Servicio de transferencia de datos de BigQuery también transfiere los siguientes datos de configuración desde Display & Video 360. Los datos de configuración se recuperan de la API de Display & Video 360 v3.

Para obtener más información sobre cada tipo de datos de configuración, consulta los siguientes vínculos:

Transferencia de datos de transferencias de Display & Video 360

Cuando transfieres datos de Display & Video 360 a BigQuery, estos se cargan en tablas de BigQuery particionadas por fecha. La partición de la tabla en la que se cargan los datos corresponde a la fecha de la fuente de datos. Si programas varias transferencias para la misma fecha, el Servicio de transferencia de datos de BigQuery reemplaza la partición para esa fecha específica con los datos más recientes. Las transferencias múltiples en el mismo día o los reabastecimientos en ejecución no generan datos duplicados y las particiones para otras fechas no se ven afectadas.

Períodos de actualización

El período de actualización se refiere a la cantidad de días durante los cuales una transferencia de datos recupera datos cuando se produce la transferencia. Por ejemplo, si el período de actualización es de tres días y se produce una transferencia diaria, el Servicio de transferencia de datos de BigQuery recuperará todos los datos de tu tabla de origen de los últimos tres días. En este ejemplo, cuando se produce una transferencia diaria, el Servicio de transferencia de datos de BigQuery crea una nueva partición de tabla de destino de BigQuery con una copia de los datos de la tabla de origen del día actual y, luego, activa automáticamente las ejecuciones de reabastecimiento para actualizar las particiones de la tabla de destino de BigQuery con los datos de la tabla de origen de los últimos dos días. Las ejecuciones de reabastecimiento activadas automáticamente reemplazarán o actualizarán de forma incremental tu tabla de destino de BigQuery, en base a si las actualizaciones incrementales son compatibles o no con el conector del Servicio de transferencia de datos de BigQuery.

Cuando ejecutas una transferencia de datos por primera vez, la transferencia de datos recupera todos los datos de origen disponibles dentro del período de actualización. Por ejemplo, si el período de actualización es de tres días y ejecutas la transferencia de datos por primera vez, el Servicio de transferencia de datos de BigQuery recupera todos los datos de origen en un plazo de tres días.

Las ventanas de actualización se asignan al campo de API TransferConfig.data_refresh_window_days.

Para recuperar datos fuera del período de actualización, como datos históricos, o para recuperar datos de interrupciones o brechas de transferencia, puedes iniciar o programar una ejecución de reabastecimiento.

Antes de comenzar

Revisa la siguiente información y los requisitos previos antes de crear una transferencia de datos de Display & Video 360.

Requisitos previos

  • 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 datos de Display & Video 360.
  • Asegúrate de tener tu ID de socio o ID de anunciante de Display & Video 360. El ID de socio es el superior en la jerarquía.
  • Asegúrate de tener permisos de lectura para acceder a los datos de los socios o anunciantes de la API de Display y de video.
  • Asegúrate de que tu organización tenga acceso a la transferencia de datos de Display & Video 360 (Display & Video 360 DTv2). Estos archivos los publica el equipo de Display & Video 360 en un bucket de Cloud Storage. La solicitud de acceso a los archivos de Display & Video 360 de DTv2 depende de si tienes o no un contrato directo con Display & Video 360. En ambos casos, se aplicarán cargos adicionales.

    • Si tienes un contrato con Display & Video 360, comunícate con el equipo de asistencia de Display & Video 360 para configurar archivos de Display & Video 360 DTv2.
    • Si no tienes un contrato con Display & Video 360, comunícate con tu agencia para acceder a los archivos de Display & Video 360 DTv2.
    • Después de completar este paso, recibirás uno de los siguientes nombres de bucket de Cloud Storage, según si tu configuración es para un socio o un anunciante:
      • gs://dcdt_-dbm_partnerPARTNER_ID
      • gs://dcdt_-dbm_advertiserADVERTISER_ID
  • Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, debes tener los permisos pubsub.topics.setIamPolicy. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Encuentra tu ID de Display & Video 360

Para recuperar tu ID de Display & Video 360, navega a la página Buckets de Cloud Storage en la consola de Google Cloud y examina los archivos en tu bucket de Cloud Storage de transferencia de datos de Display & Video 360. El ID de Display & Video 360 se usa para encontrar coincidencias de archivos en el depósito de Cloud Storage proporcionado. El ID está incorporado en el nombre del archivo, no en el nombre del depósito de Cloud Storage. Por ejemplo:

  • En un archivo llamado dbm_partner123_activity_*, el ID es 123.
  • En un archivo llamado dbm_advertiser567_activity_*, el ID es 567.

Encuentra el prefijo de tu nombre de archivo

En raras ocasiones, tú o el equipo de servicios de Google Marketing Platform pueden configurar los archivos en tu bucket de Cloud Storage con nombres de archivo personalizados no estándar. Por ejemplo:

En un archivo llamado dbm_partner123456custom_activity_*, el prefijo es dbm_partner123456custom.

Si necesita ayuda con los prefijos del nombre de archivo, comuníquese con el equipo de asistencia de Display & Video 360.

Configura una transferencia de datos de Display & Video 360

Selecciona una de las opciones siguientes:

Console

  1. Ve a la página Transferencia de datos en la consola de Google Cloud.

    Ir a Transferencias de datos

  2. Haz clic en Crear transferencia.

  3. En la página Crear transferencia, haz lo siguiente:

    • En la sección Tipo de fuente (Source type), para Fuente (Source), elige Display & Video 360.
    • En la sección Nombre de configuración de la transferencia (Transfer config name), en Nombre visible (Display name), ingresa el nombre de la transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.
  4. En la sección Opciones de programación, haz lo siguiente:

    • Selecciona Comenzar ahora o Comenzar a una hora definida y, luego, proporciona una fecha de inicio y una hora de ejecución.
    • En Repeticiones, selecciona la frecuencia con la que se ejecutará la transferencia. Si seleccionas Días, proporciona una hora válida en UTC.
      • Horas
      • Días
      • A pedido
  5. En la sección Configuración de destino, en el menú Conjunto de datos de destino, selecciona el conjunto de datos que creaste para almacenar tus datos.

  6. En la sección Detalles de fuente de datos (Data source details):

    • En el campo DV360 DTV2 Cloud Storage bucket, ingresa el bucket de Cloud Storage que contiene los archivos de DTv2 de Display & Video 360. Si necesitas configurar este bucket, comunícate con el equipo de asistencia de Display & Video 360.
    • En el campo ID de socio o anunciante de DV360, ingresa el ID de socio o el ID de anunciante.
    • Opcional: En la sección Opciones de notificación:
      • 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.
      • Haz clic en el botón de activación para habilitar las notificaciones de Pub/Sub. Para Seleccionar un tema de Cloud Pub/Sub, elige el nombre de tu tema o haz clic en Crear un tema. Esta opción configura las notificaciones de ejecución de Pub/Sub para tu transferencia.
  7. Haz clic en Guardar.

bq

Ingresa el comando bq mk y suministra la marca de creación de transferencias --transfer_config. Las siguientes marcas son obligatorias:

  • --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: el ID de tu proyecto
  • DATASET: el conjunto de datos de destino para la configuración de transferencia.
  • NAME: El nombre visible de la configuración de transferencia de datos. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.
  • PARAMETERS: los parámetros de la configuración de transferencia de datos creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}'. Para las transferencias de Display & Video 360, los parámetros bucket y displayvideo_id son obligatorios. El parámetro file_name_prefix es opcional y se usa solo para nombres de archivos excepcionales y personalizados.
  • DATA_SOURCE: La fuente de datos: displayvideo.

Por ejemplo, con el siguiente comando se crea una transferencia de datos de Display & Video 360 llamada My Transfer mediante el ID de Display & Video 360 123456, el bucket dcdt_-dbm_partner123456 de Cloud Storage y el conjunto de datos de destino mydataset.

La transferencia de datos se crea en el proyecto predeterminado:

  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

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 del mensaje 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.

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.

Te recomendamos que consultes las vistas generadas de manera automática en lugar de consultar directamente las tablas. Sin embargo, si deseas consultar tus tablas directamente, debes usar la seudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, ve a la sección Consulta tablas particionadas.