Exportieren von Arrays, Zuordnungen und Objekten aus Real-Time CDP in Cloud-Speicher-Ziele export-arrays-cloud-storage

Erfahren Sie, wie Sie Arrays aus Real-Time CDP in Cloud-Speicherziele exportieren. Lesen Sie dieses Dokument, um den Export-Workflow, die durch diese Funktion aktivierten Anwendungsfälle und die bekannten Einschränkungen zu verstehen.

Auf dieser Seite finden Sie alle Informationen zum Exportieren von Arrays, Karten und anderen Objekttypen aus Experience Platform.

Grundlinie vorne

Die wichtigsten Informationen zur Funktionalität finden Sie in diesem Abschnitt und weiter unten in den anderen Abschnitten des Dokuments, um detaillierte Informationen zu erhalten.

Arrays und andere Objekttypen in Platform arrays-strings-other-objects

In Experience Platform können Sie XDM-Schemata verwenden, um verschiedene Feldtypen zu verwalten. Bevor die Unterstützung für Array-Exporte hinzugefügt wurde, konnten Sie einfache Schlüssel-Wert-Paarfelder wie Zeichenfolgen aus Experience Platform an Ihre gewünschten Ziele exportieren. Ein Beispiel für ein solches Feld, das zuvor für den Export unterstützt wurde, ist personalEmail.address:johndoe@acme.org.

Andere Feldtypen in Experience Platform umfassen Array-Felder. Lesen Sie mehr über Verwalten von Array-Feldern in der Experience Platform-Benutzeroberfläche. Sie können jetzt Array-Objekte wie im folgenden Beispiel exportieren.

organizations = [{
  id: 123,
  orgName: "Acme Inc",
  founded: 1990,
  latestInteraction: "2024-02-16"
}, {
  id: 456,
  orgName: "Superstar Inc",
  founded: 2004,
  latestInteraction: "2023-08-25"
}, {
  id: 789,
  orgName: 'Energy Corp',
  founded: 2021,
  latestInteraction: "2024-09-08"
}]

Siehe weiter unten ausführliche Beispiele wie Sie verschiedene Funktionen verwenden können, um auf Elemente von Arrays zuzugreifen, Arrays umzuwandeln und zu filtern, Array-Elemente in eine Zeichenfolge zu verknüpfen und vieles mehr.

Zusätzlich zu Arrays können Sie auch Zuordnungen und Objekte aus Experience Platform in Ihr gewünschtes Cloud-Speicher-Ziel exportieren. Lesen Sie mehr über Karten und Objekte in Experience Platform.

Voraussetzungen prerequisites

Verbinden mit dem gewünschten Cloud-Speicher-Ziel, schreiten Sie durch die Aktivierungsschritte für Cloud-Speicher-Ziele und gelangen Sie zum Schritt Zuordnung. Beim Herstellen einer Verbindung zum gewünschten Cloud-Ziel müssen Sie den Umschalter Arrays exportieren, Karten, Objekte. Weitere Informationen finden Sie im folgenden Abschnitt.

Umschalter zum Exportieren von Arrays, Zuordnungen und Objekten export-arrays-maps-objects-toggle

Beim Herstellen einer Verbindung zu einem Cloud-Speicher-Ziel können Sie die Exportieren von Arrays, Karten, Objekten ein- oder ausschalten.

Schalten Sie diese Einstellung auf ein, um den Export von Arrays, Zuordnungen und Objekten in JSON- oder Parquet-Dateien zu aktivieren. Sie können diese Objekttypen in der Ansicht der Quellfelder des Zuordnungsschritts“ auswählen,Sie Zielgruppen für Cloud-Speicher-Ziele aktivieren. Wenn diese Einstellung jedoch aktiviert ist, können Sie die Option „Berechnete Felder“ nicht verwenden, um Daten bei Aktivierung umzuwandeln.

Wenn dieser Umschalter auf aus steht, können Sie die Option „Berechnete Felder“ verwenden und beim Aktivieren von Zielgruppen verschiedene Datenumwandlungsfunktionen anzuwenden. Sie können jedoch keine Arrays, Zuordnungen und Objekte in JSON- oder Parquet-Dateien exportieren und müssen dafür ein separates Ziel konfigurieren.

Arrays, Karten, Objekte exportieren ein export-arrays-maps-objects-toggle-on

Wenn diese Einstellung aktiviert ist, können Sie ganze Objekte (z. B. person.name) und Arrays exportieren, indem Sie sie im Zuordnungsschritt des Aktivierungs-Workflows über die Quellfeldauswahl auswählen.

Wenn diese Option aktiviert ist, verhindert die Benutzeroberfläche, dass Benutzer berechnete Felder verwenden, und das Steuerelement Berechnete Felder hinzufügen ist deaktiviert, wie unten dargestellt. Um berechnete Felder für Datenumwandlungen zu verwenden, richten Sie eine Zielverbindung ein, während Sie den Umschalter deaktivieren.

Arrays, Karten, Objekte exportieren aus export-arrays-maps-objects-toggle-off

Wenn diese Option auf Aus gesetzt ist, können Sie die Option Berechnete Felder verwenden und beim Aktivieren von Zielgruppen verschiedene Datenumwandlungsfunktionen anwenden. Sie können jedoch keine Arrays, Zuordnungen und Objekte in JSON- oder Parquet-Dateien exportieren und müssen dafür ein separates Ziel konfigurieren.

Sie können Arrays, Zuordnungen und Objekte mithilfe der Funktion „Berechnete Felder“ in CSV-Dateien exportieren und mithilfe der Funktion "array_to_string" zu einer Zeichenfolge verketten. Weitere InformationenVerwendung dieser Funktion.

Erfahren Sie mehr über die Arbeit mit berechneten Feldern, um Umwandlungen an Daten durchzuführen, die an Cloud-Speicherziele exportiert wurden.

Beispiele für exportierte Dateien sample-exported-files

Mithilfe dieser Funktion können Sie Parquet- und JSON-Dateien exportieren, wobei die Daten die Struktur aus Experience Platform beibehalten. Nachfolgend finden Sie ein Beispiel für eine exportierte JSON-Datei.

{
  "person_name_firstName": "John",
  "person_name_lastName": "Smith",
  "_acmeinc_customer_hs_main_address_scalar": "Oak Avenue No 12",
  "_acmeinc_customer_hs_locations_array": [
    "home address 12",
    "office address 12"
  ],
  "_acmeinc_customer_hs_date_array": [
    "2024-11-14",
    "2024-11-15"
  ],
  "_acmeinc_customer_hs_customer_obj_emails_array0": "john.smith@example.com",
  "_acmeinc_customer_hs_customer_obj": {
    "emails_array": [
      "john.smith@example.com",
      "j.smith@example.com"
    ],
    "name_scalar": "John Smith"
  },
  "_acmeinc_customer_hs_addresses_array_obj": [
    {
      "is_primary": true,
      "streetName_scalar": "Maple Street",
      "streetNo_int": 12
    },
    {
      "is_primary": false,
      "streetName_scalar": "Pine Road",
      "streetNo_int": 45
    }
  ],
  "_acmeinc_customer_hs_addresses_array_obj0": {
    "is_primary": true,
    "streetName_scalar": "Maple Street",
    "streetNo_int": 12
  }
}