Arrays, kaarten en objecten van Real-Time CDP naar cloudopslagdoelen exporteren export-arrays-cloud-storage

Leer hoe te om series, kaarten, en voorwerpen van Real-Time CDP naar wolkenopslagbestemmingenuit te voeren. Lees dit document om inzicht te krijgen in de exportworkflow, de gebruiksgevallen die door deze functionaliteit worden ingeschakeld en de bekende beperkingen.

Bekijk deze pagina voor alles wat u wilt weten over het exporteren van arrays, kaarten en andere objecttypen uit Experience Platform.

Onderste regel naar boven

Haal de belangrijkste informatie over de functionaliteit in deze sectie op en ga verder onder de andere secties in het document voor meer informatie.

Arrays en andere objecttypen in Platform arrays-strings-other-objects

In Experience Platform, kunt u schema's XDMgebruiken om verschillende gebiedstypes te beheren. Voordat ondersteuning voor het exporteren van arrays werd toegevoegd, kon u eenvoudige sleutelwaardepaartypevelden, zoals tekenreeksen, uit Experience Platform exporteren naar de gewenste doelen. Een voorbeeld van zulk een gebied dat voor de uitvoer eerder werd gesteund is personalEmail.address:johndoe@acme.org.

Andere veldtypen in Experience Platform zijn arrayvelden. Lees meer over het beheren van seriegebieden in Experience Platform UI. U kunt nu matrixobjecten exporteren, zoals het onderstaande voorbeeld.

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

Naast arrays kunt u ook kaarten en objecten van Experience Platform naar de gewenste bestemming voor cloudopslag exporteren. Lees meer over kaartenen voorwerpenin Experience Platform.

Vereisten prerequisites

verbindtmet een gewenste bestemming van de wolkenopslag, vooruitgang door de activeringsstappen voor de bestemmingen van de wolkenopslagen krijgt aan de in kaart brengendestap. Wanneer u verbinding maakt met de gewenste wolkenbestemming, moet u de schakeloptie Export arrays, maps, objects inschakelen. Meer informatie vindt u in de onderstaande sectie.

Arrays, kaarten, objecten in-/uitschakelen export-arrays-maps-objects-toggle

Wanneer u verbinding maakt met een locatie voor cloudopslag, kunt u de schakeloptie Export arrays, maps, objects in- of uitschakelen.

Wissel dit het plaatsen op om de uitvoer van series, kaarten, en voorwerpen aan JSON of de dossiers van het Parket toe te laten. U kunt deze objecten types in de brongebiedmening van de toewijzingsstapselecteren wanneer het activeren van publiek aan de bestemmingen van de wolkenopslag. Als deze instelling is ingeschakeld, kunt u de optie Berekende velden echter niet gebruiken om gegevens bij activering te transformeren.

Met deze knevel weg, kunt u de berekende gebiedsoptie gebruiken en diverse functies van de gegevenstransformatie toepassen wanneer het activeren van publiek. U kunt echter geen arrays, kaarten en objecten exporteren naar JSON- of Parquet-bestanden en moet daarvoor een aparte bestemming configureren.

De series van de uitvoer, kaarten, voorwerpen schakelen op export-arrays-maps-objects-toggle-on

Als deze instelling is ingeschakeld, kunt u volledige objecten (bijvoorbeeld person.name ) en arrays exporteren door deze via de bronveldkiezer te selecteren in de toewijzingsstap van de activeringsworkflow.

Als deze optie is geselecteerd, voorkomt de gebruikersinterface dat gebruikers berekende velden gebruiken en is het besturingselement Add calculated fields uitgeschakeld, zoals hieronder wordt weergegeven. Als u berekende velden wilt gebruiken voor gegevenstransformaties, stelt u een doelverbinding in met de schakeloptie uit.

De series van de uitvoer, kaarten, voorwerpen schakelen weg export-arrays-maps-objects-toggle-off

Met deze optie die aan wordt geplaatst weg, kunt u de berekende gebiedsoptie gebruiken en diverse functies van de gegevenstransformatie toepassen wanneer het activeren van publiek. U kunt echter geen arrays, kaarten en objecten exporteren naar JSON- of Parquet-bestanden en moet daarvoor een aparte bestemming configureren.

U kunt series, kaarten, en voorwerpen naar Csv- dossiers uitvoeren door de berekende gebiedsfunctionaliteit te gebruiken en hen in een koord aaneenschakelen door de array_to_string functie te gebruiken. las meerover het gebruiken van die functie.

Lees meer over het werken met berekende gebieden om transformaties op gegevens uit te voeren die naar de bestemmingen van de wolkenopslagworden uitgevoerd.

Voorbeeld van geëxporteerde bestanden sample-exported-files

Met deze functie kunt u Parquet- en JSON-bestanden exporteren waarin de structuur van Experience Platform behouden blijft. Onder een voorbeeld van een geëxporteerd JSON-bestand weergeven.

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