Exportera arrayer, kartor och objekt från Real-Time CDP export-arrays-cloud-storage

Lär dig hur du exporterar arrayer, kartor och objekt från Real-Time CDP till molnlagringsmål. Dessutom kan du exportera mappningsfält till företagsmål och begränsade kantanpassningsmål. Läs det här dokumentet om du vill veta mer om exportarbetsflödet, vilka användningsfall som den här funktionen har aktiverat och kända begränsningar. Se tabellen nedan för att förstå vilka funktioner som är tillgängliga per måltyp.

Ta den här sidan som en praktisk plats där du kan hitta det du vill veta om hur du exporterar arrayer, kartor och andra objekttyper från Experience Platform.

Nedre linje längst fram

Hämta den viktigaste informationen om funktionerna i det här avsnittet och fortsätt till de andra avsnitten i dokumentet för detaljerad information.

Arrayer och andra objekttyper i Experience Platform arrays-strings-other-objects

I Experience Platform kan du använda XDM-scheman för att hantera olika fälttyper. Innan stöd för matrisexport lades till kunde du exportera enkla nyckelvärdepar, t.ex. strängar från Experience Platform, till önskade mål. Ett exempel på ett sådant fält som tidigare hade stöd för export är personalEmail.address:johndoe@acme.org.

Andra fälttyper i Experience Platform är arrayfält. Läs mer om att hantera matrisfält i Experience Platform-gränssnittet. Nu kan du exportera arrayobjekt som exemplet nedan.

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

Förutom arrayer kan du även exportera kartor och objekt från Experience Platform till önskat molnlagringsmål. Läs mer om kartor och objekt i Experience Platform.

Förhandskrav prerequisites

Anslut till önskat molnlagringsmål, gå igenom aktiveringsstegen för molnlagringsmål och gå till mappningssteget. När du ansluter till det önskade molnmålet måste du aktivera alternativet Export arrays, maps, objects. Mer information finns i avsnittet nedan.

Exportera arrayer, kartor, objektväxling export-arrays-maps-objects-toggle

När du ansluter till ett filbaserat molnlagringsmål kan du aktivera eller inaktivera Export arrays, maps, objects.

Växla den här inställningen på om du vill aktivera export av arrayer, kartor och objekt till JSON- eller Parquet-filer. Du kan välja de här objekttyperna i källfältsvyn i mappningssteget när du aktiverar målgrupper till molnlagringsmål. Om den här inställningen är aktiverad kan du inte använda alternativet för beräknade fält för att omforma data vid aktiveringen.

Med den här växlingen av kan du använda alternativet för beräknade fält och tillämpa olika dataomformningsfunktioner när du aktiverar målgrupper. Du kan dock inte exportera arrayer, kartor och objekt till JSON- eller Parquet-filer och måste konfigurera ett separat mål för det ändamålet.

Exportera arrayer, kartor, objekt som växlar på export-arrays-maps-objects-toggle-on

Med den här inställningen aktiverad kan du exportera hela objekt (till exempel person.name) och arrayer genom att markera dem via källfältväljaren i mappningssteget i aktiveringsarbetsflödet.

När det här alternativet är markerat blockerar användargränssnittet användare från att använda beräkningsfält och kontrollen Add calculated fields är inaktiverad, vilket visas nedan. Om du vill använda beräkningsfält för dataomvandlingar anger du en målanslutning med avaktiveringen.

Exportera arrayer, kartor, objekt som växlar av export-arrays-maps-objects-toggle-off

Med det här alternativet inställt på av kan du använda alternativet för beräknade fält och tillämpa olika dataomformningsfunktioner när du aktiverar målgrupper. Du kan dock inte exportera arrayer, kartor och objekt till JSON- eller Parquet-filer och måste konfigurera ett separat mål för det ändamålet.

Du kan exportera arrayer, kartor och objekt till CSV-filer genom att använda funktionen för beräknade fält och sammanfoga dem i en sträng med funktionen array_to_string. Läs mer om hur du använder den funktionen.

Läs mer om att arbeta med beräknade fält för att utföra omformningar på data som exporteras till molnlagringsmål.

Exempel på exporterade filer sample-exported-files

Med den här funktionen kan du exportera Parquet- och JSON-filer där data bevarar strukturen från Experience Platform. Visa ett exempel på en exporterad JSON-fil nedan.

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