Integración con LiveRamp

En esta página, se describen las configuraciones necesarias para incorporar datos de LiveRamp como fuente de datos de la carga de trabajo de marketing de Cortex Framework Data Foundation.

LiveRamp es una plataforma de colaboración de datos que ayuda a las empresas a conectar, controlar y activar sus datos para mejorar las experiencias de los clientes y generar mejores resultados comerciales. Cortex Framework ofrece las herramientas y la plataforma para analizarlos, combinarlos con otras fuentes de datos y usar la IA para obtener estadísticas más detalladas y optimizar tu estrategia de marketing.

En el siguiente diagrama, se describe cómo la fuente de datos de LiveRamp está disponible a través de la carga de trabajo de marketing de Cortex Framework Data Foundation:

Fuente de datos de LiveRamp

Figura 1. Fuente de datos de LiveRamp.

Archivo de configuración

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

   "marketing": {
        "deployLiveRamp": true,
        "LiveRamp": {
            "datasets": {
                "cdc": ""
            }
        }
    }

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

Parámetro Significado Valor predeterminado Descripción
marketing.LiveRamp Implementa LiveRamp true Ejecuta la implementación para la fuente de datos de LiveRamp.
marketing.LiveRamp.datasets.cdc Conjunto de datos de CDC para LiveRamp Conjunto de datos de CDC para LiveRamp.

Conexión a la API

La base de datos de Cortex Framework habilita la resolución de identidad a través de la integración con LiveRamp.Cortex Framework puede realizar la búsqueda de RampID, que permite a las empresas identificar públicos conocidos o segmentos de clientes desde sus sistemas de CRM.

RampID es un identificador que genera la API de LiveRamp con información de identificación personal (PII), como correo electrónico, número de teléfono y nombre. Este RampID permite a las empresas identificar y consolidar registros en varios sistemas, como los públicos de diferentes campañas. Con la integración de LiveRamp, las empresas pueden mejorar su capacidad para identificar y segmentar sus públicos, lo que genera campañas de marketing más eficaces y personalizadas.

La API de LiveRamp Identity Resolution Retrieval permite a las empresas resolver de forma programática los datos de PII de las personas. El framework de Cortex usa el endpoint de búsqueda de LiveRamp enviando datos de PII con hash a través de la llamada a la API.

Tablas de entrada y salida

Después de implementar Cortex Framework, el sistema crea las siguientes dos tablas de BigQuery en el conjunto de datos relevante proporcionado en config.json.

rampid_lookup_input tabla

La tabla rampid_lookup_input es la entrada para el proceso de búsqueda de RampID.

Columna Tipo de datos Descripción Ejemplo Clave primaria
id STRING Es el ID único de este registro. "123" Sí
segment_name STRING Es el nombre del público, el CRM o el segmento de clientes. "High Value" No
source_system_name STRING Es el sistema de origen del que proviene el registro. "Salesforce" No
nombre STRING Nombre del cliente "Juan Pérez" No
correo electrónico STRING Correo electrónico del cliente "ejemplo@example.com" No
phone_number STRING Teléfono del cliente "1234567890" No
postal_code STRING Código postal del cliente "12345" No
is_processed BOOL Indica si un registro ya se procesó.

Para los registros nuevos, propaga este valor con FALSE.

El sistema lo actualiza a VERDADERO una vez que se procesa. 		FALSO No
load_timestamp TIMESTAMP Es la marca de tiempo del momento en que se insertó el registro en el sistema. Esto es solo para fines de auditoría. "2020-01-01 00:00:00 UTC" No
processed_timestamp TIMESTAMP Marca de tiempo de la búsqueda de API que realizó el sistema para este registro. El sistema siempre propaga este valor. "2020-01-01 00:00:00 UTC" No

La tabla rampid_lookup_input debe propagarse de forma periódica (según las necesidades de tu empresa) con los detalles de la PII de tus clientes, como los siguientes: Cortex Framework no proporciona una forma automatizada de hacerlo, pero sí una secuencia de comandos de muestra ddls/samples/populate_rampid_lookup_input.sql que muestra cómo puedes propagar esta tabla con datos de tu sistema de Salesforce que ya se implementó con Cortex Framework. Puedes usar este archivo como guía en caso de que tus datos provengan de otro sistema.

Asegúrate de no tener entradas duplicadas en la tabla rampid_lookup_input (por ejemplo, la misma persona aparece varias veces con la misma información de PII, incluso si su ID puede ser diferente). El DAG de búsqueda de Cortex Framework fallaría si un segmento contiene muchas entradas duplicadas. Las APIs de LiveRamp aplican esta política.

La tabla rampid_lookup

La tabla rampid_lookup es una tabla de salida que contiene RampIDs para cada segmento en el registro de entrada. Por diseño, LiveRamp no permite asignar RampID a un registro individual.

Columna Tipo de datos Descripción
segment_name STRING Es el nombre del segmento de la tabla de entrada.
ramp_id STRING RampID de LiveRamp
sello de registro TIMESTAMP Marca de tiempo de la búsqueda de RampID.

Los RampIDs de LiveRamp pueden cambiar con el tiempo para la misma persona. Esto significa que, de vez en cuando, debes realizar una búsqueda actualizada de los datos que ya se procesaron. Cortex Framework proporciona una secuencia de comandos de muestra ddls/samples/clean_up_segment_matching.sql que muestra cómo puedes hacerlo a nivel de un segmento. De esta manera, puedes restablecer un segmento completo, y el sistema realizará una búsqueda de ese segmento y te proporcionará los RampIDs actualizados.

Es posible que rampid_lookup (tabla de salida) contenga una cantidad ligeramente menor de registros en comparación con la tabla de entrada. Esto es así por diseño, ya que el framework de Cortex intenta depurar los registros de entrada con detalles de PII para garantizar que la búsqueda de la API de LiveRamp no falle.

Autenticación de cuenta

  1. Comunícate con LiveRamp para obtener credenciales de autenticación. Debe incluir el ID de cliente y el secreto del cliente.

  2. Crea un secreto con Secret Manager con el nombre cortex-framework-liveramp y usa lo siguiente como valor. Consulta las instrucciones en la documentación de Secret Manager.

    {
  'client_id':'CLIENT_ID',
  'client_secret':'CLIENT_SECRET',
  'grant_type':'client_credentials'
}

    Reemplaza lo siguiente:

    • "CLIENT_ID" con el ID de cliente que obtuviste en el paso 1.
    • "CLIENT_SECRET" por el secreto de cliente que obtuviste en el paso 1.

Conexiones de Cloud Composer

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

Nombre de la conexión Purpose
liveramp_cdc_bq Para la API de LiveRamp > Transferencia de conjuntos de datos de CDC

Configuración

El archivo config.ini controla algunos comportamientos del DAG de Cloud Composer, así como la forma en que se consumen las APIs de LiveRamp. Configura el archivo LiveRamp/src/pipelines/config.ini según tus necesidades. Si bien estos parámetros ya se describen en el archivo, presta atención a liveramp_api_base_url. De forma predeterminada, este parámetro apunta a la URL de la API de producción de LiveRamp. Para realizar pruebas, es posible que debas apuntarlo a la versión de etapa, según tu configuración.

Próximos pasos