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 analizarlo, combinarlo 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. Es la fuente de datos de LiveRamp.

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 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 de la fuente de datos de LiveRamp.
marketing.LiveRamp.datasets.cdc Conjunto de datos de CDC para LiveRamp Es el conjunto de datos de CDC para LiveRamp.

Conexión a la API

La base de datos de Cortex Framework permite la resolución de identidades a través de la integración con LiveRamp.Los Cortex Frameworks pueden realizar una búsqueda de RampID, lo que permite a las empresas identificar públicos conocidos o segmentos de clientes de sus sistemas de CRM.

El RampID es un identificador que genera la API de LiveRamp a partir de la información de identificación personal (PII), como el correo electrónico, el número de teléfono y el 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 recuperación de resolución de identidad de LiveRamp permite a las empresas resolver de forma programática los datos de PII para personas físicas. Cortex Framework usa el endpoint de búsqueda de LiveRamp enviando datos de IIP 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 pertinente 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 segmento de público, CRM o cliente. "High Value" No
source_system_name STRING Sistema fuente del que proviene el registro. "Salesforce" No
nombre STRING Nombre del cliente "John Doe" No
correo electrónico STRING Correo electrónico del cliente "ejemplo@ejemplo.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ó.

En el caso de los registros nuevos, completa este campo con FALSE.

El sistema actualiza este valor a TRUE una vez que se procesa. 		FALSO No
load_timestamp TIMESTAMP Es la marca de tiempo en la 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 Es la marca de tiempo en la que el sistema realizó la búsqueda de la API para este registro. El sistema siempre propaga este campo. "2020-01-01 00:00:00 UTC" No

La tabla rampid_lookup_input debe completarse periódicamente (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í proporciona una secuencia de comandos de muestra ddls/samples/populate_rampid_lookup_input.sql que muestra cómo podrías completar esta tabla con los datos de tu sistema de Salesforce ya implementado 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 está presente varias veces con la misma información de PII, incluso si su ID puede ser diferente). El DAG de Cortex Framework Lookup fallaría si un segmento contiene muchas entradas duplicadas. Las APIs de LiveRamp aplican esta restricción.

La tabla rampid_lookup

La tabla rampid_lookup es una tabla de salida que contiene RampIDs para cada segmento del registro de entrada. Por diseño, LiveRamp no permite asignar un 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 LiveRamp RampID
sello de grabación TIMESTAMP Es la marca de tiempo en la que se realizó esta 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 nueva de los datos ya procesados. Cortex Framework proporciona una secuencia de comandos de ejemplo ddls/samples/clean_up_segment_matching.sql que muestra cómo puedes hacerlo a nivel del segmento. De esta manera, puedes restablecer un segmento completo, y el sistema realizará una búsqueda para ese segmento y te proporcionará RampIDs actualizados.

La tabla de salida rampid_lookup podría contener una cantidad ligeramente menor de registros en comparación con la tabla de entrada. Esto es así por diseño, ya que el Cortex Framework intenta depurar los registros de entrada con detalles de IIP para garantizar que la búsqueda en la API de LiveRamp no falle.

Autenticación de cuenta

  1. Comunícate con LiveRamp para obtener credenciales de autenticación. Esto 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 el siguiente 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" con el secreto del cliente obtenido en el paso 1.

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
liveramp_cdc_bq Para la API de LiveRamp > Transferencia del conjunto de datos de CDC

Configuración

El archivo config.ini controla parte del comportamiento del DAG de Managed Airflow, 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 apuntar a la versión de etapa de pruebas, según tu configuración.

Próximos pasos