Exporter des tableaux, des mappages et des objets à partir de Real-Time CDP export-arrays-cloud-storage

Découvrez comment exporter des tableaux, des mappages et des objets de Real-Time CDP vers des destinations d’espace de stockage. De plus, vous pouvez exporter des champs de type mappage vers des destinations d’entreprise et des destinations de personnalisation Edge limitées. Lisez ce document pour comprendre le workflow d’exportation, les cas d’utilisation activés par cette fonctionnalité et les limites connues. Consultez le tableau ci-dessous pour comprendre les fonctionnalités disponibles par type de destination.

Utilisez cette page comme référence pour tout ce que vous souhaitez savoir sur l’exportation de tableaux, de mappages et d’autres types d’objets à partir d’Experience Platform.

Ligne du bas vers le haut

Obtenez les informations les plus importantes sur les fonctionnalités de cette section, et continuez ci-dessous vers les autres sections du document pour obtenir des informations détaillées.

Tableaux et autres types d’objets dans Experience 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, à partir d’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.

Les autres types de champs d’Experience Platform incluent les champs de tableau. En savoir plus sur la gestion des champs de tableau dans l’interface utilisateur d’Experience Platform. Vous pouvez désormais exporter des objets de tableau, comme dans l’exemple ci-dessous.

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

En plus des tableaux, vous pouvez également exporter des mappages et des objets d’Experience Platform vers la destination d’espace de stockage de votre choix. Pour en savoir plus sur les mappages et objets, consultez Experience Platform.

Prérequis 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. Lors de la connexion à la destination cloud souhaitée, vous devez activer le bouton (bascule) Exporter des tableaux, des mappages des objets . Pour plus d’informations, reportez-vous à la section ci-dessous.

Bouton bascule Exporter des tableaux, mappages et objets export-arrays-maps-objects-toggle

Lors de la connexion à une destination d’espace de stockage basé sur des fichiers, vous pouvez activer ou désactiver le bouton Exporter des tableaux, des mappages des objets.

Activez ce paramètre pour activer l’export de tableaux, de mappages et d’objets vers des fichiers JSON ou Parquet. Vous pouvez sélectionner ces types d’objets dans la vue du champ source de l’étape de mappage lors de l’activation d’audiences vers des destinations d’espace de stockage. Cependant, lorsque ce paramètre est activé, vous ne pouvez pas utiliser l’option champs calculés pour transformer les données lors de l’activation.

Lorsque ce bouton (bascule) est désactivé, vous pouvez utiliser l’option de champs calculés et appliquer diverses fonctions de transformation des données lors de l’activation des audiences. Cependant, vous ne pouvez pas exporter des tableaux, des mappages et des objets vers des fichiers JSON ou Parquet et devez configurer une destination distincte à cet effet.

Basculement entre les tableaux, mappages et objets d’exportation activé export-arrays-maps-objects-toggle-on

Lorsque ce paramètre est activé, vous pouvez exporter des objets entiers (par exemple, des person.name) et des tableaux en les sélectionnant via le sélecteur de champ source dans l’étape de mappage du workflow d’activation.

Lorsque cette option est sélectionnée, l’interface utilisateur empêche les utilisateurs d’utiliser des champs calculés et le contrôle Ajouter des champs calculés est désactivé, comme illustré ci-dessous. Pour utiliser les champs calculés pour les transformations de données, configurez une connexion de destination en désactivant l’option .

Basculement entre les tableaux, mappages et objets d’exportation désactivé export-arrays-maps-objects-toggle-off

Lorsque cette option est définie sur désactivée, vous pouvez utiliser l’option champs calculés et appliquer diverses fonctions de transformation des données lors de l’activation des audiences. Cependant, vous ne pouvez pas exporter des tableaux, des mappages et des objets vers des fichiers JSON ou Parquet et devez configurer une destination distincte à cet effet.

Vous pouvez exporter des tableaux, des mappages et des objets vers des fichiers CSV à l’aide de la fonctionnalité de champs calculés et les concaténer dans une chaîne à l’aide de la fonction array_to_string . En savoir plus sur l’utilisation de cette fonction.

En savoir plus sur l’utilisation des champs calculés pour effectuer des transformations sur les données exportées vers des destinations d’espace de stockage.

Exemples de fichiers exportés sample-exported-files

Grâce à cette fonctionnalité, vous pouvez exporter des fichiers Parquet et JSON dans lesquels les données préservent la structure d’Experience Platform. Consultez ci-dessous un exemple de fichier JSON exporté.

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