Integración con LiveRamp

En esta página se describen las configuraciones necesarias para importar 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 la experiencia de los clientes y obtener mejores resultados de negocio. Cortex Framework ofrece las herramientas y la plataforma para analizarla, combinarla 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 está disponible la fuente de datos de LiveRamp a través de la carga de trabajo de marketing de Cortex Framework Data Foundation:

Archivo de configuración

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

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

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

Conexión a la API

Cortex Framework Data Foundation permite la resolución de identidades mediante la integración con LiveRamp.Los Cortex Frameworks pueden realizar búsquedas de RampID, lo que permite a las empresas identificar audiencias o segmentos de clientes conocidos a partir de sus sistemas de gestión de relaciones con clientes (CRM).

RampID es un identificador generado por la API de LiveRamp que usa información personal identificable (IPI), 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 las audiencias de diferentes campañas. Al integrarse con LiveRamp, las empresas pueden mejorar su capacidad para identificar y segmentar a sus audiencias, lo que les permite crear campañas de marketing más eficaces y personalizadas.

La API LiveRamp Identity Resolution Retrieval permite a las empresas resolver de forma automática los datos de información personal identificable de los usuarios. Cortex Framework usa el endpoint Lookup de LiveRamp enviando datos de IPI cifrados mediante hash a través de la llamada a la API.

Tablas de entrada y salida

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

Tabla rampid_lookup_input

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

La tabla rampid_lookup_input debe rellenarse periódicamente (según las necesidades de tu empresa) con los detalles de la información personal identificable de tus clientes, como los siguientes: Cortex Framework no ofrece una forma automática de hacerlo, pero proporciona una secuencia de comandos de ejemplo ddls/samples/populate_rampid_lookup_input.sql que muestra cómo rellenar esta tabla con los datos de tu sistema de Salesforce que ya se ha implementado con Cortex Framework. Puedes usar este archivo como guía si tus datos proceden de otro sistema.

Asegúrate de que no haya entradas duplicadas en la tabla rampid_lookup_input (por ejemplo, que la misma persona no aparezca varias veces con la misma información personal identificable, aunque su ID sea diferente). El DAG de búsqueda de Cortex Framework fallaría si un segmento contiene muchas entradas duplicadas. Esto lo aplican las APIs de LiveRamp.

Tabla rampid_lookup

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

Los RampIDs de LiveRamp pueden cambiar con el tiempo para la misma persona. Esto significa que, de vez en cuando, debe realizar una búsqueda nueva de los datos que ya se hayan procesado. Cortex Framework proporciona un script de ejemplo ddls/samples/clean_up_segment_matching.sql que muestra cómo hacerlo a nivel de segmento. De esta forma, puede restablecer un segmento completo y el sistema buscará ese segmento y le proporcionará RampIDs actualizados.

La rampid_lookup (tabla de salida) puede contener un número ligeramente inferior de registros en comparación con la tabla de entrada. Esto es así porque Cortex Framework intenta depurar los registros de entrada usando detalles de información personal identificable para asegurarse de que la búsqueda de la API de LiveRamp no falle.

Autenticación de cuenta

1. Ponte en contacto con LiveRamp para obtener las credenciales de autenticación. Debe incluir el ID de cliente y el secreto de 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'
   }
   

   Haz los cambios siguientes:

   • 'CLIENT_ID' con el ID de cliente obtenido en el paso 1.
   • CLIENT_SECRET con el secreto de cliente obtenido en el paso 1.

Conexiones de Cloud Composer

Crea las siguientes conexiones en Cloud Composer. Para obtener más información, consulta la documentación sobre cómo gestionar conexiones de Airflow.

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. Aunque 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 hacer pruebas, es posible que tengas que dirigirlo a la versión de staging, en función de tu configuración.

Siguientes pasos

• Para obtener más información sobre otras fuentes de datos y cargas de trabajo, consulta el artículo 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.