Se usó la API de Cloud Translation para traducir esta página.

Integración con YouTube (DV360)

En esta página, se describen las configuraciones necesarias para transferir datos de YouTube con Display & Video 360 (DV360) como fuente de datos de la carga de trabajo de marketing de Cortex Framework Data Foundation.

DV360 es una plataforma publicitaria de Google para administrar la publicidad de YouTube junto con otros canales digitales, lo que les ofrece a los anunciantes un mayor control y eficiencia en sus iniciativas de marketing.

En el siguiente diagrama, se describe cómo los datos de DV360 están disponibles a través de la carga de trabajo de marketing de Cortex Framework Data Foundation:

Fuente de datos de DV360

Figura 1. Fuente de datos de DV360.

Archivo de configuración

El archivo config.json configura la configuración necesaria para conectarse a fuentes de datos y transferir datos desde varias cargas de trabajo. Este archivo contiene los siguientes parámetros para DV360:

   "marketing": {
        "deployDV360": true,
        "DV360": {
            "deployCDC": true,
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_DV360"
            }
        }
   }

En la siguiente tabla, se describe el valor de cada parámetro de marketing:

Parámetro	Significado	Valor predeterminado	Descripción
`marketing.deployDV360`	Implementa DV360	`true`	Ejecuta la implementación para la fuente de datos de DV360.
`marketing.DV360.deployCDC`	Implementa secuencias de comandos de CDC para DV360	`true`	Genera secuencias de comandos de procesamiento de CDC de DV360 para ejecutarlas como DAG en Cloud Composer.
`marketing.DV360.datasets.cdc`	Conjunto de datos de CDC para DV360	-	Conjunto de datos del CDC para DV360.
`marketing.DV360.datasets.raw`	Conjunto de datos sin procesar para DV360	-	Es un conjunto de datos sin procesar para DV360.
`marketing.DV360.datasets.reporting`	Conjunto de datos de informes para DV360	`REPORTING_DV360`	Es el conjunto de datos de informes de DV360.

Modelo de datos

En esta sección, se describe el modelo de datos de YouTube (con DV360) mediante el diagrama de relaciones de entidades (ERD).

Figura 2: YouTube (con DV360): diagrama de relaciones de entidades.

Vistas de informes

Los objetos azules en el ERE representan las vistas de informes que contienen métricas agregadas. Consulta las secuencias de comandos en src/marketing/src/DV360/src/reporting/ddls.

Configura la extracción de datos sin procesar de DV360

Cortex Framework se integra en DV360 con la función de informes instantáneos. Los informes instantáneos son una función lista para usar, confiable y de bajo costo de DV360 que permite guardar, programar y descargar informes más grandes y complejos en archivos y diferentes ubicaciones. Cada informe crea periódicamente tablas de datos de exportación en BigQuery con el mismo prefijo de nombre de tabla configurado, que contiene datos del período seleccionado, con la frecuencia seleccionada.

Permisos

Para exportar correctamente datos sin procesar de DV360 con los informes instantáneos, se requieren personas con los siguientes permisos:

DV360:
- Acceso estándar para los socios o anunciantes seleccionados
Google Cloud:
- El rol BigQuery User asignado a la cuenta de servicio de DV360
- El rol BigQuery Data Editor asignado a la cuenta de servicio de DV360

Configurar

Sigue estos pasos para configurar la exportación de tablas sin procesar desde DV360.

Para identificar la cuenta de servicio que requiere el Exportador de BigQuery de DV360, consulta la sección Detalles de permisos de la cuenta del Exportador de BigQuery. Consulta la Figura 2 para obtener más información.
Figura 2: Cómo identificar la cuenta de servicio en la cuenta del exportador de BigQuery de vinculación
Obtén permisos de Google Cloud . Una persona con el rol BigQuery Administrator debe otorgar los roles BigQuery User y BigQuery Data Editor a la cuenta de servicio de DV360 identificada en el paso anterior.
Vincula BigQuery a DV360 y especifica el conjunto de datos sin procesar que deseas usar en el proceso. Sigue las instrucciones de la sección Informes sin conexión > Habilita BigQuery.

Ve a Informes instantáneos y crea un informe para cada fila de la siguiente tabla, con las columnas tal como se muestran. Para obtener más información sobre los archivos de definiciones de esquemas de columnas detallados en src/DV360/config/table_schema, consulta la sección Esquema de tabla de datos sin procesar a CDC.

Agrega al menos un filtro de socio o anunciante. Asegúrate de que esto se alinee con los permisos de tu vínculo de BigQuery en el paso 3.

Selecciona Zona horaria del anunciante como la configuración de zona horaria del informe. Para obtener más información, consulta la siguiente sección Consideraciones adicionales.

Prefijo de la tabla	Campos que se deben incluir
`lineitem_details`	Fecha ID de la línea de pedido Línea de pedido ID de la campaña Campaña Tipo de línea de pedido Fecha de inicio de la línea de pedido Fecha de finalización de la línea de pedido	Impresiones
`lineitem_insights`	Fecha ID de la línea de pedido Tipo de dispositivo Navegador Entorno País ID del socio Socio Moneda del socio ID del anunciante Anunciante Moneda del anunciante ID de la campaña Campaña ID del pedido de inserción Pedido de inserción Línea de pedido Tipo de línea de pedido Fecha de inicio de la línea de pedido Fecha de finalización de la línea de pedido	Impresiones Clics Ingresos (USD) Compromisos Ingresos (moneda del socio) Ingresos (moneda de la campaña) TrueView: Vistas
`adgroup_insights_by_age_gender`	Fecha ID del grupo de anuncios de YouTube Edad (YouTube) Género ID de la línea de pedido ID del socio Socio Moneda del socio AdvertiserID Anunciante Moneda del anunciante ID del pedido de inserción Pedido de inserción Línea de pedido Grupo de anuncios de YouTube	Ingresos (USD) Impresiones Clics Participaciones (YouTube) Ingresos (moneda del socio) Ingresos (moneda de la campaña) TrueView: Vistas
`adgroup_insights_by_audience`	Fecha ID del grupo de anuncios de YouTube Segmento de público Tipo de segmento de público ID de la línea de pedido ID del socio Socio PartnerCurrency ID del anunciante Anunciante Moneda del anunciante ID del pedido de inserción Pedido de inserción Línea de pedido	Impresiones Clics Grupo de anuncios de YouTube Ingresos (USD) Participaciones (YouTube) Ingresos (PartnerCurrency) Ingresos (moneda de la campaña) TrueView: Vistas
`adgroup_insights_by_adformat`	Fecha ID del grupo de anuncios de YouTube Formato del anuncio de YouTube ID de la línea de pedido ID del socio Socio Moneda del socio ID del anunciante Anunciante Moneda del anunciante ID del pedido de inserción Pedido de inserción Línea de pedido	Impresiones Clics Grupo de anuncios de YouTube Ingresos (USD) Participaciones (YouTube) Ingresos (moneda del socio) Ingresos (moneda de la campaña) TrueView: Vistas
`adgroup_insights_by_placement`	Fecha ID del grupo de anuncios de YouTube Posición (todos los canales de YouTube) Nombre de la posición (todos los canales de YouTube) ID de la línea de pedido PartnerID Socio Moneda del socio ID del anunciante Anunciante Moneda del anunciante ID del pedido de inserción Pedido de inserción Línea de pedido	Impresiones Grupo de anuncios de YouTube Ingresos (USD) Participaciones (YouTube) Ingresos (PartnerCurrency) Ingresos (moneda de la campaña) TrueView: Vistas
`adgroup_insights_by_adtype`	Fecha ID del grupo de anuncios de YouTube Tipo de anuncio de YouTube ID de la línea de pedido ID del socio Socio Moneda del socio ID del anunciante Anunciante Moneda del anunciante ID del pedido de inserción Pedido de inserción Línea de pedido	Impresiones Clics Grupo de anuncios de YouTube Ingresos (USD) Participaciones (YouTube) Ingresos (moneda del socio) Ingresos (moneda de la campaña) TrueView: Vistas
`ad_insights`	Fecha ID del anuncio de YouTube ID de la línea de pedido ID del socio Socio Moneda del socio ID del anunciante Anunciante AdvertiserCurrency ID del pedido de inserción Pedido de inserción Línea de pedido ID del grupo de anuncios de YouTube Grupo de anuncios de YouTube Anuncio de YouTube	Impresiones Clics Ingresos (USD) Participaciones (YouTube) Ingresos (moneda del socio) Ingresos (AdvCurrency) TrueView: Vistas

Configura el programa y completa los datos históricos. Asegúrate de usar el mismo vínculo de BigQuery que se configuró en el paso 1, así como el prefijo de la tabla exactamente como se muestra en la tabla anterior. Para obtener más información, consulta la siguiente sección Consideraciones adicionales.
- Activa una ejecución de reabastecimiento de forma manual o espera a que comience la exportación programada. De cualquier manera, tus datos se envían automáticamente al conjunto de datos sin procesar configurado para tu vinculación de BigQuery.

Consideraciones adicionales

Acerca de la selección de la zona horaria:

En algunos tipos de informes, tienes la opción de elegir la zona horaria del anunciante o la zona horaria UTC para las fechas en el momento de configurar la exportación. Sin embargo, los informes relacionados con YouTube solo admiten la zona horaria del anunciante. Por lo tanto, asegúrate de seleccionar la configuración de zona horaria Anunciante cuando configures las exportaciones.
Como la exportación de informes se agrega previamente a nivel diario, Cortex Framework usa la fecha proporcionada directamente sin conversiones de zona horaria. Eres responsable de interpretar la información de la zona horaria informada.

Acerca de la programación y el reabastecimiento de datos históricos:

Te recomendamos que selecciones Últimos 7 días como el período de exportación y Diario como la frecuencia de exportación. Seleccionar un período y una frecuencia de exportación es necesario para lograr un equilibrio entre la precisión de los datos y el costo de almacenamiento, aunque cualquier configuración funcionará con nuestro proceso de CDC.
Los informes instantáneos admiten la exportación de hasta 14 días de datos cuando se exportan a BigQuery, aunque, en ocasiones, DV360 puede realizar actualizaciones menores de los datos, hasta 31 días después de la fecha del informe. Si configuras la exportación para varios anunciantes, la fecha de cada uno de ellos se mostrará en su propia zona horaria.
Si se requieren datos históricos, como informes únicos no programados, los Informes instantáneos permiten exportar hasta 2 años de datos directamente a las tablas de BigQuery. Asegúrate de hacerlo al menos una vez, manualmente desde la IU de DV360.

Actualización y demora de los datos

Como regla general, la actualización de los datos de las fuentes de datos de Cortex Framework se limita a lo que permite la conexión upstream, así como a la frecuencia de la ejecución de tu DAG. Ajusta la frecuencia de ejecución de tu DAG para alinearla con la frecuencia upstream, las restricciones de recursos y las necesidades de tu empresa.

Con los informes instantáneos de DV360, la actualización de los datos depende de la configuración de la frecuencia de exportación cuando se configura BigQuery Export, que puede ser diaria, semanal o mensual.

Configuraciones

En esta sección, se describen las configuraciones del proceso de datos.

Conexiones de Cloud Composer

Crea las siguientes conexiones en Cloud Composer. Consulta más detalles en la documentación de Cloud Composer.

Nombre de la conexión	Purpose
`dv360_cdc_bq`	Para conjunto de datos sin procesar > Transferencia de conjunto de datos de CDC.
`dv360_reporting_bq`	Para el conjunto de datos de CDC > Transferencia de conjuntos de datos de informes.

Esquema de tabla de sin procesar a CDC

El directorio src/DV360/config/table_schema contiene un archivo de esquema por conjunto de tablas (identificado por el mismo prefijo) que se exporta desde DV360. Cada archivo de esquema contiene dos columnas: ColumnName y ColumnDataType.

Configuración de transferencia

El archivo src/DV360/config/ingestion_settings.yaml contiene más parámetros de configuración que controlan los canales de datos de fuente a CDC.

De la fuente a las tablas de CDC

Esta sección tiene entradas que controlan cómo se transfieren las tablas exportadas de DV360 y el comportamiento relevante del proceso de CDC. Cada entrada corresponde a un informe de informes instantáneos, identificado por el prefijo de exportación.

Los siguientes parámetros controlan la configuración de Source to CDC para cada entrada:

Parámetro	Descripción
`base_table`	Es la tabla del conjunto de datos de CDC en la que se almacenan los datos sin procesar después de la transformación de CDC (por ejemplo, `customer`).
`load_frequency`	La frecuencia con la que se ejecuta un DAG para esta entidad para propagar la tabla de CDC. Para obtener más información sobre los valores posibles, consulta la documentación de Airflow.
`raw_table_prefix`	Es el prefijo que usa el informe de informes instantáneos correspondiente para configurar esta exportación de BigQuery.
`row_identifiers`	Son las columnas (separadas por comas) que forman un registro único para esta tabla.
`partition_details`	Opcional: Si deseas que esta tabla se particione por motivos de rendimiento. Para obtener más información, consulta Partición de tablas.
`cluster_details`	Opcional: Si deseas que esta tabla se agrupe por motivos de rendimiento, consulta más información en Configuración del clúster.

Configuración de informes

Puedes configurar y controlar cómo Cortex Framework genera datos para la capa de informes final de DV360 con el archivo de configuración de informes src/DV360/config/reporting_settings.yaml. Este archivo controla cómo se generan los objetos de BigQuery de la capa de informes (tablas, vistas,funciones o procedimientos almacenados).

Para obtener más información, consulta Cómo personalizar el archivo de configuración de informes.

Próximos pasos

Para obtener más información sobre otras fuentes de datos y cargas de trabajo, consulta Fuentes de datos y cargas de trabajo.
Para obtener más información sobre los pasos para la implementación en entornos de producción, consulta los requisitos previos para la implementación de Data Foundation de Cortex Framework.