Dokumentation Experience Platform Zielhandbuch

LiveRamp - Onboarding-Verbindung liveramp-onboarding

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Ziele

Erstellt für:

Admin
Benutzende

Verwenden Sie die Verbindung LiveRamp - Onboarding, um Zielgruppen von der Adobe Real-time Customer Data Platform in LiveRamp Connect zu integrieren.

Anwendungsfälle use-cases

Damit Sie besser verstehen können, wie und wann Sie das LiveRamp - Onboarding-Ziel verwenden sollten, finden Sie hier ein Anwendungsbeispiel, das für Kundinnen und Kunden von Adobe Experience Platform mit diesem Ziel geeignet ist.

Als Marketer möchte ich Zielgruppen von Adobe Experience Platform senden, um Identitäten in LiveRamp Connect zu integrieren, damit ich Benutzende auf mobilen, offenen Web-, sozialen und CTV-Plattformen unter Verwendung der Ramp ID-Kennung ansprechen kann.

Voraussetzungen prerequisites

Die LiveRamp - Onboarding-Verbindung exportiert Dateien mithilfe des LiveRamp-SFTP-Speichers.

Um Daten von Experience Platform an LiveRamp - Onboarding senden zu können, benötigen Sie LiveRamp-Anmeldedaten. Wenden Sie sich an den für Sie zuständigen LiveRamp-Mitarbeiter bzw. -Mitarbeiterin, um Ihre Anmeldedaten zu beziehen, falls Sie noch nicht über diese verfügen.

Unterstützte Identitäten supported-identities

LiveRamp - Onboarding unterstützt die Aktivierung von Identitäten wie PII-basierten Kennungen, bekannten Kennungen und benutzerdefinierten IDs, die in der offiziellen LiveRamp-Dokumentation beschrieben werden.

Im Zuordnungsschritt des Aktivierungs-Workflows müssen Sie die Zielzuordnungen als benutzerdefinierte Attribute definieren.

Unterstützte Zielgruppen supported-audiences

In diesem Abschnitt wird beschrieben, welche Arten von Zielgruppen Sie an dieses Ziel exportieren können.

Zielgruppenherkunft

Unterstützt

Beschreibung

Segmentation Service

✓

Zielgruppen, die über den Experience Platform (-Service) generiert.

Benutzerdefinierte Uploads

✓

Zielgruppen, die aus CSV-Dateien in Experience Platform importiert werden.

Exporttyp und -häufigkeit export-type-frequency

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Element

Typ

Anmerkungen

Exporttyp

Zielgruppenexport

Sie exportieren alle Mitglieder einer Zielgruppe mit den IDs (Name, Telefonnummer oder sonstiges), die im LiveRamp - Onboarding-Ziel verwendet werden.

Exporthäufigkeit

Täglicher Batch

Da Profile in Experience Platform auf der Grundlage einer Zielgruppenbewertung aktualisiert werden, werden die Profile (Identitäten) einmal täglich nachgelagert auf der Zielplattform aktualisiert. Weitere Informationen finden Sie unter Batch-Datei-basierte Ziele.

Herstellen einer Verbindung mit dem Ziel connect

IMPORTANT

Um eine Verbindung mit dem Ziel herzustellen, benötigen Sie Ziele anzeigen und Ziele verwalten Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Workflow zum Konfigurieren des Ziels die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.

Beim Ziel authentifizieren authenticate

Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder aus und wählen Sie Mit Ziel verbinden aus.

SFTP-Authentifizierung mit Passwort

Beispiel-Screenshot, der zeigt, wie eine Authentifizierung beim Ziel mithilfe von SFTP mit Passwort erfolgt

Port: Der für Ihren LiveRamp - Onboarding Speicherort verwendete Port. Verwenden Sie den Port, der Ihrem geografischen Standort entspricht, wie unten beschrieben:
- NA: Port-22 verwenden
- AU: Port-2222 verwenden
Benutzername: Der Benutzername für Ihren LiveRamp - Onboarding-Speicherort.
Passwort: Das Passwort für Ihren LiveRamp - Onboarding-Speicherort.
PGP/GPG-Verschlüsselungsschlüssel: Optional können Sie Ihren RSA-formatierten öffentlichen Schlüssel anhängen, um Ihre exportierten Dateien zu verschlüsseln. Ein Beispiel für einen korrekt formatierten Verschlüsselungsschlüssel finden Sie in der folgenden Abbildung.
Unterschlüssel-ID: Wenn Sie einen Verschlüsselungsschlüssel angeben, müssen Sie für die Verschlüsselung auch eine Unterschlüssel-ID angeben. Informationen zum Abrufen der Unterschlüssel-ID finden Sie in der LiveRamp Verschlüsselungsdokumentation.

SFTP mit SSH-Schlüsselauthentifizierung

Beispiel-Screenshot, der zeigt, wie eine Authentifizierung beim Ziel mithilfe eines SSH-Schlüssels erfolgt

Port: Der für Ihren LiveRamp - Onboarding Speicherort verwendete Port. Verwenden Sie den Port, der Ihrem geografischen Standort entspricht, wie unten beschrieben:
- EU: Verwenden Sie Port 4222
Benutzername: Der Benutzername für Ihren LiveRamp - Onboarding-Speicherort.
SSH-Schlüssel: Der private SSH-Schlüssel für die Anmeldung bei Ihrem LiveRamp - Onboarding-Speicherort. Der private Schlüssel muss als eine Base64-verschlüsselte Zeichenfolge formatiert sein und darf nicht passwortgeschützt sein.
- Um Ihren SSH-Schlüssel mit dem LiveRamp - Onboarding-Server zu verbinden, müssen Sie ein Ticket über das LiveRamp-Portal für technischen Support einreichen und Ihren öffentlichen Schlüssel bereitstellen. Weitere Informationen finden Sie in der LiveRamp-Dokumentation.
PGP/GPG-Verschlüsselungsschlüssel: Optional können Sie Ihren RSA-formatierten öffentlichen Schlüssel anhängen, um Ihre exportierten Dateien zu verschlüsseln. Ein Beispiel für einen korrekt formatierten Verschlüsselungsschlüssel finden Sie in der folgenden Abbildung.
Unterschlüssel-ID: Wenn Sie einen Verschlüsselungsschlüssel angeben, müssen Sie für die Verschlüsselung auch eine Unterschlüssel-ID angeben. Informationen zum Abrufen der Unterschlüssel-ID finden Sie in der LiveRamp Verschlüsselungsdokumentation.

Ausfüllen der Zieldetails destination-details

Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.

Screenshot der Platform-Benutzeroberfläche mit Informationen zum Ausfüllen von Details für Ihr Ziel

Name: Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
Beschreibung: Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.
Region: Geografische Region für Ihre Instanz des LiveRamp-SFTP-Speichers.
Ordnerpfad: Der Pfad zum LiveRamp uploads-Unterordner, in dem die exportierten Dateien gespeichert werden. Das Präfix uploads wird automatisch zum Ordnerpfad hinzugefügt. LiveRamp empfiehlt die Erstellung eines dedizierten Unterordners für Sendungen aus Adobe Real-Time CDP, um die Dateien von anderen vorhandenen Feeds getrennt zu halten und eine reibungslose Ausführung aller Automatisierungen zu gewährleisten.
- Wenn Sie beispielsweise Ihre Dateien nach uploads/my_export_folder exportieren möchten, geben Sie my_export_folder in das Feld Ordnerpfad ein.
Komprimierungsformat: Wählen Sie den Komprimierungstyp aus, den Experience Platform für die exportierten Dateien verwenden soll. Verfügbare Optionen sind GZIP oder Keines.

Aktivieren von Warnhinweisen enable-alerts

Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Warnhinweisen zu Zielen über die Benutzeroberfläche.

Wenn Sie alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.

Aktivieren von Zielgruppen für dieses Ziel activate

IMPORTANT

Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen Zugriffssteuerung. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.

Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Zielgruppendaten für Batch-Profil-Exportziele.

Planung scheduling

Erstellen Sie im Planungsschritt für jede Zielgruppe einen Exportzeitplan mit den unten aufgeführten Einstellungen.

Dateiexportoptionen: Exportieren Sie vollständige Dateien. Inkrementelle Dateiexporte werden derzeit nicht für das LiveRamp-Ziel unterstützt.
Häufigkeit: Täglich
Datum: Wählen Sie die gewünschten Start- und Endzeiten für den Export aus.

Screenshot der Platform-Benutzeroberfläche mit dem Schritt zur Zielgruppenplanung.

Der Name der exportierten Datei kann derzeit nicht benutzerseitig konfiguriert werden. Alle an das LiveRamp - Onboarding-Ziel exportierten Dateien werden automatisch anhand der folgenden Vorlage benannt:

%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%

Screenshot der Platform-Benutzeroberfläche mit der Namensvorlage für exportierte Dateien.

Beispielsweise könnte der Name einer exportierten Datei für eine Organisation mit dem Namen Luma in etwa wie folgt aussehen:

Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv

Zuordnen von Attributen und Identitäten map

Im Zuordnungsschritt können Sie auswählen, welche Attribute und Identitäten für Ihre Profile exportiert werden sollen.

IMPORTANT

Dieses Ziel unterstützt die Aktivierung eines Quell-Identity-Namespace pro Aktivierungsfluss. Wenn Sie mehrere Identity-Namespaces exportieren müssen, z. B. Email und Phone, müssen Sie für jede Identität einen separaten Aktivierungsfluss erstellen.

Im Zuordnungsschritt definiert die Zielfeld-Zuordnung den Namen der Spaltenüberschrift in der exportierten CSV-Datei. Sie können die CSV-Spaltenüberschriften in der exportierten Datei in einen beliebigen Anzeigenamen ändern, indem Sie einen benutzerdefinierten Namen für das Zielfeld angeben.

IMPORTANT

Bei Änderungen an den Zielfeldern nach der ersten Datenübermittlung an LiveRamp benachrichtigen Sie bitte Ihr Konto-Team LiveRamp oder senden Sie ein Ticket an den LiveRamp-Support, damit die Änderungen im Automatisierungsprozess berücksichtigt werden.

Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen und dann das XDM-Attribut aus, das Sie zuordnen möchten, oder wählen Sie die Kategorie Identity-Namespace auswählen und dann eine Identität aus, die Ihrem Ziel zugeordnet werden soll.
Geben Sie im Fenster Zielfeld auswählen den Attributnamen ein, dem Sie das ausgewählte Quellfeld zuordnen möchten. Der hier definierte Attributname spiegelt sich in der exportierten CSV-Datei als Spaltenüberschrift wider.

Sie können den Attributnamen auch direkt in das Zielfeld eingeben.

Wählen Sie nach dem Hinzufügen aller gewünschten Zuordnungen die Option Weiter aus und beenden Sie den Aktivierungs-Workflow.

Exportierte Daten/Datenexport validieren exported-data

Ihre Daten werden an den von Ihnen konfigurierten LiveRamp - Onboarding-Speicherort als CSV-Dateien exportiert.

Exportierte Dateien haben eine maximale Größe von 10 Millionen Zeilen. Experience Platform generiert mehrere Dateien pro Versand, wenn die ausgewählten Zielgruppen 10 Millionen Zeilen überschreiten. Wenn Sie erwarten, dass das Limit für einzelne Dateien überschritten wird, wenden Sie sich an Ihren LiveRamp und bitten Sie ihn, die Batch-Aufnahme für Sie zu konfigurieren.

Beim Exportieren von Dateien an das LiveRamp - Onboarding-Ziel generiert Platform eine CSV-Datei für jede Zusammenführungsrichtlinien-ID.

Betrachten wir beispielsweise folgende Zielgruppen:

Zielgruppe A (Zusammenführungsrichtlinie 1)
Zielgruppe B (Zusammenführungsrichtlinie 2)
Zielgruppe C (Zusammenführungsrichtlinie 1)
Zielgruppe D (Zusammenführungsrichtlinie 1)

Platform exportiert zwei CSV-Dateien nach LiveRamp - Onboarding:

Eine CSV-Datei mit den Zielgruppen A, C und D;
Eine CSV-Datei, die Zielgruppe B enthält.

Exportierte CSV-Dateien enthalten Profile mit den ausgewählten Attributen und dem entsprechenden Zielgruppenstatus in separaten Spalten, mit dem Attributnamen und audience_namespace:audience_ID-Paaren als Spaltenüberschriften, wie im folgenden Beispiel gezeigt:

ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X

Die in den exportierten Dateien enthaltenen Profile können mit einem der folgenden Zielgruppenqualifikationsstatus übereinstimmen:

Active: Das Profil ist derzeit für die Zielgruppe qualifiziert.
Expired: Das Profil ist nicht mehr für die Zielgruppe qualifiziert, war jedoch in der Vergangenheit qualifiziert.
""(leere Zeichenfolge): Das Profil war nie für die Zielgruppe qualifiziert.

Eine exportierte CSV-Datei mit einem email-Attribut, zwei Zielgruppen, die vom Segmentierungs-Service von Experience Platform stammen, und einer importierten externen Zielgruppe könnte zum Beispiel so aussehen:

email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,

Im obigen Beispiel beschreiben die Abschnitte ups_aa2e3d98-974b-4f8b-9507-59f65b6442df und ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f Zielgruppen, die vom Segmentierungs-Service stammen, während CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e eine Zielgruppe beschreibt, die als benutzerdefinierter Upload in die Plattform importiert wurde.

Da Platform für jede Zusammenführungsrichtlinien-ID eine CSV-Datei generiert, wird auch eine separate Datenflussausführung für jede Zusammenführungsrichtlinien-ID erzeugt.

Das bedeutet, dass die Metriken Aktivierte Identitäten und Empfangene Profile auf der Seite mit den Datenflussausführungen für jede Gruppe von Zielgruppen aggregiert werden, die dieselbe Zusammenführungsrichtlinie verwenden, anstatt für jede Zielgruppe angezeigt zu werden.

Infolge der generierten Datenflussausführungen für eine Gruppe von Zielgruppen, die dieselbe Zusammenführungsrichtlinie verwenden, werden die Zielgruppennamen nicht im Monitoring-Dashboard angezeigt.

Screenshot der Experience Platform-Benutzeroberfläche mit der Metrik „Aktivierte Identitäten“.

Hochladen exportierter Daten nach LiveRamp upload-to-liveramp

Nach dem erfolgreichen Export Ihrer Daten in den LiveRamp - Onboarding-Speicher müssen Sie die Daten in die LiveRamp-Plattform hochladen.

Weitere Informationen zum Hochladen Ihrer Dateien aus dem LiveRamp - Onboarding-Speicher in eine LiveRamp-Zielgruppe finden Sie in der Dokumentation mit Hinweisen zum Hochladen der ersten Datei in eine Zielgruppe.

Datennutzung und -Governance data-usage-governance

Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Ausführliche Informationen darüber, wie Adobe Experience Platform Data Governance erzwingt, finden Sie unter Data Governance - Übersicht.

Zusätzliche Ressourcen additional-resources

Weitere Einzelheiten zur Konfiguration Ihres LiveRamp - Onboarding-Speichers finden Sie in der offiziellen Dokumentation.

Änderungsprotokoll changelog

In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.

Änderungsprotokoll anzeigen

table 0-row-3 1-row-3 2-row-3 layout-auto
Veröffentlichungsmonat	Art der Aktualisierung	Beschreibung
März 2024	Funktions- und Dokumentationsaktualisierung	Es wurde Unterstützung für Sendungen nach Europa und Australien LiveRamp SFTP Instanzen hinzugefügt. Die Dokumentation wurde aktualisiert, um spezifische Konfigurationen für neu unterstützte Regionen zu beschreiben. Maximale Dateigröße wurde auf 10 Millionen Zeilen erhöht (von zuvor 5 Millionen). Die Dokumentation wurde aktualisiert, um höhere Dateigrößen widerzuspiegeln.
Juli 2023	Erstmalige Veröffentlichung	Ursprüngliche Zielversion und Dokumentation veröffentlicht.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6