Exporter des objets de tableau de Real-Time CDP vers des destinations d’espace de stockage dans le cloud export-arrays-cloud-storage

Découvrez comment exporter des tableaux de Real-Time CDP vers des destinations de stockage dans le cloud. Lisez ce document pour comprendre le workflow d’exportation, les cas d’utilisation activés par cette fonctionnalité et les limites connues.

Les tableaux doivent actuellement être exportés sous forme de chaînes à l’aide de la fonction array_to_string .

Pour exporter des tableaux, vous devez utiliser la fonctionnalité de champs calculés à l’étape de mappage du workflow d’exportation, à moins que vous n’exportiez des éléments individuels d’un tableau. Pour plus d’informations sur les champs calculés, consultez les pages liées ci-dessous. Vous y trouverez une présentation des champs calculés dans la préparation des données et plus d’informations sur toutes les fonctions disponibles :

Tableaux et autres types d’objets dans Platform arrays-strings-other-objects

Dans Experience Platform, vous pouvez utiliser des schémas XDM pour gérer différents types de champs. Avant l’ajout de la prise en charge des exportations de tableaux, vous pouviez exporter des champs de type paire clé-valeur simples, tels que des chaînes, de manière Experience Platform vers les destinations souhaitées. personalEmail.address:johndoe@acme.org est un exemple de champ de ce type, précédemment pris en charge pour l’exportation.

D’autres types de champs dans l’Experience Platform incluent les champs de tableau. En savoir plus sur la gestion des champs de tableau dans l’interface utilisateur de l’Experience Platform. Outre les types de champ précédemment pris en charge, vous pouvez désormais exporter des objets de tableau tels que l’exemple ci-dessous, concaténés dans une chaîne à l’aide de la fonction array_to_string .

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"
}]

Vous trouverez ci-dessous des exemples détaillés sur la manière dont vous pouvez utiliser diverses fonctions pour accéder aux éléments de tableaux, transformer et filtrer des tableaux, joindre des éléments de tableau en chaîne, etc.

Limites connues known-limitations

Notez les limites connues suivantes qui s’appliquent actuellement à cette fonctionnalité :

Conditions préalables prerequisites

Connectez-vous à une destination d’espace de stockage souhaitée, suivez les étapes d’activation pour les destinations d’espace de stockage et accédez à l’étape mappage.

Comment exporter des champs calculés how-to-export-calculated-fields

À l’étape de mappage du workflow d’activation pour les destinations d’espace de stockage, sélectionnez Ajouter un champ calculé.

Une fenêtre modale s’ouvre, dans laquelle vous pouvez sélectionner des fonctions et des champs à exporter en dehors de l’Experience Platform.

Par exemple, utilisez la fonction array_to_string dans le champ organizations comme illustré ci-dessous pour exporter le tableau organisations sous la forme d’une chaîne dans un fichier CSV. Afficher plus d’informations à ce sujet et d’autres exemples ci-dessous.

Sélectionnez Enregistrer pour conserver le champ calculé et revenir à l’étape de mappage.

De retour à l’étape de mappage du workflow, remplissez le champ cible avec une valeur de l’en-tête de colonne que vous souhaitez pour ce champ dans les fichiers exportés.

Une fois prêt, sélectionnez Suivant pour passer à l’étape suivante du workflow d’activation.

Exemples de fonctions prises en charge pour exporter des tableaux supported-functions

Toutes les fonctions de préparation de données documentées sont prises en charge lors de l’activation de données vers des destinations basées sur des fichiers.

Les fonctions ci-dessous, spécifiques à la gestion des exportations de tableaux, sont documentées avec des exemples.

Exemples de fonctions utilisées pour exporter des tableaux examples

Consultez des exemples et des informations supplémentaires dans les sections ci-dessous pour certaines des fonctions répertoriées ci-dessus. Pour le reste des fonctions répertoriées, reportez-vous à la documentation sur les fonctions générales) dans la section Préparation des données.

array_to_string fonction pour exporter des tableaux array-to-string-function-export-arrays

Utilisez la fonction array_to_string pour concaténer les éléments d’un tableau en chaîne, à l’aide du séparateur souhaité, tel que _ ou |.

Par exemple, vous pouvez combiner les champs XDM suivants comme illustré dans la capture d’écran de mappage à l’aide d’une syntaxe array_to_string('_',organizations) :

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment les éléments du tableau sont concaténés en une seule chaîne à l’aide du caractère _ .

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 fonction pour exporter des tableaux filtrés

Utilisez la fonction filterArray pour filtrer les éléments d’un tableau exporté. Vous pouvez combiner cette fonction avec la fonction array_to_string décrite plus haut.

En poursuivant avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction telle que array_to_string('_', filterArray(organizations, org -> org.founded > 2021)), renvoyant les organisations avec une valeur de founded en 2021 ou plus récent.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment les deux éléments du tableau qui répondent au critère sont concaténés en une seule chaîne à l’aide du caractère _ .

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

transformArray fonction pour exporter des tableaux transformés

Utilisez la fonction transformArray pour transformer les éléments d’un tableau exporté. Vous pouvez combiner cette fonction avec la fonction array_to_string décrite plus haut.

En poursuivant avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction telle que array_to_string('_', transformArray(organizations, org -> ucase(org.orgName))), renvoyant les noms des organisations convertis en majuscules.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment les trois éléments du tableau sont transformés et concaténés en une seule chaîne à l’aide du caractère _ .

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

iif fonction pour exporter des tableaux iif-function-export-arrays

Utilisez la fonction iif pour exporter des éléments d'un tableau sous certaines conditions. Par exemple, en poursuivant avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction conditionnelle simple telle que iif(organizations[0].equals("Marketing"), "isMarketing", "isNotMarketing").

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Dans ce cas, le premier élément du tableau est Marketing. Par conséquent, la personne est membre du service marketing.

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

add_to_array fonction pour exporter des tableaux add-to-array-function-export-arrays

Utilisez la fonction add_to_array pour ajouter des éléments à un tableau exporté. Vous pouvez combiner cette fonction avec la fonction array_to_string décrite plus haut.

En poursuivant avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction telle que source: array_to_string('_', add_to_array(organizations,"2023")), renvoyant les organisations dont une personne est membre en 2023.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Remarquez comment les trois éléments du tableau sont concaténés en une seule chaîne à l’aide du caractère _ et 2023 est également ajouté à la fin de la chaîne.

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

flattenArray fonction pour exporter des tableaux aplatis

Utilisez la fonction flattenArray pour aplatir un tableau multidimensionnel exporté. Vous pouvez combiner cette fonction avec la fonction array_to_string décrite plus haut.

En poursuivant avec l’objet de tableau organizations ci-dessus, vous pouvez écrire une fonction telle que array_to_string('_', flattenArray(organizations)). Notez que la fonction array_to_string aplatit le tableau d’entrée par défaut en une chaîne.

La sortie résultante est la même que pour la fonction array_to_string décrite plus haut.

coalesce fonction pour exporter des tableaux coalesce-function-export-arrays

Utilisez la fonction coalesce pour accéder au premier élément non nul d’un tableau et l’exporter dans une chaîne.

Par exemple, vous pouvez combiner les champs XDM ci-dessous comme illustré dans la capture d’écran de mappage en utilisant une syntaxe coalesce(subscriptions.hasPromotion) pour renvoyer la première true de false valeur dans le tableau :

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez comment la première valeur de true non nulle du tableau est exportée dans le fichier .

First_Name,Last_Name,hasPromotion
John,Doe,true

size_of fonction pour exporter des tableaux sizeof-function-export-arrays

Utilisez la fonction size_of pour indiquer le nombre d’éléments qui existent dans un tableau. Par exemple, si vous disposez d’un objet de tableau purchaseTime avec plusieurs horodatages, vous pouvez utiliser la fonction size_of pour indiquer le nombre d’achats distincts effectués par une personne.

Par exemple, vous pouvez combiner les champs XDM ci-dessous comme illustré dans la capture d’écran du mappage.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit. Notez que la deuxième colonne indique le nombre d’éléments dans le tableau, correspondant au nombre d’achats distincts effectués par le client.

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

Accès aux tableaux basé sur les index index-based-array-access

Vous pouvez accéder à un index d’un tableau pour exporter un seul élément du tableau . Par exemple, comme dans l’exemple ci-dessus pour la fonction size_of , si vous souhaitez accéder à et exporter uniquement la première fois qu’un client a acheté un certain produit, vous pouvez utiliser purchaseTime[0] pour exporter le premier élément de l’horodatage, purchaseTime[1] pour exporter le deuxième élément de l’horodatage, purchaseTime[2] pour exporter le troisième élément de l’horodatage, etc.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit, en exportant le premier achat du client :

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

first et fonctions de last pour exporter des tableaux first-and-last-functions-export-arrays

Utilisez les fonctions first et last pour exporter le premier ou le dernier élément d'un tableau. Par exemple, en poursuivant avec l’objet de tableau purchaseTime avec plusieurs horodatages des exemples précédents, vous pouvez utiliser ces fonctions pour exporter la première ou la dernière heure d’achat effectuée par une personne.

Dans ce cas, votre fichier de sortie ressemble à ce qui suit, en exportant le premier et le dernier achat du client :

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