Intégration à LiveRamp

Cette page décrit les configurations requises pour importer des données de LiveRamp en tant que source de données de la charge de travail marketing de Cortex Framework Data Foundation.

LiveRamp est une plate-forme de collaboration de données qui aide les entreprises à connecter, contrôler et activer leurs données pour améliorer l'expérience client et obtenir de meilleurs résultats commerciaux. Cortex Framework fournit les outils et la plate-forme nécessaires pour analyser ces données, les combiner avec d'autres sources de données et utiliser l'IA afin d'obtenir des insights plus approfondis et d'optimiser votre stratégie marketing.

Le schéma suivant décrit comment la source de données LiveRamp est disponible via la charge de travail marketing de Cortex Framework Data Foundation :

Source de données LiveRamp

Figure 1. Source de données LiveRamp.

Fichier de configuration

Le fichier config.json configure les paramètres requis pour se connecter aux sources de données afin de transférer des données à partir de différentes charges de travail. Ce fichier contient les paramètres suivants pour LiveRamp :

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

Le tableau suivant décrit la valeur de chaque paramètre LiveRamp :

Paramètre Signification Valeur par défaut Description
marketing.LiveRamp Déployer LiveRamp true Exécutez le déploiement pour la source de données LiveRamp.
marketing.LiveRamp.datasets.cdc Ensemble de données CDC pour LiveRamp Ensemble de données CDC pour LiveRamp.

Connexion API

Cortex Framework Data Foundation permet la résolution d'identité en s'intégrant à LiveRamp.Les Cortex Frameworks peuvent effectuer une recherche RampID, ce qui permet aux entreprises d'identifier des audiences ou des segments de clientèle connus à partir de leurs systèmes CRM.

RampID est un identifiant généré par l'API de LiveRamp à l'aide d'informations permettant d'identifier personnellement l'utilisateur, telles que l'adresse e-mail, le numéro de téléphone et le nom. Ce RampID permet aux entreprises d'identifier et de regrouper les enregistrements dans plusieurs systèmes, tels que les audiences de différentes campagnes. En s'intégrant à LiveRamp, les entreprises peuvent améliorer leur capacité à identifier et à cibler leurs audiences, ce qui leur permet de mener des campagnes marketing plus efficaces et personnalisées.

L'API de récupération de la résolution d'identité LiveRamp permet aux entreprises de résoudre par programmation les données PII pour les personnes. Cortex Framework utilise le point de terminaison de recherche de LiveRamp en envoyant des données PII hachées via l'appel d'API.

Tables d'entrée et de sortie

Après le déploiement de Cortex Framework, le système crée les deux tables BigQuery suivantes dans l' ensemble de données approprié fourni dans config.json.

Table rampid_lookup_input

La table rampid_lookup_input est l'entrée du processus de recherche RampID.

Colonne Type de données Description Exemple Clé primaire
id STRING ID unique de cet enregistrement. "123" Oui
segment_name STRING Nom du segment d'audience/CRM/client. "High Value" Non
source_system_name STRING Système source d'où provient l'enregistrement. "Salesforce" Non
name STRING Nom du client "John Doe" Non
email STRING Adresse e-mail du client "example@example.com" Non
phone_number STRING Numéro de téléphone du client "1234567890" Non
postal_code STRING Code postal du client "12345" Non
is_processed BOOL Indique si un enregistrement a déjà été traité.

Pour les nouveaux enregistrements, remplissez ce champ avec la valeur FALSE.

Le système remplace cette valeur par TRUE une fois le traitement effectué. 		FALSE Non
load_timestamp TIMESTAMP Code temporel indiquant quand l'enregistrement a été inséré dans le système. Il s'agit d'une information purement à des fins d'audit. "2020-01-01 00:00:00 UTC" Non
processed_timestamp TIMESTAMP Code temporel indiquant quand le système a effectué la recherche d'API pour cet enregistrement. Cette information est toujours renseignée par le système. "2020-01-01 00:00:00 UTC" Non

La table rampid_lookup_input doit être remplie régulièrement (en fonction des besoins de votre entreprise) avec les informations PII de vos clients, par exemple. Cortex Framework ne fournit pas de méthode automatisée pour ce faire, mais il fournit un exemple de script ddls/samples/populate_rampid_lookup_input.sql qui montre comment remplir cette table à l'aide des données de votre système Salesforce déjà déployé avec Cortex Framework. Vous pouvez utiliser ce fichier comme guide si vos données proviennent d'un autre système.

Assurez-vous qu'il n'y a pas d'entrées en double dans la table rampid_lookup_input (par exemple, la même personne est présente plusieurs fois avec les mêmes informations PII, même si son ID peut être différent). Le DAG de recherche Cortex Framework échouera si un segment contient de nombreuses entrées en double. Cette règle est appliquée par les API LiveRamp.

Table rampid_lookup

La table rampid_lookup est une table de résultat contenant les RampID de chaque segment de l'enregistrement d'entrée. Par conception, LiveRamp ne permet pas de mapper un RampID à un enregistrement individuel.

Colonne Type de données Description
segment_name STRING Nom du segment de la table d'entrée.
ramp_id STRING RampID LiveRamp
horodatage de l'enregistrement TIMESTAMP Code temporel indiquant quand cette recherche RampID a été effectuée.

Les RampID LiveRamp peuvent changer au fil du temps, pour la même personne. Cela signifie que vous devez effectuer une nouvelle recherche de temps en temps pour les données déjà traitées. Cortex Framework fournit un exemple de script ddls/samples/clean_up_segment_matching.sql qui montre comment procéder au niveau d'un segment. Vous pouvez ainsi réinitialiser un segment entier, et le système effectue une recherche pour ce segment et vous fournit des RampID à jour.

La table rampid_lookup (table de sortie) peut contenir un nombre d'enregistrements légèrement inférieur à celui de la table d'entrée. Ceci est intentionnel, car Cortex Framework tente de déboguer les enregistrements d'entrée à l'aide des informations PII pour s'assurer que la recherche de l'API LiveRamp ne échoue pas.

Authentification du compte

  1. Contactez LiveRamp pour obtenir des identifiants d'authentification. Ils doivent inclure l'ID client et le code secret du client.

  2. Créez un secret à l'aide de Secret Manager avec le nom cortex-framework-liveramp, et utilisez la valeur suivante. Pour obtenir des instructions , consultez la documentation de Secret Manager.

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

    Remplacez les éléments suivants :

    • 'CLIENT_ID' par l'ID client obtenu à l'étape 1.
    • 'CLIENT_SECRET' par le code secret du client obtenu à l'étape 1.

Connexions Managed Airflow

Créez les connexions suivantes dans Managed Airflow. Pour en savoir plus, consultez la documentation Gérer les connexions Airflow.

Nom de la connexion Purpose
liveramp_cdc_bq Pour l'API LiveRamp > transfert d'ensemble de données CDC

Configuration

Le fichier config.ini contrôle certains comportements du DAG Managed Airflow, ainsi que la manière dont les API LiveRamp sont utilisées. Configurez le fichier LiveRamp/src/pipelines/config.ini en fonction de vos besoins. Bien que ces paramètres soient déjà décrits dans le fichier, faites attention à liveramp_api_base_url. Par défaut, ce paramètre pointe vers l'URL de l'API de production de LiveRamp. À des fins de test, vous devrez peut-être le faire pointer vers la version de préproduction, en fonction de votre configuration.

Étape suivante