Real-Time CDPから配列、マップ、オブジェクトを書き出す export-arrays-cloud-storage

Real-Time CDPから​ クラウドストレージの宛先に配列、マップ、オブジェクトを書き出す方法について説明します。 さらに、マップタイプのフィールドを​ エンタープライズ宛先に書き出すことができ、​ エッジパーソナライゼーション宛先に制限があります。 このドキュメントでは、書き出しワークフロー、この機能によって有効になるユースケース、および既知の制限事項について説明します。 以下の表を参照して、宛先タイプごとに使用可能な機能を理解します。

Experience Platformからの配列、マップ、その他のオブジェクトタイプの書き出しについて知りたい内容については、このページを参照してください。

一番下の行を前面へ bottom-line

このセクションの機能に関する最も重要な情報を取得し、詳細については、以下のドキュメントの他のセクションに進んでください。

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のmapsと​ オブジェクト ​の詳細をご覧ください。

前提条件 prerequisites

Connectを目的のクラウドストレージ宛先に接続し、クラウドストレージ宛先の アクティベーション手順を進め、​ マッピング ​手順に進みます。 目的のクラウド宛先に接続する場合は、Export arrays, maps, objects​切り替えをオンにする必要があります。 詳細については、以下の節を参照してください。

配列、マップ、オブジェクトの書き出し切替スイッチ export-arrays-maps-objects-toggle

ファイルベースのクラウドストレージの宛先に接続する場合、Export arrays, maps, objects​の切り替えをオンまたはオフに設定できます。

この設定を​ オン ​に切り替えると、配列、マップ、オブジェクトを JSON または Parquet ファイルに書き出すことができます。クラウドストレージの宛先に対してオーディエンスをアクティブ化する場合、​ マッピング手順のソースフィールドビューで、これらのオブジェクトタイプを選択できます。 ただし、この設定をオンにすると、計算済みフィールド オプションを使用してアクティベーション時にデータを変換することはできません。

この切替スイッチを​ オフ ​にすると、計算フィールドオプションを使用して、オーディエンスをアクティブ化する際に様々なデータ変換関数を適用できます。ただし、配列、マップ、オブジェクトをJSONまたはParquet ファイルに書き出すことはできず、その目的のために別の宛先を設定する必要があります。

配列、マップ、オブジェクトの書き出し切り替え​on export-arrays-maps-objects-toggle-on

この設定をオンにすると、アクティブ化ワークフローのマッピングステップでソースフィールドセレクターを使用してオブジェクト全体（例：person.name）と配列を選択して書き出すことができます。

このオプションを選択すると、ユーザーインターフェイスは計算フィールドの使用をユーザーにブロックし、Add calculated fields コントロールは次のように無効になります。 データ変換に計算フィールドを使用するには、切り替えスイッチをオフにして宛先接続を設定します。

配列、マップ、オブジェクトの書き出し切り替え​off export-arrays-maps-objects-toggle-off

このオプションを​ off ​に設定すると、オーディエンスをアクティブ化する際に、「計算フィールド」オプションを使用し、様々なデータ変換関数を適用できます。 ただし、配列、マップ、オブジェクトをJSONまたはParquet ファイルに書き出すことはできず、その目的のために別の宛先を設定する必要があります。

は、計算フィールド機能を使用して配列、マップ、およびオブジェクトをCSV ファイルに書き出し、​関数を使用して文字列に連結することができます。 array_to_stringこの関数の使用について詳細を読む。

計算フィールドを使用して、クラウドストレージの宛先に書き出されたデータに対して変換を実行する方法について詳しくは、こちらを参照してください。

書き出されたファイルのサンプル sample-exported-files

この機能を使用すると、データがExperience Platformから構造を保持するParquet ファイルとJSON ファイルを書き出すことができます。 書き出された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
  }
}