データ収集のためのデータ準備

Adobe Experience Platform サービスのData Prepを使用して、Experience Data Model （XDM） ​との間でデータをマッピング、変換、検証します。 Experience Platform対応の​ データストリーム ​を設定する場合、Data Prep機能を使用して、ソースデータをAdobe Experience Platform Edge Networkに送信する際にXDMにマッピングできます。

web ページから送信されるすべてのデータは、XDMとしてExperience Platformに格納される必要があります。 ページ上のデータレイヤーからExperience Platformが受け入れるXDMにデータを変換するには、次の3つの方法があります。

このガイドでは、3つ目のオプションについて説明します。

データ収集にデータ準備を使用する場合 when-to-use-data-prep

データ収集用のデータ準備は、次の2つの状況で役立ちます。

Web SDK経由で既存のデータレイヤーをEdge Networkに送信する send-datalayer-via-websdk

既存のデータレイヤーは、sendEvent コマンド内のdata オブジェクトを使用して送信する必要があります。

Tagsを使用している場合は、Send Event アクションタイプの​Data フィールドを使用する必要があります。

このガイドの残りの部分では、Web SDKからデータ層を送信した後に、データ層をXDM標準にマッピングする方法について説明します。

このガイドでは、UI 内のデータのマッピング方法を説明します。 手順を完了するには、基本設定ステップ ​までのデータストリームを作成するプロセスを開始します。

データ収集のためのデータ準備プロセスの簡単なデモについては、次のビデオを参照してください。

サンプルデータの提供 select-data

データストリームの基本設定を完了した後で「Save and Add Mapping」を選択すると、Select data ステップが表示されます。 ここから、Experience Platformに送信する予定のデータの構造を表すサンプル JSON オブジェクトを指定する必要があります。

データレイヤーから直接プロパティを取得するには、JSON オブジェクが単一のルートプロパティ data を持つ必要があります。 次に、data オブジェクトのサブプロパティは、キャプチャするデータレイヤープロパティにマッピングする方法で構築する必要があります。 次のセクションを選択すると、data ルートを持つ適切にフォーマットされた JSON オブジェクトの例が表示されます。

{
  "data": {
    "eventMergeId": "cce1b53c-571f-4f36-b3c1-153d85be6602",
    "eventType": "view:load",
    "timestamp": "2021-09-30T14:50:09.604Z",
    "web": {
      "webPageDetails": {
        "siteSection": "Product section",
        "server": "example.com",
        "name": "product home",
        "URL": "https://www.example.com"
      },
      "webReferrer": {
        "URL": "https://www.adobe.com/index2.html",
        "type": "external"
      }
    },
    "commerce": {
      "purchase": 1,
      "order": {
        "orderID": "1234"
      }
    },
    "product": [
      {
        "productInfo": {
          "productID": "123"
        }
      },
      {
        "productInfo": {
          "productID": "1234"
        }
      }
    ],
    "reservation": {
      "id": "anc45123xlm",
      "name": "Embassy Suits",
      "SKU": "12345-L",
      "skuVariant": "12345-LG-R",
      "priceTotal": "112.99",
      "currencyCode": "USD",
      "adults": 2,
      "children": 3,
      "productAddMethod": "PDP",
      "_namespace": {
        "test": 1,
        "priceTotal": "112.99",
        "category": "Overnight Stay"
      },
      "freeCancellation": false,
      "cancellationFee": 20,
      "refundable": true
    }
  }
}

XDM オブジェクトデータ要素からプロパティを取得するには、同じルールを JSON オブジェクトに適用しますが、ルートプロパティは、変わりに xdm としてキーにする必要があります。 次のセクションを選択すると、xdm ルートを持つ適切にフォーマットされた JSON オブジェクトの例が表示されます。

{
  "xdm": {
    "environment": {
      "type": "browser",
      "browserDetails": {
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebkit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36",
        "javaScriptEnabled": true,
        "javaScriptVersion": "1.8.5",
        "cookiesEnabled": true,
        "viewportHeight": 900,
        "viewportWidth": 1680,
        "javaEnabled": true
      },
      "domain": "adobe.com",
      "colorDepth": 24,
      "viewportHeight": 1050,
      "viewportWidth": 1680
    },
    "device": {
      "screenHeight": 1050,
      "screenWidth": 1680
    }
  }
}

オブジェクトをファイルとしてアップロードするオプションを選択するか、提供されたテキストボックスに生のオブジェクトを代わりに貼り付けることができます。 JSON が有効な場合、右側のパネルにプレビュースキーマが表示されます。 続行するには、Next​を選択してください。

データのマッピング mapping

Mapping ステップが表示され、ソースデータのフィールドをExperience Platformのターゲットイベントスキーマのフィールドにマッピングできます。 ここから、2 つの方法でマッピングを設定できます。

マッピングルールの作成 create-mapping

マッピングルールを作成するには、Add new mapping​を選択します。

ソースアイコン（ ）を選択し、表示されるダイアログで、提供されたキャンバスでマッピングするソースフィールドを選択します。 フィールドを選択したら、Select ボタンを使用して続行します。

次に、スキーマアイコン（ ）を選択して、ターゲットイベントスキーマの同様のダイアログを開きます。 データをマッピングするフィールドを選択してから、Select​を確認してください。

マッピングページが再表示され、完成したフィールドマッピングが表示されます。 Mapping progress セクションが更新され、正常にマッピングされたフィールドの合計数が反映されます。

TIP

オブジェクトの配列（ソースフィールド）を異なるオブジェクトの配列（ターゲットフィールド）にマッピングする場合は、次に示すように、ソースフィールドとターゲットフィールドのパスの配列名の後に [*] を追加します。

既存のマッピングルールを読み込む import-mapping

以前にデータストリームを作成したことがある場合は、設定したマッピングルールを新しいデータストリームに再利用できます。

開始するには、Import Mapping​を選択します。

表示されるダイアログで、マッピングルールを読み込むデータストリームを選択します。 データストリームを選択したら、Preview​を選択します。

次の画面に、選択したデータストリームの保存されたマッピングルールのプレビューを示します。 表示されるマッピングが期待どおりであることを確認し、Import​を選択してマッピングを確認し、新しいデータストリームに追加します。

マッピングの完了 complete-mapping

残りのフィールドのターゲットスキーマへのマッピングを続行します。 利用可能なすべてのソースフィールドをマッピングする必要はありませんが、必要に応じて設定されたターゲットスキーマのフィールドは、この手順を完了するためにマッピングする必要があります。 Required fields カウンターは、現在の設定でまだマッピングされていない必須フィールドの数を示します。

必須フィールド数が0に達し、マッピングに満足したら、Save​を選択して変更を確定します。

次の手順 next-steps

このガイドでは、UI でデータストリームを設定する際の、データの XDM へのマッピング方法について説明しました。 一般的なデータストリームのチュートリアルに従っていた場合は、​ データストリームの詳細の表示の手順に戻れるようになりました。