Integrazione con LiveRamp

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

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

Il seguente diagramma descrive come l'origine dati LiveRamp è disponibile tramite il workload 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 richieste per la connessione alle origini dati per il trasferimento dei 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 ogni 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

Cortex Framework Data Foundation abilita la risoluzione delle identità tramite l' integrazione con LiveRamp.I framework Cortex possono eseguire la ricerca di RampID, che consente alle aziende di identificare segmenti di pubblico o clienti noti dai propri 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 aziende di identificare e consolidare i record in più sistemi, ad esempio i segmenti di pubblico di diverse campagne. Integrando LiveRamp, le aziende possono migliorare la propria capacità di identificare e targetizzare i propri segmenti di pubblico, il che porta a campagne di marketing più efficaci e personalizzate.

L'API LiveRamp Identity Resolution Retrieval consente alle aziende di risolvere in modo programmatico i dati PII per i singoli utenti. Cortex Framework utilizza l'endpoint di ricerca di LiveRamp inviando i dati PII con hash tramite la chiamata API.

Tabelle di input e output

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

Tabella rampid_lookup_input

La tabella rampid_lookup_input è l'input per il processo di ricerca di RampID.

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/clienti. "High Value" No
source_system_name STRING Sistema di origine da cui proviene il record. "Salesforce" No
name STRING Nome cliente "John Doe" 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 a TRUE una volta elaborato. 		FALSE No
load_timestamp TIMESTAMP Timestamp di inserimento del record nel sistema. Questo valore è puramente a scopo di audit. "2020-01-01 00:00:00 UTC" No
processed_timestamp TIMESTAMP Timestamp di esecuzione della ricerca API per questo record. Questo valore 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 già presenti nel sistema Salesforce di cui è stato eseguito il deployment con Cortex Framework. Puoi utilizzare questo file come guida nel caso in cui i dati provengano da un altro sistema.

Assicurati di non avere voci duplicate nella tabella rampid_lookup_input (ad esempio, la stessa persona è presente più volte con le stesse informazioni PII, anche se il suo ID potrebbe essere diverso). Il DAG di ricerca di Cortex Framework non riuscirà se un segmento contiene molte voci duplicate. Questo comportamento è imposto dalle API di LiveRamp.

Tabella rampid_lookup

La tabella rampid_lookup è una tabella di output che contiene i RampID per ogni segmento nel record di input. Per impostazione predefinita, LiveRamp non consente di mappare 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
record stamp TIMESTAMP Timestamp di esecuzione della ricerca di questo RampID è stato eseguito.

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 uno 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à i RampID aggiornati.

La tabella di output rampid_lookup potrebbe contenere un numero di record leggermente inferiore rispetto alla tabella di input. Questo comportamento è intenzionale, in quanto Cortex Framework tenta di eseguire il debug dei record di input utilizzando i dettagli PII per garantire che la ricerca API di LiveRamp non vada a buon fine.

Autenticazione account

  1. Contatta LiveRamp per ottenere le credenziali di autenticazione. Queste devono includere ID client e client secret.

  2. Crea un secret utilizzando Secret Manager con il nome cortex-framework-liveramp e utilizza il seguente valore. Per istruzioni , consulta la 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 di Managed Airflow

Crea le seguenti connessioni in Managed Airflow. Per maggiori dettagli, consulta la documentazione Gestire le connessioni Airflow.

Nome connessione Scopo
liveramp_cdc_bq Per il trasferimento del set di dati CDC tramite l'API LiveRamp

Configurazione

Il file config.ini controlla alcuni comportamenti del DAG di Managed Airflow, nonché la modalità di utilizzo delle API di LiveRamp. Configura il LiveRamp/src/pipelines/config.ini file in base alle tue esigenze. Sebbene questi parametri siano già descritti nel file, presta attenzione a liveramp_api_base_url. Per impostazione predefinita, questo parametro punta all'URL dell'API di produzione di LiveRamp. A scopo di test, potrebbe essere necessario puntare alla versione di staging, a seconda della configurazione.

Passaggi successivi