Einbindung von LiveRamp

Auf dieser Seite werden die erforderlichen Konfigurationen beschrieben, um Daten von LiveRamp als Datenquelle für die Marketing-Arbeitslast der Cortex Framework Data Foundation zu verwenden.

LiveRamp ist eine Plattform für die Zusammenarbeit bei der Datennutzung, mit der Unternehmen ihre Daten verbinden, kontrollieren und aktivieren können, um die Kundenerfahrung zu verbessern und bessere Geschäftsergebnisse zu erzielen. Cortex Framework bietet die Tools und die Plattform, um diese Daten zu analysieren, mit anderen Datenquellen zu kombinieren und mithilfe von KI tiefere Einblicke zu gewinnen und Ihre Marketingstrategie zu optimieren.

Das folgende Diagramm zeigt, wie die LiveRamp-Datenquelle über die Marketing-Arbeitslast der Cortex Framework Data Foundation verfügbar ist:

LiveRamp-Datenquelle

Abbildung 1. LiveRamp-Datenquelle.

Konfigurationsdatei

In der Datei config.json werden die Einstellungen konfiguriert, die für die Verbindung zu Datenquellen zum Übertragen von Daten aus verschiedenen Arbeitslasten erforderlich sind. Diese Datei enthält die folgenden Parameter für LiveRamp:

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

In der folgenden Tabelle wird der Wert für jeden LiveRamp-Parameter beschrieben:

Parameter Bedeutung Standardwert Beschreibung
marketing.LiveRamp LiveRamp bereitstellen true Führen Sie die Bereitstellung für die LiveRamp-Datenquelle aus.
marketing.LiveRamp.datasets.cdc CDC-Dataset für LiveRamp CDC-Dataset für LiveRamp.

API-Verbindung

Die Cortex Framework Data Foundation ermöglicht die Identitätsauflösung durch Integration mit LiveRamp.Cortex Frameworks können RampID-Lookups durchführen, sodass Unternehmen bekannte Zielgruppen oder Kundensegmente aus ihren CRM-Systemen identifizieren können.

RampID ist eine Kennung, die von der API von LiveRamp anhand von personenidentifizierbaren Informationen wie E-Mail-Adresse, Telefonnummer und Name generiert wird. Mit dieser RampID können Unternehmen Datensätze in mehreren Systemen, z. B. Zielgruppen verschiedener Kampagnen, identifizieren und konsolidieren. Durch die Integration mit LiveRamp können Unternehmen ihre Zielgruppen besser identifizieren und ausrichten. Das führt zu effektiveren und personalisierten Marketingkampagnen.

Mit der LiveRamp Identity Resolution Retrieval API können Unternehmen personenidentifizierbare Informationen (PII) programmatisch Personen zuordnen. Das Cortex Framework verwendet den Lookup Endpoint von LiveRamp, indem gehashte personenbezogene Daten über den API-Aufruf gesendet werden.

Eingabe- und Ausgabetabellen

Nachdem Sie Cortex Framework bereitgestellt haben, erstellt das System die folgenden zwei BigQuery-Tabellen im relevanten Dataset, das in config.json angegeben ist.

rampid_lookup_input Tabelle

Die Tabelle rampid_lookup_input ist die Eingabe für den RampID-Suchvorgang.

Spalte Datentyp Beschreibung Beispiel Primärschlüssel
id STRING Eindeutige ID dieses Datensatzes. „123“ Ja
segment_name STRING Name des Zielgruppen-, CRM- oder Kundensegments. „Hoher Wert“ Nein
source_system_name STRING Quellsystem, aus dem der Datensatz stammt. „Salesforce“ Nein
Name STRING Kundenname „Max Mustermann“ Nein
E-Mail STRING E‑Mail-Adresse des Kunden „beispiel@beispiel.de“ Nein
phone_number STRING Telefonnummer des Kunden „1234567890“ Nein
postal_code STRING Postleitzahl des Kunden „12345“ Nein
is_processed BOOL Gibt an, ob ein Datensatz bereits verarbeitet wurde.

Geben Sie für neue Datensätze FALSE an.

Das System ändert den Wert in „TRUE“, sobald die Verarbeitung abgeschlossen ist. 		FALSE Nein
load_timestamp TIMESTAMP Zeitstempel für das Einfügen des Datensatzes in das System. Dies dient ausschließlich zu Prüfzwecken. „2020-01-01 00:00:00 UTC“ Nein
processed_timestamp TIMESTAMP Zeitstempel, zu dem das System die API-Suche für diesen Datensatz durchgeführt hat. Diese wird immer vom System ausgefüllt. „2020-01-01 00:00:00 UTC“ Nein

Die Tabelle rampid_lookup_input muss regelmäßig (je nach Ihren Geschäftsanforderungen) mit den personenbezogenen Daten Ihrer Kunden gefüllt werden, z. B. Cortex Framework bietet keine automatisierte Möglichkeit dafür, aber ein Beispielskript ddls/samples/populate_rampid_lookup_input.sql, das zeigt, wie Sie diese Tabelle mit Daten aus Ihrem Salesforce-System füllen können, die bereits mit Cortex Framework bereitgestellt wurden. Sie können diese Datei als Leitfaden verwenden, wenn Ihre Daten aus einem anderen System stammen.

Achten Sie darauf, dass die Tabelle rampid_lookup_input keine doppelten Einträge enthält. Das kann beispielsweise der Fall sein, wenn dieselbe Person mehrmals mit denselben personenidentifizierbaren Informationen vorhanden ist, auch wenn sich die ID-Werte unterscheiden. Der Lookup-DAG des Cortex Framework schlägt fehl, wenn ein Segment viele doppelte Einträge enthält. Dies wird durch LiveRamp-APIs erzwungen.

Die Tabelle rampid_lookup

Die Tabelle rampid_lookup ist eine Ausgabetabelle, die RampIDs für jedes Segment im Eingabedatensatz enthält. LiveRamp lässt es von vornherein nicht zu, RampIDs einzelnen Datensätzen zuzuordnen.

Spalte Datentyp Beschreibung
segment_name STRING Segmentname aus der Eingabetabelle.
ramp_id STRING LiveRamp-RampID
Aufzeichnungsstempel TIMESTAMP Zeitstempel für den Zeitpunkt, zu dem diese RampID-Suche durchgeführt wurde.

LiveRamp-RampIDs können sich im Laufe der Zeit ändern, auch für dieselbe Person. Das bedeutet, dass Sie gelegentlich eine neue Suche nach bereits verarbeiteten Daten durchführen müssen. Das Cortex Framework enthält ein Beispielskript ddls/samples/clean_up_segment_matching.sql, das zeigt, wie Sie das auf Segmentebene tun können. So können Sie ein ganzes Segment zurücksetzen. Das System führt dann eine Suche für dieses Segment durch und gibt Ihnen aktuelle RampIDs zurück.

Die rampid_lookup (Ausgabetabelle) enthält möglicherweise etwas weniger Datensätze als die Eingabetabelle. Das ist so vorgesehen, da Cortex Framework versucht, die Eingabe-Datensätze mithilfe von personenbezogenen Daten zu debuggen, um sicherzustellen, dass die LiveRamp API-Suche nicht fehlschlägt.

Kontoauthentifizierung

  1. Wenden Sie sich an LiveRamp, um Anmeldedaten für die Authentifizierung zu erhalten. Dazu gehören die Client-ID und der Clientschlüssel.

  2. Erstellen Sie mit Secret Manager ein Secret mit dem Namen cortex-framework-liveramp und verwenden Sie den folgenden Wert. Eine Anleitung finden Sie in der Secret Manager-Dokumentation.

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

    Ersetzen Sie Folgendes:

    • Ersetzen Sie CLIENT_ID durch die Client-ID aus Schritt 1.
    • Ersetzen Sie CLIENT_SECRET durch den Clientschlüssel aus Schritt 1.

Managed Airflow-Verbindungen

Erstellen Sie die folgenden Verbindungen in Managed Airflow. Weitere Informationen finden Sie in der Dokumentation zum Verwalten von Airflow-Verbindungen.

Verbindungsname Purpose
liveramp_cdc_bq LiveRamp API > CDC-Dataset-Übertragung

Konfiguration

Die Datei config.ini steuert das Verhalten des Managed Airflow-DAG sowie die Verwendung von LiveRamp-APIs. Konfigurieren Sie die Datei LiveRamp/src/pipelines/config.ini entsprechend Ihren Anforderungen. Diese Parameter werden zwar bereits in der Datei beschrieben, aber achten Sie auf liveramp_api_base_url. Dieser Parameter verweist standardmäßig auf die Produktions-API-URL von LiveRamp. Für Testzwecke müssen Sie ihn je nach Einrichtung möglicherweise auf die Staging-Version verweisen.

Nächste Schritte