從Real-Time CDP匯出陣列、地圖和物件 export-arrays-cloud-storage

瞭解如何從Real-Time CDP將陣列、地圖和物件匯出至雲端儲存空間目的地。 此外，您可以將對應型別欄位匯出至企業目的地和有限的邊緣個人化目的地。 請參閱本檔案以瞭解匯出工作流程、此功能啟用的使用案例和已知限制。 檢視下表以瞭解每種目的地型別可用的功能。

請考量此頁面，您可以前往想瞭解如何從Experience Platform匯出陣列、地圖和其他物件型別的任何位置。

底線在前面

取得本節中有關功能的最重要資訊，然後繼續參閱檔案中的其他章節，以取得詳細資訊。

Experience Platform中的陣列和其他物件型別 arrays-strings-other-objects

在Experience Platform中，您可以使用XDM結構描述來管理不同的欄位型別。 在新增支援陣列匯出功能之前，您能夠將簡單的索引鍵/值組型別欄位（例如字串）從Experience Platform匯出至您想要的目的地。 先前支援匯出的欄位範例為personalEmail.address：johndoe@acme.org。

Experience Platform中的其他欄位型別包含陣列欄位。 深入瞭解如何在Experience Platform UI中管理陣列欄位。 您現在可以匯出陣列物件，例如下列範例。

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

除了陣列之外，您也可以從Experience Platform將地圖和物件匯出至您想要的雲端儲存空間目的地。 深入瞭解Experience Platform中的對應和物件。

先決條件 prerequisites

連線至所需的雲端儲存空間目的地，完成雲端儲存空間目的地的啟動步驟並到達對應步驟。 連線到所需的雲端目的地時，您必須選取​ Export arrays, maps, objects ​切換開啟。 如需詳細資訊，請參閱以下章節。

匯出陣列、對應及物件的切換開關 export-arrays-maps-objects-toggle

連線到以檔案為基礎的雲端儲存空間目的地時，您可以將​ Export arrays, maps, objects ​切換設定為開啟或關閉。

將此設定切換為​開啟，便可以將陣列、對應及物件匯出至 JSON 或 Parquet 檔案。啟用受眾至雲端儲存空間目的地時，您可以在對應步驟的來源欄位檢視中選取這些物件型別。 不過，若開啟此設定，您就無法於啟用時使用計算欄位選項來轉換資料。

將這項設定切換為​ 關閉 ​後，即可使用計算欄位選項並在啟動客群時套用各種資料轉換函數。不過，您無法將陣列、地圖和物件匯出至JSON或Parquet檔案，且必須為此設定個別的目的地。

匯出陣列、地圖、物件切換​開啟 export-arrays-maps-objects-toggle-on

開啟此設定後，您可以透過啟動工作流程對應步驟中的來源欄位選取器來選取物件，以匯出整個物件（例如person.name）和陣列。

選取此選項後，使用者介面會封鎖使用者，使其無法使用計算欄位，並停用​ Add calculated fields ​控制項，如下所示。 若要使用計算欄位進行資料轉換，請在關閉切換功能的情況下設定目的地連線。

匯出陣列、地圖、物件切換​關閉 export-arrays-maps-objects-toggle-off

此選項設為​ off ​時，您可以使用計算欄位選項並在啟用對象時套用各種資料轉換函式。 不過，您無法將陣列、地圖和物件匯出至JSON或Parquet檔案，且必須為此設定個別的目的地。

您可以​ 使用計算欄位功能，將陣列、對應和物件 ​匯出至CSV檔案，並使用array_to_string函式將它們串連至字串。 閱讀有關使用該函式的詳細資訊。

深入瞭解如何使用計算欄位，以對匯出至雲端儲存空間目的地的資料執行轉換。

匯出檔案範例 sample-exported-files

透過使用此功能，您可以匯出Parquet和JSON檔案，其中的資料會保留Experience Platform中的結構。 檢視匯出的JSON檔案範例下方。

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