Esportazione di array, mappe e oggetti da Real-Time CDP a destinazioni di archiviazione cloud export-arrays-cloud-storage

Scopri come esportare array, mappe e oggetti da Real-Time CDP in destinazioni di archiviazione cloud. Leggi questo documento per comprendere il flusso di lavoro di esportazione, i casi d’uso abilitati da questa funzionalità e le limitazioni note.

Considera questa pagina come il tuo punto di riferimento per tutto ciò che desideri sapere sull’esportazione di array, mappe e altri tipi di oggetti da Experience Platform.

In basso in alto davanti

Ottieni le informazioni più importanti sulle funzionalità in questa sezione e continua di seguito con le altre sezioni del documento per informazioni dettagliate.

Array e altri tipi di oggetti in Platform arrays-strings-other-objects

In Experience Platform puoi utilizzare schemi XDM per gestire diversi tipi di campi. Prima di aggiungere il supporto per le esportazioni di array, era possibile esportare campi di tipo coppia chiave-valore semplici, come le stringhe, da Experience Platform nelle destinazioni desiderate. Un esempio di questo campo precedentemente supportato per l'esportazione è personalEmail.address:johndoe@acme.org.

Altri tipi di campo in Experience Platform includono i campi array. Ulteriori informazioni sulla gestione dei campi array nell'interfaccia utente di Experience Platform 🔗. È ora possibile esportare oggetti array come nell’esempio seguente.

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

Oltre agli array, puoi anche esportare mappe e oggetti da Experience Platform alla destinazione di archiviazione cloud desiderata. Ulteriori informazioni su mappe e oggetti in Experience Platform.

Prerequisiti prerequisites

Connetti a una destinazione di archiviazione cloud desiderata, segui i passaggi di attivazione per le destinazioni di archiviazione cloud e procedi al passaggio mappatura. Quando ti connetti alla destinazione cloud desiderata, devi selezionare l'opzione Esporta array, mappe, oggetti. Per ulteriori informazioni, consulta la sezione seguente.

Pulsante di attivazione per esportazione di array, mappe e oggetti export-arrays-maps-objects-toggle

Quando ti connetti a una destinazione di archiviazione cloud, puoi impostare l'attivazione o la disattivazione di Esporta array, mappe, oggetti.

Attiva questa impostazione per abilitare l’esportazione di array, mappe e oggetti in file JSON o Parquet. È possibile selezionare questi tipi di oggetto nella visualizzazione del campo di origine del passaggio di mappatura durante l'attivazione dei tipi di pubblico nelle destinazioni dell'archiviazione cloud. Tuttavia, con questa impostazione attivata, non è possibile utilizzare l’opzione dei campi calcolati per trasformare i dati all’attivazione.

Con questa impostazione disattivata, puoi utilizzare l’opzione dei campi calcolati e applicare varie funzioni di trasformazione dei dati durante l’attivazione dei tipi di pubblico. Tuttavia, non è possibile esportare array, mappe e oggetti in file JSON o Parquet e a tale scopo è necessario configurare una destinazione separata.

Esporta array, mappe, oggetti su export-arrays-maps-objects-toggle-on

Attivando questa impostazione, è possibile esportare interi oggetti (ad esempio person.name) e array selezionandoli tramite il selettore del campo di origine nel passaggio di mappatura del flusso di lavoro di attivazione.

Selezionando questa opzione, l'interfaccia utente blocca l'utilizzo dei campi calcolati e il controllo Aggiungi campi calcolati è disabilitato, come illustrato di seguito. Per utilizzare i campi calcolati per le trasformazioni di dati, imposta una connessione di destinazione con l’interruttore disattivato.

Esporta array, mappe, oggetti disattiva export-arrays-maps-objects-toggle-off

Con questa opzione impostata su off, puoi utilizzare l'opzione dei campi calcolati e applicare varie funzioni di trasformazione dei dati durante l'attivazione dei tipi di pubblico. Tuttavia, non è possibile esportare array, mappe e oggetti in file JSON o Parquet e a tale scopo è necessario configurare una destinazione separata.

È possibile esportare matrici, mappe e oggetti in file CSV utilizzando la funzionalità dei campi calcolati e concatenarli in una stringa utilizzando la funzione array_to_string. Ulteriori informazioni sull'utilizzo di tale funzione.

Ulteriori informazioni sull'utilizzo dei campi calcolati per eseguire trasformazioni sui dati esportati nelle destinazioni dell'archiviazione cloud.

File esportati di esempio sample-exported-files

Utilizzando questa funzionalità, puoi esportare i file Parquet e JSON in cui i dati mantengono la struttura da Experience Platform. Visualizza di seguito un esempio di file JSON esportato.

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