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:

Archivos de transferencia de datos v2 (Display & Video DTv2)

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

Opción de informe

Asistencia

Programa

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:

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
Nota: El equipo de Google Cloud no tiene la capacidad de generar archivos de Display & Video 360 DTv2 ni de otorgar acceso a ellos en tu nombre. Comunícate con el equipo de asistencia de Display & Video 360 o tu agencia para acceder a los archivos de Display & Video 360 DTv2.
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

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

Ir a Transferencias de datos
Haz clic en Crear transferencia.
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: vista previa.
- 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.
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
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.
En la sección Detalles de fuente de datos (Data source details):
- En el Display & Video 360 Ingresa el campo ID en el campo ID de socio oID del 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.
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

Aquí:

PROJECT_ID: el ID de tu proyecto
DATASET: el conjunto de datos de destino para la configuración de transferencia.
NAME es 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 son 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.