Integrazione con LiveRamp

Questa pagina descrive le configurazioni necessarie per importare i dati da LiveRamp come origine dati del carico di lavoro di marketing di Cortex Framework Data Foundation.

LiveRamp è una piattaforma di collaborazione sui dati che aiuta le aziende a collegare, controllare e attivare i propri dati per migliorare le esperienze dei clienti e ottenere risultati aziendali migliori. Cortex Framework offre gli strumenti e la piattaforma per analizzarli, combinarli con altre origini dati e utilizzare l'IA per ottenere approfondimenti più approfonditi e ottimizzare la tua strategia di marketing.

Il seguente diagramma descrive come l'origine dati LiveRamp è disponibile tramite il carico di lavoro di marketing di Cortex Framework Data Foundation:

Origine dati LiveRamp

Figura 1. Origine dati LiveRamp.

File di configurazione

Il file config.json configura le impostazioni necessarie per connettersi alle origini dati per il trasferimento di dati da vari workload. Questo file contiene i seguenti parametri per LiveRamp:

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

La seguente tabella descrive il valore di ciascun parametro LiveRamp:

Parametro Significato Valore predefinito Descrizione
marketing.LiveRamp Esegui il deployment di LiveRamp true Esegui il deployment per l'origine dati LiveRamp.
marketing.LiveRamp.datasets.cdc Set di dati CDC per LiveRamp Set di dati CDC per LiveRamp.

Connessione API

La base di dati di Cortex Framework consente la risoluzione dell'identità tramite integrazione con LiveRamp.I framework Cortex possono eseguire RampID lookup, che consente alle aziende di identificare segmenti di pubblico o clienti noti dai loro sistemi CRM.

RampID è un identificatore generato dall'API di LiveRamp utilizzando informazioni che consentono l'identificazione personale (PII) come email, numero di telefono e nome. Questo RampID consente alle attività di identificare e consolidare i record in più sistemi, ad esempio i segmenti di pubblico di campagne diverse. Grazie all'integrazione con LiveRamp, le attività possono migliorare la propria capacità di identificare e scegliere come target i propri segmenti di pubblico, il che si traduce in campagne di marketing più efficaci e personalizzate.

L'API LiveRamp Identity Resolution Retrieval consente alle aziende di risolvere in modo programmatico i dati PII relativi a persone fisiche. Cortex Framework utilizza l'endpoint di ricerca di LiveRamp inviando dati PII sottoposti ad hashing tramite la chiamata API.

Tabelle di input e output

Dopo aver eseguito il deployment di Cortex Framework, il sistema crea le seguenti due tabelle BigQuery nel set di dati pertinente fornito in config.json.

rampid_lookup_input tabella

La tabella rampid_lookup_input è l'input per la procedura di ricerca dell'ID rampa.

Colonna Tipo di dati Descrizione Esempio Chiave primaria
ID STRING ID univoco di questo record. "123" Sì
segment_name STRING Nome del segmento di pubblico/CRM/cliente. "Valore elevato" No
source_system_name STRING Sistema di origine da cui proviene il record. "Salesforce" No
nome STRING Nome cliente "Mario Rossi" No
email STRING Email del cliente "example@example.com" No
phone_number STRING Telefono del cliente "1234567890" No
postal_code STRING Codice postale del cliente "12345" No
is_processed BOOL Indica se un record è già stato elaborato.

Per i nuovi record, inserisci FALSE.

Il sistema aggiorna questo valore su TRUE dopo l'elaborazione. 		FALSE No
load_timestamp TIMESTAMP Timestamp di inserimento del record nel sistema. Questo è solo a scopo di controllo. "2020-01-01 00:00:00 UTC" No
processed_timestamp TIMESTAMP Timestamp in cui il sistema ha eseguito la ricerca API per questo record. Questo campo viene sempre compilato dal sistema. "2020-01-01 00:00:00 UTC" No

La tabella rampid_lookup_input deve essere compilata periodicamente (in base alle esigenze della tua attività) con i dettagli PII dei tuoi clienti, ad esempio: Cortex Framework non fornisce un modo automatico per farlo, ma fornisce uno script di esempio ddls/samples/populate_rampid_lookup_input.sql che mostra come compilare questa tabella utilizzando i dati nel sistema Salesforce già implementato con Cortex Framework. Puoi utilizzare questo file come guida nel caso in cui i dati provengano da un altro sistema.

Assicurati che non siano presenti voci duplicate nella tabella rampid_lookup_input (ad esempio, la stessa persona è presente più volte con le stesse informazioni PII, anche se il relativo ID potrebbe essere diverso). Il DAG di ricerca del framework Cortex non andrebbe a buon fine se un segmento contiene molte voci duplicate. Questo viene applicato dalle API LiveRamp.

La tabella rampid_lookup

La tabella rampid_lookup è una tabella di output contenente i RampID per ogni segmento nel record di input. Per impostazione predefinita, LiveRamp non consente di mappare il RampID a un singolo record.

Colonna Tipo di dati Descrizione
segment_name STRING Nome del segmento dalla tabella di input.
ramp_id STRING RampID di LiveRamp
timbro di registrazione TIMESTAMP Timestamp della ricerca dell'ID rampa.

I RampID di LiveRamp possono cambiare nel tempo per la stessa persona. Ciò significa che di tanto in tanto devi eseguire una nuova ricerca per i dati già elaborati. Cortex Framework fornisce un script di esempio ddls/samples/clean_up_segment_matching.sql che mostra come eseguire questa operazione a livello di segmento. In questo modo, puoi reimpostare un intero segmento e il sistema eseguirà una ricerca per quel segmento e ti fornirà RampID aggiornati.

rampid_lookup (tabella di output) potrebbe contenere un numero leggermente inferiore di record rispetto alla tabella di input. Questo è intenzionale, in quanto Cortex Framework tenta di eseguire il debug dei record di input utilizzando i dettagli PII per garantire che la ricerca nell'API LiveRamp non abbia esito negativo.

Autenticazione account

  1. Contatta LiveRamp per ottenere le credenziali di autenticazione. Dovrebbero essere inclusi ID client e client secret.

  2. Crea un secret utilizzando Secret Manager con il nomecortex-framework-liveramp e utilizza quanto segue come valore. Consulta le istruzioni riportate nella documentazione di Secret Manager.

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

    Sostituisci quanto segue:

    • "CLIENT_ID" con l'ID client ottenuto nel passaggio 1.
    • "CLIENT_SECRET" con il client secret ottenuto nel passaggio 1.

Connessioni Cloud Composer

Crea le seguenti connessioni in Cloud Composer. Per ulteriori dettagli, consulta la documentazione sulla gestione delle connessioni Airflow.

Nome connessione Purpose
liveramp_cdc_bq Per il trasferimento di set di dati CDC > API LiveRamp

Configurazione

Il file config.ini controlla alcuni comportamenti del DAG di Cloud Composer, nonché il modo in cui vengono utilizzate le API LiveRamp. Configura il file LiveRamp/src/pipelines/config.ini in base alle tue esigenze. Sebbene questi parametri siano già descritti nel file, fai attenzione a liveramp_api_base_url. Per impostazione predefinita, questo parametro fa riferimento all'URL dell'API di produzione di LiveRamp. Per scopi di test, potrebbe essere necessario indirizzarlo alla versione di staging, a seconda della configurazione.

Passaggi successivi