Integración con Campaign Manager 360

En esta página, se describen las configuraciones necesarias para importar datos de Campaign Manager 360 como fuente de datos de la carga de trabajo de marketing de la base de datos de Cortex Framework.

Campaign Manager 360 (CM360) es una plataforma de administración de publicidad basada en la Web que ofrece Google y que está diseñada específicamente para anunciantes y agencias. Funciona como un centro central para administrar y optimizar todas tus campañas publicitarias digitales en varios canales. Cortex Framework proporciona las herramientas y la plataforma para analizar los datos de CM360, combinarlos con datos de otros canales de marketing y usar la IA para obtener estadísticas más detalladas y optimizar tu estrategia de marketing general.

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

Fuente de datos de CM360

Figura 1. Fuente de datos de CM360.

Archivo de configuración

El archivo config.json configura los parámetros necesarios para conectarse a las fuentes de datos y transferir datos de diversas cargas de trabajo. Este archivo contiene los siguientes parámetros para CM360:

   "marketing": {
        "deployCM360": true,
        }

        "CM360": {
            "deployCDC": true,
            "dataTransferBucket": "",
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_CM360"
            }
        }

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

Parámetro Significado Valor predeterminado Descripción
marketing.deployCM360 Implementa CM360 true Ejecuta la implementación de la fuente de datos de CM360.
marketing.CM360.deployCDC Implementa secuencias de comandos de CDC para CM360 true Genera secuencias de comandos de procesamiento de CDC de CM360 para ejecutarlas como DAG en Managed Service para Apache Airflow.
marketing.CM360.dataTransferBucket Bucket con los resultados del Servicio de transferencia de datos - Bucket en el que se almacenan los archivos de DTv2.
marketing.CM360.datasets.cdc Conjunto de datos de CDC para CM360 Es el conjunto de datos de CDC para CM360.
marketing.CM360.datasets.raw Conjunto de datos sin procesar para CM360 Es el conjunto de datos sin procesar de CM360.
marketing.CM360.datasets.reporting Conjunto de datos de informes para CM360 "REPORTING_CM360" Es el conjunto de datos de informes de CM360.

Modelo de datos

En esta sección, se describe el modelo de datos de CM360 con el diagrama de relación entre entidades (ERD).

Diagrama de relación entre entidades para CM360

Figura 2: CM360: Diagrama de relación entre entidades.

Vistas base

Estos son los objetos azules en el DER y son vistas de las tablas de CDC sin transformaciones, excepto algunos alias de nombres de columnas. Consulta las secuencias de comandos en src/marketing/src/CM360/src/reporting/ddls.

Vistas de informes

Estos son los objetos verdes en el DER y son vistas de informes que contienen métricas agregadas. Consulta las secuencias de comandos en src/marketing/src/CM360/src/reporting/ddls.

Almacenamiento de archivos de DTv2

Los archivos de DTv2 (versión 2 de Transferencia de datos) son un formato específico que utiliza CM360 para proporcionar datos de rendimiento de las campañas. Configura el proceso de transferencia de datos siguiendo la documentación de Data Transfer V2.0 para usar CM360 con Cortex Framework.

Crea o agrega un bucket de Cloud Storage para almacenar tus archivos de DTv2 de CM360. Asegúrate de que la cuenta de servicio que ejecuta los DAG en Managed Airflow pueda leer los archivos del bucket. Para obtener más información, consulta Crea buckets de almacenamiento.

Actualidad y demora de los datos

Como regla general, la actualización de los datos de las fuentes de datos de Cortex Framework está limitada por lo que permite la conexión upstream, así como por la frecuencia de ejecución de tu DAG. Ajusta la frecuencia de ejecución de tu DAG para que coincida con la frecuencia de los procesos ascendentes, las restricciones de recursos y las necesidades de tu empresa.

Con la versión 2 de la Transferencia de datos de CM360, los datos de impresiones y clics se entregan 24 veces al día (cada hora). El tiempo de procesamiento puede variar según el archivo, por lo que es posible que los archivos aparezcan desordenados. Los archivos de actividad se entregan a diario.

Conexiones de Managed Airflow

Crea las siguientes conexiones en Managed Airflow. Para obtener más detalles, consulta la documentación sobre cómo administrar conexiones de Airflow.

Nombre de la conexión Purpose
cm360_raw_dataflow Para archivos de CM360 DTv2 > Conjunto de datos sin procesar de BigQuery
cm360_cdc_bq Para la transferencia de conjuntos de datos sin procesar a conjuntos de datos de CDC
cm360_reporting_bq Para la transferencia del conjunto de datos de CDC al conjunto de datos de informes

Permisos de la cuenta de servicio de Managed Service para Apache Airflow

Otorga permisos de Dataflow a la cuenta de servicio que se usa en Managed Airflow (como se configuró en la conexión cm360_raw_dataflow). Consulta las instrucciones en la documentación de Dataflow.

Configuración de transferencia

Controla las canalizaciones de datos Source to Raw y Raw to CDC a través de la configuración del archivo src/CM360/config/ingestion_settings.yaml. En esta sección, se describen los parámetros de cada canalización de datos.

De tablas de origen a tablas sin procesar

En esta sección, se describen las entradas que controlan qué archivos de DTv2 se procesan. Cada entrada corresponde a los archivos asociados con una entidad. Según esta configuración, Cortex Framework crea DAG de Airflow que ejecutan canalizaciones de Dataflow para procesar datos de los archivos de DTV2.

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

Parámetro Descripción
base_table Tabla del conjunto de datos sin procesar en la que se almacenan los datos de una entidad (por ejemplo, los datos de "Clics").
load_frequency Frecuencia con la que se ejecuta un DAG para esta entidad con el objetivo de completar la tabla del CDC. Para obtener más información sobre los valores posibles, consulta la documentación de Airflow.
file_pattern Son los patrones de nombres de archivos basados en una entidad.
schema_file Archivo de esquema en el directorio src/table_schema que asigna los campos de DTv2 a los nombres de columna y los tipos de datos de la tabla de destino.
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 para tener en cuenta el rendimiento. Para obtener más información, consulta Configuración del clúster.

Tablas sin procesar a CDC

Esta sección contiene entradas que controlan cómo se transfieren los datos de las tablas sin procesar a las tablas de CDC. Cada entrada corresponde a una tabla sin procesar (que, a su vez, corresponde a la entidad de DTv2 como se mencionó anteriormente).

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

Parámetro Descripción
base_table 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 Frecuencia con la que se ejecuta un DAG para esta entidad con el objetivo de completar la tabla del CDC. Para obtener más información sobre los valores posibles, consulta la documentación de Airflow.
row_identifiers Lista de 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 para tener en cuenta el rendimiento. Para obtener más información, consulta 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 CM360 con el archivo de configuración de informes (src/CM360/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