LiveRamp - Onboarding-Verbindung liveramp-onboarding
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.
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.
Herstellen einer Verbindung mit dem Ziel connect
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 Connect to destination aus.
SFTP-Authentifizierung mit Passwort
-
Port: Der für Ihren LiveRamp - Onboarding Speicherort verwendete Port. Verwenden Sie den Port, der Ihrem geografischen Standort entspricht, wie unten beschrieben:
- NA: Port-
22verwenden - AU: Port-
2222verwenden
- NA: Port-
-
Username: Der Benutzername für Ihren LiveRamp - Onboarding Speicherort.
-
Password: Das Kennwort für Ihren LiveRamp - Onboarding Speicherort.
-
PGP/GPG encryption key: Optional können Sie Ihren RSA-formatierten öffentlichen Schlüssel anhängen, um Ihren exportierten Dateien eine Verschlüsselung hinzuzufügen. Ein Beispiel für einen korrekt formatierten Verschlüsselungsschlüssel finden Sie in der folgenden Abbildung.
-
Subkey ID:IfSie einen Verschlüsselungsschlüssel bereitstellen, müssen Sie auch einen Subkey IDangeben. Informationen zum Abrufen der Unterschlüssel-ID finden Sie in der LiveRamp Verschlüsselungsdokumentation.
SFTP mit SSH-Schlüsselauthentifizierung
-
Port: Der für Ihren LiveRamp - Onboarding Speicherort verwendete Port. Verwenden Sie den Port, der Ihrem geografischen Standort entspricht, wie unten beschrieben:
- EU: Port-
4222verwenden
- EU: Port-
-
Username: Der Benutzername für Ihren LiveRamp - Onboarding Speicherort.
-
SSH Key: Der private SSH, mit dem die Anmeldung bei Ihrem LiveRamp - Onboarding Speicherort erfolgt. 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 encryption key: Optional können Sie Ihren RSA-formatierten öffentlichen Schlüssel anhängen, um Ihren exportierten Dateien eine Verschlüsselung hinzuzufügen. Ein Beispiel für einen korrekt formatierten Verschlüsselungsschlüssel finden Sie in der folgenden Abbildung.
-
Subkey ID:IfSie einen Verschlüsselungsschlüssel bereitstellen, müssen Sie auch einen Subkey IDangeben. 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
- Name: Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
- Description: Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.
- Region: Geografische Region für Ihre Instanz des LiveRamp-SFTP-Speichers.
- Folder path: Der Pfad zum LiveRamp
uploadsUnterordner, in dem die exportierten Dateien gespeichert werden. Das Präfixuploadswird 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_folderexportieren möchten, geben Siemy_export_folderin das Feld Folder path ein.
- Wenn Sie beispielsweise Ihre Dateien nach
- Compression format: Wählen Sie den Komprimierungstyp aus, den Experience Platform für die exportierten Dateien verwenden soll. Verfügbare Optionen sind GZIP oder None.
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 mit dem Eingeben der Details für Ihre Zielverbindung fertig sind, wählen Sie Next aus.
Aktivieren von Zielgruppen für dieses Ziel activate
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 Scheduling Schritt für jede Audience einen Exportzeitplan mit den unten aufgeführten Einstellungen.
- File export options: Export full files. Inkrementelle Dateiexporte werden derzeit nicht für das LiveRamp-Ziel unterstützt.
- Frequency: Daily
- Date: Wählen Sie die Start- und Endzeiten für den Export wie gewünscht aus.
Screenshot der
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 Experience 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 Mapping Schritt können Sie auswählen, welche Attribute und Identitäten für Ihre Profile exportiert werden sollen.
Email und Phone, müssen Sie für jede Identität einen separaten Aktivierungsfluss erstellen.Im Mapping Schritt definiert die Target field-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 die Target field angeben.
-
Wählen Sie im Mapping Schritt Add new mapping aus. Auf dem Bildschirm wird eine neue Zuordnungszeile angezeigt.
-
Wählen Sie im Select source field die Kategorie Select attributes und dann das XDM-Attribut aus, das Sie zuordnen möchten, oder wählen Sie die Kategorie Select identity namespace und dann eine Identität aus, die Ihrem Ziel zugeordnet werden soll.
-
Geben Sie im Select target field 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 die Target field eingeben.
Nachdem Sie alle gewünschten Zuordnungen hinzugefügt haben, wählen Sie Next 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 Experience 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)
Experience 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 Zielgruppenqualifizierungsstatus ü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 in Experience Platform importiert .
Da Experience Platform eine CSV-Datei für jede Zusammenführungsrichtlinien-ID generiert, wird auch eine separate Datenflussausführung für jede Zusammenführungsrichtlinien-ID generiert.
Das bedeutet, dass die Identities activated- und Profiles received-Metriken auf Seite „Datenflussausführungen für jede Gruppe von Zielgruppen aggregiert werden, die dieselbe Zusammenführungsrichtlinie verwenden, und nicht für jede Zielgruppe angezeigt 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.
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.
| table 0-row-3 1-row-3 2-row-3 layout-auto | ||
|---|---|---|
| Veröffentlichungsmonat | Art der Aktualisierung | Beschreibung |
| März 2024 | Funktions- und Dokumentationsaktualisierung |
|
| Juli 2023 | Erstmalige Veröffentlichung | Ursprüngliche Zielversion und Dokumentation veröffentlicht. |