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-toggle

ファイルベースのクラウドストレージの宛先に接続する場合、「配列、マップ、オブジェクトを書き出し をオンまたはオフ 切り替えることができます。

。

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

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

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

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

。

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

配列、マップ、オブジェクトの書き出しの切り替え オフ 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
  }
}