Beta

(Beta) Verwenden von berechneten Feldern, um Arrays in flache Schemadateien zu exportieren

Erfahren Sie, wie Sie Arrays über berechnete Felder aus Real-Time CDP in flachen Schemadateien nach exportieren. Cloud-Speicher-Ziele. Lesen Sie dieses Dokument, um die durch diese Funktion aktivierten Anwendungsfälle zu verstehen.

Erhalten Sie umfassende Informationen zu berechneten Feldern - was diese sind und warum sie wichtig sind. Auf den unten verlinkten Seiten erhalten Sie eine Einführung in berechnete Felder in der Datenvorbereitung sowie weitere Informationen zu allen verfügbaren Funktionen:

• Benutzerhandbuch und Übersicht
• Funktionen zur Datenvorbereitung

Arrays und andere Objekttypen in Platform

Unter Experience Platform können Sie XDM-Schemata zur Verwaltung verschiedener Feldtypen. Zuvor war es Ihnen möglich, einfache Schlüssel-Wert-Paar-Felder wie Zeichenfolgen aus dem Experience Platform in Ihre gewünschten Ziele zu 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 im Experience Platform umfassen Array-Felder. Mehr dazu Verwalten von Array-Feldern in der Experience Platform-Benutzeroberfläche. Zusätzlich zu den zuvor unterstützten Feldtypen können Sie nun Array-Objekte exportieren, z. B.: organizations:[marketing, sales, engineering]. Siehe weiter unten ausführliche Beispiele wie Sie verschiedene Funktionen verwenden können, um auf Elemente von Arrays zuzugreifen, Array-Elemente in einer Zeichenfolge zu verknüpfen und mehr.

Bekannte Einschränkungen

Beachten Sie die folgenden bekannten Einschränkungen für die Beta-Version dieser Funktion:

• Der Export in JSON- oder Parquet-Dateien mit hierarchischen Schemata wird derzeit nicht unterstützt. Sie können Arrays nur in CSV-, JSON- und Parquet-Dateien mit flachen Schemas exportieren.
• Zu diesem Zeitpunkt Sie können nur einfache Arrays (oder Arrays mit primitiven Werten) in Cloud-Speicher-Ziele exportieren.. Dies bedeutet, dass Sie Array-Objekte exportieren können, die string-, int- oder boolesche Werte enthalten. Sie können keine Maps oder Arrays von Maps oder Objekten exportieren. Das modale Fenster der berechneten Felder zeigt nur die Arrays an, die Sie exportieren können.

Voraussetzungen

Verbinden zu einem gewünschten Cloud-Speicher-Ziel gelangen, indem Sie durch die Aktivierungsschritte für Cloud-Speicher-Ziele und gehen Sie zu Mapping Schritt.

Berechnete Felder exportieren

Wählen Sie im Zuordnungsschritt des Aktivierungs-Workflows für Cloud-Speicher-Ziele die Option (Beta) Berechnetes Feld hinzufügen.

Dadurch wird ein modales Fenster geöffnet, in dem Sie Attribute auswählen können, die Sie zum Exportieren von Attributen aus Experience Platform verwenden können.

Verwenden Sie beispielsweise die join -Funktion auf der loyaltyID wie unten gezeigt, um ein Array von Treueprogramm-IDs als Zeichenfolge zu exportieren, die mit einem Unterstrich in einer CSV-Datei verkettet ist. Ansicht Weitere Informationen hierzu und weitere Beispiele weiter unten.

Auswählen Speichern um das berechnete Feld beizubehalten und zum Zuordnungsschritt zurückzukehren.

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

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

Unterstützte -Funktionen

Beachten Sie, dass in der Beta-Version der berechneten Felder und der Array-Unterstützung für Ziele nur die folgenden Funktionen unterstützt werden:

• join
• coalesce
• size_of
• iif
• index-based array access
• add_to_array
• to_array
• first
• last
• sha256
• md5

Beispiele für Funktionen zum Exportieren von Arrays

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

join Funktion zum Exportieren von Arrays

Verwenden Sie die join -Funktion zum Verketten der Elemente eines Arrays in einer Zeichenfolge mithilfe eines gewünschten Trennzeichens, z. B. _ oder |.

Sie können beispielsweise die folgenden XDM-Felder wie im Screenshot der Zuordnung gezeigt kombinieren, indem Sie eine join('_',loyalty.loyaltyID) Syntax:

• "organizations": ["Marketing","Sales,"Finance"] array
• person.name.firstName Zeichenfolge
• person.name.lastName Zeichenfolge
• personalEmail.address Zeichenfolge

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie die drei Elemente des Arrays mithilfe der _ Zeichen.

`First_Name,Last_Name,Personal_Email,Organization
John,Doe,johndoe@acme.org, "Marketing_Sales_Finance"

iif Funktion zum Exportieren von Arrays

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

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

Verwenden Sie die add_to_array -Funktion, um einem exportierten Array Elemente hinzuzufügen. Sie können diese Funktion mit dem join weiter oben beschrieben.

Fortfahren mit der organizations Array-Objekt von oben können Sie eine Funktion wie source: join('_', add_to_array(organizations,"2023"))zurück und gibt die Organisationen zurück, 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 der _ -Zeichen und 2023 werden auch am Ende der Zeichenfolge angehängt.

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

coalesce Funktion zum Exportieren von Arrays

Verwenden Sie die coalesce -Funktion, 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 wie im Screenshot der Zuordnung gezeigt kombinieren, indem Sie eine coalesce(subscriptions.hasPromotion) -Syntax, um die erste true von false -Wert im Array:

• "subscriptions.hasPromotion": [null, true, null, false, true] array
• person.name.firstName Zeichenfolge
• person.name.lastName Zeichenfolge
• personalEmail.address Zeichenfolge

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie die ersten Nicht-Null-Werte true -Wert im Array wird in die Datei exportiert.

First_Name,Last_Name,hasPromotion
John,Doe,true

size_of Funktion zum Exportieren von Arrays

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

Sie können beispielsweise die folgenden XDM-Felder wie im Screenshot der Zuordnung gezeigt kombinieren.

• "purchaseTime": ["1538097126","1569633126,"1601255526","1632791526","1664327526"] Array, das fünf separate Kaufzeiten durch den Kunden angibt
• personalEmail.address Zeichenfolge

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus. Beachten Sie, wie die zweite Spalte die Anzahl der Elemente im Array anzeigt, die der Anzahl der separaten Käufe des Kunden entsprechen.

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

Indexbasierter Array-Zugriff

Sie können auf einen Index eines Arrays zugreifen, um ein einzelnes Element aus dem Array zu exportieren. Beispielsweise ähnlich dem obigen Beispiel für die size_of verwenden, können Sie purchaseTime[0] das erste Element des Zeitstempels zu exportieren, purchaseTime[1] das zweite Element des Zeitstempels zu exportieren, purchaseTime[2] um das dritte Element des Zeitstempels zu exportieren usw.

In diesem Fall sieht Ihre Ausgabedatei wie folgt aus und exportiert den Kunden zum ersten Mal, wenn er einen Kauf tätigt:

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

first und last Funktionen zum Exportieren von Arrays

Verwenden Sie die first und last -Funktionen, um das erste oder letzte Element in ein Array zu exportieren. Beispiel: Fahren Sie mit dem purchaseTime -Array-Objekt mit mehreren Zeitstempeln aus den vorherigen Beispielen verwenden, können Sie diese 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 tätigt:

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

Hashfunktionen

Zusätzlich zu den spezifischen Funktionen für den Export von Arrays oder Elementen aus einem Array können Sie Hash-Funktionen für Hash-Attribute in den exportierten Dateien verwenden. Wenn Sie beispielsweise persönlich identifizierbare Informationen in Attributen haben, können Sie diese Felder beim Exportieren hash.

Sie können Zeichenfolgenwerte direkt hash, z. B. md5(personalEmail.address). Falls gewünscht, können Sie auch einzelne Elemente von Array-Feldern hashen, vorausgesetzt, die Elemente im Array sind Zeichenfolgen wie folgt: md5(purchaseTime[0])

Folgende Hashing-Funktionen werden unterstützt: