Exportieren von Array-Objekten aus Real-Time CDP in Cloud-Speicherziele 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.

Arrays müssen derzeit mithilfe der array_to_string-Funktion als Zeichenfolgen exportiert werden.

Um Arrays zu exportieren, müssen Sie die Funktion „Berechnete Felder“ im Zuordnungsschritt des Export-Workflows verwenden (es denn, Sie exportieren einzelnen Elemente eines Arrays. Ausführliche Informationen zu berechneten Feldern finden Sie auf den unten verlinkten Seiten. Dazu gehören eine Einführung in berechnete Felder in die Datenvorbereitung und weitere Informationen zu allen verfügbaren Funktionen:

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

Beim 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 in 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. Zusätzlich zu den zuvor unterstützten Feldtypen können Sie jetzt Array-Objekte wie das folgende Beispiel exportieren, die mithilfe der array_to_string-Funktion zu einer Zeichenfolge verkettet werden.

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.

Bekannte Einschränkungen known-limitations

Beachten Sie die folgenden bekannten Einschränkungen, die derzeit für diese Funktion gelten:

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.

Exportieren berechneter Felder how-to-export-calculated-fields

Wählen Sie im Zuordnungsschritt des Aktivierungs-Workflows für Cloud-Speicher-Ziele Berechnetes Feld hinzufügen aus.

Dadurch wird ein modales Fenster geöffnet, in dem Sie Funktionen und Felder auswählen können, um Attribute aus dem Experience Platform zu exportieren.

Verwenden Sie beispielsweise die Funktion array_to_string im Feld organizations wie unten gezeigt, um das Organisations-Array als Zeichenfolge in eine CSV-Datei zu exportieren. Sehen Sie weitere Informationen hierzu und weitere Beispiele weiter unten.

Wählen Sie Speichern aus, um das berechnete Feld beizubehalten und zum Zuordnungsschritt zurückzukehren.

Füllen Sie im Zuordnungsschritt des Workflows das Feld Zielfeld mit dem Wert der Spaltenüberschrift aus, die Sie für dieses Feld in den exportierten Dateien anzeigen möchten.

Wenn Sie bereit sind wählen Sie Weiter) aus, um mit dem nächsten Schritt des Aktivierungs-Workflows fortzufahren.

Beispiele für unterstützte Funktionen zum Exportieren von Arrays supported-functions

Alle dokumentierten Datenvorbereitungsfunktionen werden beim Aktivieren von Daten für dateibasierte Ziele unterstützt.

Die folgenden Funktionen, die speziell für die Handhabung von Arrays gelten, werden zusammen mit Beispielen dokumentiert.

Beispiele für Funktionen zum Exportieren von Arrays examples

In den folgenden Abschnitten finden Sie Beispiele und weitere Informationen zu einigen der oben aufgeführten Funktionen. Die übrigen aufgelisteten Funktionen finden Sie in der Dokumentation zu allgemeinen Funktionen im Abschnitt Datenvorbereitung.

array_to_string Funktion zum Exportieren von Arrays array-to-string-function-export-arrays

Verwenden Sie die Funktion array_to_string , um die Elemente eines Arrays mithilfe eines gewünschten Trennzeichens wie _ oder | zu einer Zeichenfolge zu verketten.

Sie können beispielsweise die folgenden XDM-Felder wie im Screenshot zur Zuordnung gezeigt unter Verwendung einer array_to_string('_',organizations) Syntax kombinieren:

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus: Beachten Sie, wie die Elemente des Arrays mithilfe des _-Zeichens zu einer einzigen Zeichenfolge verkettet werden.

First_Name,Last_Name,Personal_Email,Organization
John,Doe,johndoe@acme.org, "{'id':123,'orgName':'Acme Inc','founded':1990,'latestInteraction':1708041600000}_{'id':456,'orgName':'Superstar Inc','founded':2004,'latestInteraction':1692921600000}_{'id':789,'orgName':'Energy Corp','founded':2021,'latestInteraction':1725753600000}"

filterArray Funktion zum Exportieren gefilterter Arrays

Verwenden Sie die Funktion filterArray zum Filtern der Elemente eines exportierten Arrays. Sie können diese Funktion mit der weiter oben beschriebenen array_to_string kombinieren.

Wenn Sie mit dem organizations Array-Objekt von oben fortfahren, können Sie eine Funktion wie array_to_string('_', filterArray(organizations, org -> org.founded > 2021)) schreiben, wodurch die Organisationen mit einem Wert für founded im Jahr 2021 oder neuer zurückgegeben werden.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus: Beachten Sie, wie die beiden Elemente des Arrays, die das Kriterium erfüllen, mithilfe des _-Zeichens zu einer einzigen Zeichenfolge verkettet werden.

John,Doe,johndoe@acme.org, "{'id':123,'orgName':'Acme Inc','founded':1990,'latestInteraction':1708041600000}_{'id':789,'orgName':'Energy Corp','founded':2021,'latestInteraction':1725753600000}"

transformArray Funktion zum Exportieren transformierter Arrays

Verwenden Sie die Funktion transformArray , um die Elemente eines exportierten Arrays zu transformieren. Sie können diese Funktion mit der weiter oben beschriebenen array_to_string kombinieren.

Wenn Sie mit dem organizations Array-Objekt von oben fortfahren, können Sie eine Funktion wie array_to_string('_', transformArray(organizations, org -> ucase(org.orgName))) schreiben und die Namen der in Großbuchstaben konvertierten Organisationen zurückgeben.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus: Beachten Sie, wie die drei Elemente des Arrays mithilfe des _-Zeichens transformiert und in eine einzelne Zeichenfolge verkettet werden.

John,Doe,johndoe@acme.org,ACME INC_SUPERSTAR INC_ENERGY CORP

iif Funktion zum Exportieren von Arrays iif-function-export-arrays

Verwenden Sie die Funktion iif , um Elemente eines Arrays unter bestimmten Bedingungen zu exportieren. Wenn Sie beispielsweise von oben mit dem organizations Array-Objekt fortfahren, können Sie eine einfache bedingte Funktion wie iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing") schreiben.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus: In diesem Fall ist das erste Element des Arrays Marketing , sodass die Person Mitglied der Marketing-Abteilung ist.

`First_Name,Last_Name, Personal_Email, Is_Member_Of_Marketing_Dept
John,Doe, johndoe@acme.org, "isMarketing"

add_to_array Funktion zum Exportieren von Arrays add-to-array-function-export-arrays

Verwenden Sie die Funktion add_to_array , um einem exportierten Array Elemente hinzuzufügen. Sie können diese Funktion mit der weiter oben beschriebenen array_to_string kombinieren.

Wenn Sie mit dem organizations Array-Objekt von oben fortfahren, können Sie eine Funktion wie source: array_to_string('_', add_to_array(organizations,"2023")) schreiben und die Organisationen zurückgeben, denen eine Person im Jahr 2023 angehört.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus: Beachten Sie, wie die drei Elemente des Arrays mithilfe des _-Zeichens zu einer einzigen Zeichenfolge verkettet werden und 2023 ebenfalls am Ende der Zeichenfolge angehängt wird.

`First_Name,Last_Name,Personal_Email,Organization_Member_2023
John,Doe, johndoe@acme.org,"Marketing_Sales_Finance_2023"

flattenArray Funktion zum Exportieren von reduzierten Arrays

Verwenden Sie die Funktion flattenArray , um ein exportiertes multidimensionales Array zu reduzieren. Sie können diese Funktion mit der weiter oben beschriebenen array_to_string kombinieren.

Wenn Sie mit dem organizations Array-Objekt von oben fortfahren, können Sie eine Funktion wie array_to_string('_', flattenArray(organizations)) schreiben. Beachten Sie, dass die Funktion array_to_string das Eingabe-Array standardmäßig in eine Zeichenfolge reduziert.

Die resultierende Ausgabe ist die gleiche wie für die weiter oben beschriebene array_to_string.

coalesce Funktion zum Exportieren von Arrays coalesce-function-export-arrays

Verwenden Sie die Funktion coalesce , um auf das erste Element eines Arrays, das nicht null ist, zuzugreifen und es in eine Zeichenfolge zu exportieren.

Sie können beispielsweise die folgenden XDM-Felder kombinieren, wie im Screenshot der Zuordnung gezeigt, indem Sie eine coalesce(subscriptions.hasPromotion) Syntax verwenden, um die erste true false Werts im Array zurückzugeben:

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus: Beachten Sie, wie der erste true ungleich null im -Array in die Datei exportiert wird.

First_Name,Last_Name,hasPromotion
John,Doe,true

size_of Funktion zum Exportieren von Arrays sizeof-function-export-arrays

Verwenden Sie die Funktion size_of , um anzugeben, wie viele Elemente in einem Array vorhanden sind. Wenn Sie beispielsweise über ein purchaseTime Array-Objekt mit mehreren Zeitstempeln verfügen, können Sie die size_of-Funktion verwenden, um anzugeben, wie viele separate Käufe von einer Person getätigt wurden.

Sie können beispielsweise die folgenden XDM-Felder unten kombinieren, wie im Screenshot zur Zuordnung dargestellt.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus: Beachten Sie, dass in der zweiten Spalte die Anzahl der Elemente im Array angegeben ist, die der Anzahl der separaten Käufe entspricht, die vom Kunden getätigt wurden.

`Personal_Email,Times_Purchased
johndoe@acme.org,"5"

Indexbasierter Array-Zugriff index-based-array-access

Sie können auf einen Index eines Arrays zugreifen, um ein einzelnes Element aus dem Array zu exportieren. Beispiel: Wenn Sie ähnlich wie im obigen Beispiel für die Funktion size_of nur beim ersten Kauf eines bestimmten Produkts auf zugreifen und es exportieren möchten, können Sie purchaseTime[0] verwenden, um das erste Element des Zeitstempels zu exportieren, purchaseTime[1] das zweite Element des Zeitstempels zu exportieren, purchaseTime[2] das dritte Element des Zeitstempels zu exportieren usw.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus und exportiert das erste Mal, dass der Kunde einen Kauf getätigt hat:

`Personal_Email,First_Purchase
johndoe@acme.org,"1538097126"

first und last Funktionen zum Exportieren von Arrays first-and-last-functions-export-arrays

Verwenden Sie die Funktionen first und last zum Exportieren des ersten oder letzten Elements in einem Array. Wenn Sie beispielsweise mit dem purchaseTime Array-Objekt mit mehreren Zeitstempeln aus den vorherigen Beispielen fortfahren, können Sie diese Funktionen verwenden, um die erste oder letzte von einer Person getätigte Kaufzeit zu exportieren.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus und exportiert das erste und letzte Mal, dass der Kunde einen Kauf getätigt hat:

`Personal_Email,First_Purchase, Last_Purchase
johndoe@acme.org,"1538097126","1664327526"