Intelligent Servicesで使用するデータを準備する

Intelligent Servicesがマーケティングイベントデータからインサイトを見つけるには、データがセマンティックにエンリッチメントされ、標準構造で維持されている必要があります。 Intelligent Services (XDM) Experience Data Model スキーマを活用して、これを実現します。特に、Intelligent Servicesで使用されるすべてのデータセットは、Consumer ExperienceEvent(CEE)XDMスキーマに準拠しているか、Adobe Analyticsコネクタを使用している必要があります。 また、顧客AIはAdobe Audience Managerコネクタをサポートします。

このドキュメントでは、マーケティングイベントデータを複数のチャネルからCEEスキーマにマッピングする際の一般的なガイダンスを提供し、スキーマ内の重要なフィールドに関する情報を概要として、データを構造に効果的にマッピングする方法を決定します。 Adobe Analyticsデータを使用する予定がある場合は、Adobe Analyticsデータの準備の節を参照してください。 Adobe Audience Managerデータ(顧客AIのみ)を使用する予定がある場合は、AdobeAudience Managerデータの準備の節を参照してください。

データ要件

Intelligent Services では、作成する目標に応じて、様々な量の履歴データが必要です。すべての Intelligent Servicesに対して準備するデータには、ポジティブとネガティブの両方のカスタマージャーニー/イベントを含める必要があります。 負のイベントと正のイベントの両方を持つことで、モデルの精度と精度が向上します。

例えば、顧客AIを使用して製品を購入する傾向を予測する場合、顧客AIのモデルには、成功した購入パスの例と失敗したパスの例の両方が必要です。 これは、モデルトレーニングの間、顧客AIは、購入につながるイベントやジャーニーを把握しようとするからです。 また、購入しなかった顧客が実行するアクション(買い物かごへの項目の追加を停止した個人など)も含まれます。 これらの顧客は同様の行動を示す場合がありますが、顧客AIはインサイトを提供し、傾向スコアを高める主な違いと要因を掘り下げることができます。 同様に、Attribution AIでは、タッチポイントの効果、上位のコンバージョンパス、タッチポイント位置による分類などの指標を表示するために、両方のタイプのイベントとジャーニーが必要です。

過去のAttribution AI要件のその他の例と情報については、入出力ドキュメントの顧客AIまたはデータ履歴データの要件の節を参照してください。

データの結び付けのガイドライン

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

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

ワークフローの概要

準備プロセスは、データがAdobe Experience Platformに格納されているか外部に格納されているかによって異なります。 この節では、どちらのシナリオでも、実行する必要がある手順の概要を説明します。

外部データの準備

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

使用するIntelligent Serviceに応じて、異なるフィールドが必要な場合があります。 データを使用できる場合は、フィールドにデータを追加することをお勧めします。 必須フィールドについて詳しくは、『Attribution AI』または『顧客AI入力/出力ガイド』を参照してください。

Adobe Analyticsデータの準備

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

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

重要

Adobe Analyticsコネクタを使用する場合、データのバックフィルには最大4週間かかります。 接続を最近設定した場合は、顧客またはAttribution AIに必要な最小長のデータがデータセットに含まれていることを確認してください。 顧客AIまたはAttribution AIの履歴データの節を確認し、予測目標に十分なデータがあることを確認してください。

Adobe Audience Managerデータの準備(顧客AIのみ)

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

ソースコネクタがデータをExperience Platformにストリーミングすると、顧客AIの設定時に、Adobe Audience Managerをデータソースとして選択し、その後にデータセットを選択できます。 すべてのスキーマフィールドグループと個々のフィールドは、接続の設定時に自動的に作成されます。 データセットをCEE形式にETL(抽出、変換、読み込み)する必要はありません。

重要

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

Experience Platform データの準備

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

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

CEEスキーマについて

「消費者エクスペリエンスイベント」スキーマは、デジタルマーケティングイベント(Webまたはモバイル)、オンラインまたはオフラインのコマースアクティビティに関連する個人の行動を記述します。 Intelligent Servicesでは、意味的に適切に定義されたフィールド(列)があるので、このスキーマを使用する必要があります。そうしないと、データを明確にしなくなる不明な名前を避けることができます。

CEEスキーマは、すべてのXDM ExperienceEventスキーマと同様に、イベント(または一連のイベント)が発生したときのシステムの時系列ベースの状態(ポイントインタイム、関係する主体のIDなど)をキャプチャします。 エクスペリエンスイベントは、何が発生したかの事実の記録なので、不変で、何が発生したかを集計や解釈なしで表します。

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

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

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

キーフィールド

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

必須フィールド

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

プライマリID

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

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

  • "電子メール"
  • "phone"
  • 「mcid」(Adobe Audience Manager IDの場合)
  • 「aaid」(Adobe Analytics IDの場合)

プライマリIDとして使用する必要があるフィールドが不明な場合は、Adobeコンサルティングサービスに問い合わせて、最適なソリューションを決定してください。 プライマリIDが設定されていない場合、インテリジェントサービスアプリケーションは次のデフォルト動作を使用します。

デフォルト Attribution AI 顧客 AI
ID列 endUserIDs._experience.aaid.id endUserIDs._experience.mcid.id
名前空間 AAID ECID

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

スキーマに移動

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

フィールドの選択

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

チェックボックスを選択

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

変更を保存します。

xdm:timestamp

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

xdm:channel

メモ

このフィールドは、Attribution AIを使用する場合にのみ必須です。

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

スキーマの例

{
  "@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に必要な各サブフィールドに関する詳細は、エクスペリエンスチャネルスキーマの仕様を参照してください。 一部のマッピング例については、🔗の下のテーブルを参照してください。

チャネルマッピングの例

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

チャネル @type mediaType mediaAction
有料検索 https://ns.adobe.com/xdm/channel-types/search 有料 clicks
ソーシャル — マーケティング https://ns.adobe 獲得した clicks
表示 https://ns.adobe.com/xdm/channel-types/display 有料 clicks
メール https://ns.adobe.com/xdm/channel-types/email 有料 clicks
内部リファラー https://ns.adobe.com/xdm/channel-types/direct 所有 clicks
Display ViewThrough https://ns.adobe.com/xdm/channel-types/display 有料 impressions
QRコードのリダイレクト https://ns.adobe.com/xdm/channel-types/direct 所有 clicks
Mobile https://ns.adobe.com/xdm/channel-types/mobile 所有 clicks

推奨フィールド

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

xdm:productListItems

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

スキーマの例

[
  {
    "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: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の詳細を表します。

スキーマの例

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

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

スキーマの例

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

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

データのマッピングと取得

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

送信するデータの範囲を決定したら、Adobeコンサルティングサービスに連絡して、データをスキーマにマッピングし、サービスに取り込むのに役立ちます。

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

Adobe Experience Platformの使用

メモ

以下の手順では、購読登録が必要です。Experience Platform Platformにアクセスできない場合は、次の手順🔗の節に進んでください。

この節では、Intelligent Servicesで使用するデータをマッピングしExperience Platformに取り込むワークフローについて説明します。詳細な手順に関するチュートリアルへのリンクも含まれます。

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

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

重要

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

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

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

データセットを作成したら、Platform UIの​「データセット 」ワークスペースで確認できます。

データセットへのIDフィールドの追加

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

ローカルのCSVファイルからデータを取り込む場合は、マッピングとデータの取り込みに関する次の節に進んでください。

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

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

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

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

次の手順

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

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

このページ