ドキュメントExperience Platformインテリジェントサービスガイド

Intelligent Servicesで使用するためのデータの準備

最終更新日： 2025年11月8日

作成対象：

  • User

Intelligent Servicesがマーケティングイベントデータからインサイトを発見するには、データを意味で強化し、標準構造で維持する必要があります。 Intelligent Servicesは、これを実現するためにExperience Data Model （XDM） スキーマを活用します。 具体的には、Intelligent Servicesで使用されるすべてのデータセットは、Consumer ExperienceEvent （CEE） XDM スキーマに準拠するか、Adobe Analytics コネクタを使用する必要があります。 さらに、Customer AIはAdobe Audience Manager コネクタをサポートしています。

このドキュメントでは、複数チャネルのマーケティングイベントデータをCEE スキーマにマッピングする際の一般的なガイダンスを提供し、スキーマ内の重要なフィールドに関する情報を概説して、データをその構造に効果的にマッピングする方法を決定するのに役立ちます。 Adobe Analytics データを使用する場合は、Adobe Analytics データ準備の節を参照してください。 Adobe Audience Manager データの使用を計画している場合（Customer AIのみ）、Adobe Audience Manger データの準備の節を参照してください。

必要データ構成

Intelligent Servicesでは、作成する目標に応じて、異なる量の履歴データが必要です。 関係なく、all Intelligent Services用に準備するデータには、肯定的なカスタマージャーニー/イベントと否定的なカスタマージャーニー/イベントの両方を含める必要があります。 負のイベントと正のイベントの両方を持つことで、モデルの精度と精度が向上します。

たとえば、Customer AIを使用して製品の購入傾向を予測する場合、Customer AIのモデルには、成功した購入パスの例と失敗したパスの例の両方が必要です。 これは、モデルのトレーニング中に、Customer AIが、どのようなイベントやジャーニーが購入につながるのかを把握するからです。 また、カートに商品を追加する際にジャーニーを停止した顧客など、購入しなかった顧客の行動も含まれます。 これらの顧客にも同様の行動が見られる場合がありますが、Customer AIを利用すれば、インサイトを提供し、傾向スコアの向上につながる主な違いや要因をドリルダウンすることができます。 同様に、アトリビューション AIでは、タッチポイントの効果、トップコンバージョンパス、タッチポイントの位置別の分類などの指標を表示するために、両方のタイプのイベントとジャーニーが必要です。

過去のデータ要件に関する詳細な例と情報については、入出力ドキュメントの「Customer AI」または「Attribution AI historical data requirements」セクションを参照してください。

データをつなぎ合わせるためのガイドライン

可能であれば、共通IDでユーザーのイベントをつなぎ合わせることをお勧めします。 例えば、10個のイベントに「id1」を持つユーザーデータがある場合があります。 その後、同じユーザーがcookie IDを削除し、次の20件のイベントで「id2」として記録されます。 id1とid2が同じユーザーに対応することがわかっている場合は、30個のイベントをすべて共通のidで結合することをお勧めします。

これが不可能な場合は、モデル入力データを作成する際に、各イベントを異なるユーザーとして扱う必要があります。 これにより、モデルのトレーニングとスコアリング中に最適な結果を得ることができます。

ワークフローの概要

準備プロセスは、データがAdobe Experience Platformに保存されているか、外部に保存されているかによって異なります。 このセクションでは、いずれかのシナリオを考えると、必要な手順を要約します。

外部データの準備

データがExperience Platform以外に保存されている場合は、Consumer ExperienceEvent スキーマ ​の必須フィールドと関連フィールドにデータをマッピングする必要があります。 このスキーマは、カスタムフィールドグループで強化することで、顧客データをより適切に取得できます。 マッピングが完了したら、Consumer ExperienceEvent スキーマを使用してデータセットを作成し、​ データをExperience Platformに取り込むことができます。 次に、Intelligent Serviceの設定時にCEE データセットを選択できます。

使用するIntelligent Serviceによっては、異なるフィールドが必要になる場合があります。 使用可能なデータがある場合は、フィールドにデータを追加することをお勧めします。 必須フィールドについて詳しくは、Attribution AIまたはCustomer AI データ要件ガイドを参照してください。

Adobe Analyticsデータの準備 analytics-data

Customer AIとAttribution AIは、Adobe Analyticsデータをネイティブにサポートします。 Adobe Analytics データを使用するには、ドキュメントに記載されている手順に従って、Analytics ソースコネクタ ​を設定します。

ソースコネクタでExperience Platformにデータをストリーミングすると、インスタンス設定時にAdobe Analytics as a data sourceを選択し、データセットを選択できます。 すべての必須スキーマフィールドグループと個々のフィールドは、接続の設定中に自動的に作成されます。 データセットをCEE形式にETL （抽出、変換、格納）する必要はありません。

Adobe Analytics ソースコネクタを通じてAdobe Experience Platformに流し込まれたデータとAdobe Analytics データを比較すると、一部の不一致が発生する場合があります。 Analytics Source コネクタは、Experience Data Model （XDM）スキーマへの変換中に行をドロップする可能性があります。 タイムスタンプの欠落、personIDの欠落、無効または大規模なperson ID、無効な分析値など、行全体が変換に適さない理由が複数ある場合があります。

詳細と例については、Adobe AnalyticsとCustomer Journey Analytics データの比較のドキュメントを参照してください。 この記事は、お客様とチームがデータの整合性に関する懸念に妨げられることなく、Adobe Experience Platform data for Intelligent Servicesを使用できるように、それらの違いを診断し、解決できるように設計されています。

Adobe Experience Platform クエリサービスで、channel.typeAtSource クエリで開始と終了のタイムスタンプの間に次の合計レコードを実行して、マーケティングチャネル別のカウントを見つけます。

       Count(_id) AS Records
FROM  df_hotel
WHERE timestamp>=from_utc_timestamp('2021-05-15','UTC')
        AND timestamp<from_utc_timestamp('2022-01-10','UTC')
        AND timestamp IS NOT NULL
        AND enduserids._experience.aaid.id IS NOT NULL
GROUP BY channel.typeAtSource
IMPORTANT
Adobe Analytics コネクタは、データのバックフィルに最大4週間かかります。 最近接続を設定した場合は、顧客AIまたはアトリビューション AIに必要な最小限のデータ長がデータセットにあることを確認する必要があります。 Customer AIまたはAttribution AIの履歴データ セクションを確認し、予測目標に十分なデータがあることを確認してください。

Adobe Audience Manager データの準備（Customer AIのみ） AAM-data

Customer AIはAdobe Audience Managerデータをネイティブでサポートしています。 Audience Manager データを使用するには、ドキュメントに記載されている手順に従って、Audience Manager ソースコネクタ ​を設定します。

ソースコネクタでExperience Platformにデータをストリーミングすると、Customer AIの設定時にAdobe Audience Manager as a Data Sourceを選択し、データセットを選択できます。 接続の設定中に、すべてのスキーマフィールドグループと個々のフィールドが自動的に作成されます。 データセットをCEE形式にETL （抽出、変換、格納）する必要はありません。

IMPORTANT
コネクタを最近設定した場合は、データセットに必要なデータの最小長があることを確認する必要があります。 Customer AIの入出力ドキュメント ​の履歴データの節を確認し、予測目標に十分なデータがあることを確認してください。

Experience Platform データの準備

データが既にExperience Platformに保存されていて、Adobe AnalyticsまたはAdobe Audience Manager（Customer AIのみ）ソースコネクタを通じてストリーミングされていない場合は、次の手順に従います。 CEE スキーマを理解することをお勧めします。

  1. Consumer ExperienceEvent スキーマ ​の構造を確認し、データをそのフィールドにマッピングできるかどうかを判断します。
  2. データをスキーマにマッピングしてIntelligent Servicesに取り込む方法については、Adobe Consulting サービスにお問い合わせください。また、自分でデータをマッピングする場合は、このガイド ​の手順に従ってください。

CEE スキーマについて cee-schema

Consumer ExperienceEvent スキーマは、デジタルマーケティングイベント（webまたはモバイル）、オンラインまたはオフラインのコマースアクティビティに関連する個人の行動を記述します。 このスキーマは、セマンティックに明確に定義されたフィールド（列）を使用するため、Intelligent Servicesでは使用が必要です。そうしないとデータが不明確になる未知の名前は避けてください。

CEE スキーマは、すべてのXDM ExperienceEvent スキーマと同様に、イベント（または一連のイベント）が発生した際のシステムの時系列ベースの状態をキャプチャします。これには、時刻と関連する被写体のIDが含まれます。 エクスペリエンスイベントは、何が起こったかの実際の記録であり、したがって不変であり、集計や解釈なしで何が起こったかを表します。

Intelligent Servicesは、このスキーマ内のいくつかの重要なフィールドを利用して、マーケティングイベントデータからインサイトを生成します。これらはすべてルートレベルで見つかり、拡張して必須サブフィールドを表示できます。

​ ナビゲーションとサブフィールドの詳細を示す、Adobe Experience Platform UIでのスキーマ拡張のデモ。

すべてのXDM スキーマと同様に、CEE スキーマフィールドグループは拡張可能です。 つまり、CEE フィールドグループに追加のフィールドを追加し、必要に応じて複数のスキーマに異なるバリエーションを含めることができます。

フィールドグループの完全な例は、​ パブリック XDM リポジトリ ​にあります。 さらに、CEE スキーマに準拠するようにデータを構造化する方法の例として、次のJSON ファイル ​を表示してコピーできます。 独自のデータをスキーマにマッピングする方法を決定するには、以下の節で概説する主要フィールドについて説明する際に、これらの両方の例を参照してください。

キーフィールド

CEE フィールドグループ内には、有用なインサイトを生成するためにIntelligent Servicesが利用する必要があるキーフィールドがいくつかあります。 この節では、これらのフィールドのユースケースと想定されるデータについて説明し、その他の例に関する参照ドキュメントへのリンクを提供します。

必須フィールド

すべてのキーフィールドの使用を強くお勧めしますが、Intelligent Servicesを機能させるには、必須​の2つのフィールドがあります。

プライマリ ID identity

スキーマ内の1つのフィールドをプライマリ ID フィールドとして設定する必要があります。これにより、Intelligent Servicesは時系列データの各インスタンスを個々のユーザーにリンクできます。

データのソースと性質にもとづいて、プライマリ IDとして使用するのに最適なフィールドを決定する必要があります。 ID フィールドには、フィールドが値として期待するID データの種類を示す​ ID名前空間 ​を含める必要があります。 有効な名前空間値には、次のようなものがあります。

NOTE
Experience Cloud ID （ECID）はMCIDとも呼ばれ、名前空間で引き続き使用されます。
  • 「メール」
  • 「電話」
  • “mcid” （Adobe Audience Manager IDの場合）
  • “aaid” （Adobe Analytics IDの場合）

プライマリ IDとして使用するフィールドが不明な場合は、Adobe Consulting サービスに連絡して最適なソリューションを判断してください。 プライマリ IDが設定されていない場合、Intelligent Service アプリケーションは次のデフォルト動作を使用します。

デフォルト
アトリビューション AI
顧客 AI
ID列
endUserIDs._experience.aaid.id
endUserIDs._experience.mcid.id
名前空間
AAID
ECID

プライマリ IDを設定するには、スキーマ タブからスキーマに移動し、スキーマ名ハイパーリンクを選択して​ Schema Editor ​を開きます。

Adobe Experience Platform UIのスキーマに移動します。

次に、プライマリ IDとして使用するフィールドに移動して、そのフィールドを選択します。 そのフィールドの​フィールドプロパティ メニューが開きます。

Adobe Experience Platform UIで目的のフィールドを選択するプロセス。

フィールドプロパティ メニューで、ID チェックボックスが表示されるまで下にスクロールします。 チェックボックスをオンにすると、選択したIDを​ プライマリ ID ​として設定するオプションが表示されます。 このボックスも選択します。

Adobe Experience Platform UIでプライマリ IDを設定するためのチェックボックス。

次に、ドロップダウンの定義済み名前空間のリストから​ ID名前空間 ​を指定する必要があります。 この例では、Adobe Audience Manager ID mcid.idが使用されているため、ECID名前空間が選択されています。 「適用」を選択して更新を確認し、右上隅の「保存」を選択してスキーマに変更を保存します。

Adobe Experience Platform UIでECID名前空間の選択範囲を表示するドロップダウンメニュー。

xdm:timestamp timestamp

このフィールドは、イベントが発生した日時を表します。 この値は、ISO 8601標準に従って、文字列として指定する必要があります。

xdm:channel channel

NOTE
このフィールドは、アトリビューション AIを使用する場合にのみ必須です。

このフィールドは、ExperienceEventに関連するマーケティングチャネルを表します。 このフィールドには、チャネルタイプ、メディアタイプ、場所タイプに関する情報が含まれます。

type、mediaType、mediaActionなどのサブフィールドを含むxdm:channel フィールドの構造を示す 図。

スキーマの例

{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

xdm:channelに必要な各サブフィールドについて詳しくは、​ エクスペリエンスチャネルスキーマ ​仕様を参照してください。 一部のマッピングの例については、以下の​ テーブル ​を参照してください。

チャネルマッピングの例 example-channels

次の表に、xdm:channel スキーマにマッピングされたマーケティングチャネルの例をいくつか示します。

チャネル
@type
mediaType
mediaAction
有料検索
https://ns.adobe.com/xdm/channel-types/search
有料
クリック数
ソーシャル – マーケティング
https://ns.adobe.com/xdm/channel-types/social
アーンド
クリック数
表示
https://ns.adobe.com/xdm/channel-types/display
有料
クリック数
メール
https://ns.adobe.com/xdm/channel-types/email
有料
クリック数
内部リファラー
https://ns.adobe.com/xdm/channel-types/direct
所有
クリック数
ViewThroughを表示
https://ns.adobe.com/xdm/channel-types/display
有料
インプレッション
QR コードリダイレクト
https://ns.adobe.com/xdm/channel-types/direct
所有
クリック数
Mobile
https://ns.adobe.com/xdm/channel-types/mobile
所有
クリック数

推奨フィールド

キーフィールドの残りの部分については、この節で説明します。 これらのフィールドは、Intelligent Servicesが機能するために必ずしも必要ではありませんが、より豊富なインサイトを得るために、できるだけ多くのフィールドを使用することを強くお勧めします。

xdm:productListItems

このフィールドは、製品SKU、名前、価格、数量など、顧客が選択した製品を表すアイテムの配列です。

SKU、名前、currencyCode、数量、priceTotalなどのサブフィールドを含むxdm フィールド。

スキーマの例

[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

xdm:productListItemsに必要な各サブフィールドについて詳しくは、​ コマースの詳細スキーマ ​仕様を参照してください。

xdm:commerce

このフィールドには、発注番号や支払い情報など、ExperienceEventに関するコマースに特化した情報が含まれます。

注文、購入、支払いなどのサブフィールドを含むxdm フィールドの構造。

スキーマの例

{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

xdm:commerceに必要な各サブフィールドについて詳しくは、​ コマースの詳細スキーマ ​仕様を参照してください。

xdm:web

このフィールドは、インタラクション、ページの詳細、リファラーなど、ExperienceEventに関連するwebの詳細を表します。

webPageDetailsやwebReferrerなどのサブフィールドを含むxdm フィールド。

スキーマの例

{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

xdm:productListItemsに必要な各サブフィールドについて詳しくは、ExperienceEvent web詳細スキーマ ​仕様を参照してください。

xdm:marketing

このフィールドには、タッチポイントでアクティブなマーケティングアクティビティに関連する情報が含まれます。

trackingCode、campaignGroup、campaignNameなどのサブフィールドを含むxdm フィールドの構造。

スキーマの例

{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

xdm:productListItemsに必要な各サブフィールドについて詳しくは、​ マーケティングの節の仕様を参照してください。

データのマッピングと取り込み mapping

マーケティングイベントデータをCEE スキーマにマッピングできるかどうかを決定したら、次の手順は、どのデータをIntelligent Servicesに取り込むかを決定することです。 Intelligent Servicesで使用されるすべての履歴データは、データの最小期間である4か月間に加えて、ルックバック期間として意図された日数を含める必要があります。

送信するデータの範囲を決定したら、Adobe Consulting サービスに連絡して、データをスキーマにマッピングし、サービスに取り込むお手伝いをします。

Adobe Experience Platform サブスクリプションを所有しており、自分でデータをマッピングして取り込む場合は、以下の節で説明する手順に従います。

Adobe Experience Platformの使用

NOTE
以下の手順では、Experience Platformのサブスクリプションが必要です。 Experience Platformへのアクセス権がない場合は、次の手順 セクションに進みます。

このセクションでは、Intelligent Servicesで使用するためのExperience Platformへのデータのマッピングと取り込みのワークフローの概要と、詳細な手順に関するチュートリアルへのリンクを示します。

CEE スキーマとデータセットの作成

取り込み用のデータの準備を開始する準備ができたら、最初の手順は、CEE フィールドグループを採用する新しいXDM スキーマを作成することです。 次のチュートリアルでは、UIまたはAPIで新しいスキーマを作成するプロセスについて説明します。

IMPORTANT
上記のチュートリアルは、スキーマを作成するための一般的なワークフローに従っています。 スキーマのクラスを選択する場合は、XDM ExperienceEvent クラス​を使用する必要があります。 このクラスを選択したら、CEE フィールドグループをスキーマに追加できます。

スキーマにCEE フィールドグループを追加した後、データ内の追加フィールドに必要に応じて他のフィールドグループを追加できます。

スキーマを作成して保存したら、そのスキーマに基づいて新しいデータセットを作成できます。 次のチュートリアルでは、UIまたはAPIで新しいデータセットを作成するプロセスについて説明します。

データセットを作成した後、データセット ワークスペース内のExperience Platform UIでデータセットを見つけることができます。

データセットにID フィールドを追加する

Adobe Audience Manager、Adobe Analyticsまたはその他の外部ソースからデータを取り込む場合は、スキーマフィールドをID フィールドとして設定するオプションがあります。 スキーマフィールドをID フィールドとして設定するには、UI チュートリアル ​またはAPI チュートリアル ​内のID フィールドの設定に関する節を参照して、スキーマを作成します。

ローカル CSV ファイルからデータを取り込む場合は、​ データのマッピングと取り込みに関する次の節に進むことができます。

データのマッピングと取り込み ingest

CEE スキーマとデータセットを作成したら、データテーブルのスキーマへのマッピングを開始し、そのデータをExperience Platformに取り込むことができます。 UIでこれを実行する手順については、XDM スキーマへのCSV ファイルのマッピング ​に関するチュートリアルを参照してください。 独自のデータを使用する前に、次の​ サンプル JSON ファイル ​を使用して、取り込みプロセスをテストできます。

データセットにデータを入力すると、同じデータセットを使用して追加のデータファイルを取り込むことができます。

データがサポート対象のサードパーティアプリケーションに保存されている場合は、​ ソースコネクタ ​を作成して、マーケティングイベントデータをExperience Platformにリアルタイムで取り込むこともできます。

次の手順 next-steps

このドキュメントでは、Intelligent Servicesで使用するためのデータの準備に関する一般的なガイダンスを提供しました。 ユースケースに応じてさらにコンサルティングが必要な場合は、Adobe Consulting サポートにお問い合わせください。

顧客体験データをデータセットに正常に入力したら、Intelligent Servicesを使用してインサイトを生成できます。 開始するには、次のドキュメントを参照してください。

recommendation-more-help
experience-platform-help-intelligent-services