ストリーミングデータの取り込みと使用
このクイックスタートガイドでは、ストリーミングデータを Adobe Experience Platform に取り込んで、そのデータを Customer Journey Analytics で使用する方法について説明します。
これには、次の手順を実行する必要があります。
-
Adobe Experience Platform で スキーマとデータセットを設定 し、収集するデータのモデル(スキーマ)と、実際にデータ(データセット)を収集する場所を定義します。
-
HTTP API ソースコネクタを使用 し、Adobe Experience Platform で設定したデータセットへと簡単にデータをストリーミングできます。
-
Customer Journey Analytics で、接続を設定 します。この接続には、(少なくとも)Adobe Experience Platform データセットを含める必要があります。
-
Customer Journey Analytics で データ表示を設定 し、Analysis Workspace で使用する指標とディメンションを定義します。
-
Customer Journey Analytics で プロジェクトを設定 して、レポートとビジュアライゼーションを作成します。
スキーマとデータセットの設定
データをAdobe Experience Platformに取り込むには、まず収集するデータを定義する必要があります。 ダウンストリームの機能で認識し、処理するには、Adobe Experience Platform に取り込まれるすべてのデータが、標準的な非正規化された構造に準拠する必要があります。エクスペリエンスデータモデル(XDM)は、この構造をスキーマの形式で提供する標準フレームワークです。
スキーマを定義したら、1 つ以上のデータセットを使用して、データの収集を保存および管理します。データセットは、スキーマ(列)とフィールド(行)を含んだデータのコレクション(通常はテーブル)のストレージおよび管理用の構成体です。
Adobe Experience Platform に取り込まれるすべてのデータは、データセットとして保持する前に、事前定義済みのスキーマに準拠している必要があります。
スキーマの設定
このクイックスタートでは、ロイヤルティ ID、ロイヤルティポイント、ロイヤルティステータスなど、一部のロイヤルティデータを収集します。まず、このデータをモデル化するスキーマを定義する必要があります。
スキーマを設定するには:
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「スキーマ」を選択します。
-
スキーマを作成 を選択します。
. -
スキーマ作成ウィザードの「クラスを選択」手順で、次の操作を行います。
-
個人プロファイル を選択します。
note info INFO エクスペリエンスイベントスキーマは、プロファイルの 動作 をモデル化するために使用します(シーン名、買い物かごに追加するプッシュボタンなど)。 個々のプロファイルスキーマは、プロファイル_属性_(名前、メール、性別など)のモデル化に使用されます。 -
「次へ」を選択します。
-
-
スキーマを作成 ウィザードの 名前とレビューの手順 で、次の操作を行います。
-
スキーマの スキーマ表示名 と(オプション) 説明 を入力します。
-
「完了」を選択します。
-
-
「スキーマ例の構造」タブで、次の操作を行います。
-
「フィールドグループ」で「+ 追加」を選択します。
フィールドグループは、スキーマを簡単に拡張できる、再利用可能なオブジェクトと属性のコレクションです。
-
フィールドグループを追加ダイアログで、リストから「ロイヤルティの詳細」フィールドグループを選択します。
「プレビュー」ボタンを選択すると、このフィールドグループに属するフィールドのプレビューを確認できます。
「戻る」を選択してプレビューを閉じます。
-
「フィールドグループを追加」を選択します。
-
-
構造パネルで、スキーマ名の隣にある「+」をクリックします。
-
「フィールドプロパティ」パネルで、名前に
Identification
、表示名に ID と入力し、タイプで オブジェクト、フィールドグループで Profile Core v2 を選択します。この id オブジェクトは、スキーマに ID 機能を追加します。 その場合は、バッチデータのメールアドレスを使用してロイヤルティ情報を識別します。
「適用」を選択して、このオブジェクトをスキーマに追加します。
-
先ほど追加した ID オブジェクトで「メール」フィールドをクリックし、フィールドプロパティパネルのID 名前空間から ID と メール を選択します。
メールアドレスを、Adobe Experience Platform Identity Service がプロファイルの動作を組み合わせる(ステッチする)ために使用する ID として指定します。
「適用」を選択します。メール属性にフィンガープリントアイコンが表示されます。
-
(スキーマ名を使用して)スキーマのルートレベルを選択してから、プロファイル スイッチをクリックします。
プロファイルのスキーマを有効にするよう求められます。有効にすると、このスキーマに基づくデータセットにデータが取り込まれたときに、そのデータをリアルタイム顧客プロファイルと結合します。
詳しくは、リアルタイム顧客プロファイルで使用するスキーマを有効にするを参照してください。
note important IMPORTANT プロファイルで有効にしたスキーマを保存すると、そのスキーマはプロファイルで無効にできなくなります。 -
「保存」を選択してスキーマを保存します。
Adobe Experience Platform に取り込むロイヤルティデータをモデル化する最小限のスキーマを作成しました。このスキーマを使用すると、メールアドレスを使用してプロファイルを識別できます。プロファイルのスキーマを有効にすると、ストリーミングソースのデータがリアルタイム顧客プロファイルへと確実に追加されます。
フィールドグループと個々のフィールドをスキーマに追加、またはスキーマから削除する方法について詳しくは、UI でのスキーマの作成と編集を参照してください。
データセットの設定
スキーマを使用して、データモデルを定義しました。次に、そのデータを保存および管理するための構成を定義する必要があります。これは、データセットを通じて行われます。
データセットを設定するには:
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「データセット」を選択します。
-
「データセットを作成」を選択します。
-
「スキーマからデータセットを作成」をクリックします。
-
作成したスキーマを選択し、「次へ」を選択します。
-
データセットに名前を付け、(オプション)説明を入力します。
-
「完了」を選択します。
-
「プロファイル」スイッチを選択します。
プロファイルのデータセットを有効にするよう求められます。有効にすると、データセットは、取り込んだデータを使用してリアルタイム顧客プロファイルを強化します。
note important IMPORTANT プロファイルのデータセットを有効にできるのは、データセットが準拠するスキーマがプロファイルに対しても有効になっている場合のみです。
データセットの表示、プレビュー、作成、削除の方法について詳しくは、データセット UI ガイドを参照してください。リアルタイム顧客プロファイルのデータセットを有効にする方法について説明します。
HTTP API ストリーミング接続の設定
ソースアプリケーションは、作成したスキーマに適合し、以下に示すデータをストリーミングします。
{
...
"_demosystem4": {
"identification": {
"core": {
"email": "abrocking0@blog.com",
"loyaltyId": "793406",
}
}
},
"loyalty": {
"loyaltyID": [
"793406"
],
"points": 82.16,
"status": "Silver"
}
...
}
作成したデータセットにこのデータをストリーミングするには、送信先のデータのストリーミングエンドポイントを定義する必要があります。 ストリーミングエンドポイントは、HTTP API ソースコネクタを使用して作成されます。
HTTP API ソースコネクタを作成するには:
-
Experience Platform UI の左パネルで、「接続」から「ソース」を選択します。
-
「カテゴリ」のリストから「ストリーミング」を選択します。
-
HTTP API タイルで「設定」を選択します。
-
データを追加画面の認証手順で、次の操作を行います。
HTTP API 接続の名前と説明を入力します。
「XDM 互換」を選択して、ストリーミングするデータに、既存の XDM スキーマとの互換性があることを示します。
「ソースに接続」を選択します。接続が成功すると、「接続済み」と表示されます。
「次へ」をクリックして続行します。
-
データを追加画面のデータフローの詳細手順で、次の操作を行います。
「既存のデータセット」でデータセットリストからデータセットを選択し、データフロー名を指定します。
「次へ」を選択します。
-
データを追加画面のレビュー手順には、HTTP API 接続の概要が表示されます。
「完了」を選択します。
-
HTTP API ストリーミングエンドポイントの最終的な定義が表示されます。
ストリーミングエンドポイント URL をコピーし、それを使用して、Adobe Experience Platform ロイヤルティデータセットにデータをストリーミングするようロイヤルティアプリケーションを設定できます。
以下を説明するさらに包括的なチュートリアルについては、UI を使用した HTTP API ストリーミング接続の作成を参照してください。
- 認証の使用方法
- 受信データと XDM スキーマに互換性がない場合にデータをマッピングする方法。
- ストリーミングコネクタの設定の一部としてデータセットを作成する方法。
接続の設定
Adobe Experience Platform データを Customer Journey Analytics で使用するには、接続(スキーマ、データセット、ワークフローの設定によって生成されたデータを含む)を作成します。
接続を使用すれば、Adobe Experience Platform のデータセットをワークスペースに統合できます。これらのデータセットに関するレポートを作成するには、まずAdobe Experience PlatformとWorkspaceのデータセット間で接続を確立する必要があります。
接続を作成するには:
-
Customer Journey Analytics UI で、「接続」をクリックします。
-
「新しい接続を作成」を選択します。
-
名称未設定の接続画面で、次の手順を実行します。
「接続設定」で接続に名前を付けて説明します。
データ設定のサンドボックスリストから適切なサンドボックスを選択し、毎日のイベントの平均数リストから日次イベントの数を選択します。
「データセットを追加」を選択します。
「データセットを追加」の「データセットを選択」手順で、次の操作を行います。
-
先ほど作成したデータセット(
Example Loyalty Dataset
)や、接続に含める他のデータセットに関連付けます。 -
「次へ」を選択します。
「データセットを追加」の「データセット設定」手順で、次の操作を行います。
-
各データセットに対して、次の手順を行います。
-
Adobe Experience Platform のデータセットスキーマで定義されている使用可能な ID からユーザー ID を選択します。
-
データソースタイプリストから正しいデータソースを選択します。「その他」を指定している場合は、データソースの説明を追加します。
-
必要に応じて すべての新しいデータを読み込み および データセットの既存データのバックフィル を選択します。
-
-
「データセットを追加」を選択します。
「保存」を選択します。
-
接続を作成および管理する方法、およびデータセットを選択して組み合わせる方法について詳しくは、接続の概要を参照してください。
データ表示の設定
データ表示は、Customer Journey Analytics に特有のコンテナで、接続からデータを解釈する方法を決定できます。Analysis Workspace で使用可能なすべてのディメンションと指標、およびこれらのディメンションと指標からデータを取得する列を指定します。データ表示は、Analysis Workspace でレポートの準備を行う際に定義します。
データ表示を作成するには:
-
Customer Journey Analytics UI の上部ナビゲーションで、「データ表示」をクリックします。
-
「新しいデータ表示を作成」を選択します。
-
設定手順で、次の操作を行います。
接続リストで接続を選択します。
接続に名前を付け、(オプションで)説明します。
「保存して続行」を選択します。
-
コンポーネント手順で、次の操作を行います。
指標またはディメンションコンポーネントボックスに含めるスキーマフィールドや標準コンポーネントを追加します。
「保存して続行」を選択します。
-
設定手順で、次の操作を行います。
設定をそのままにし、「保存して終了」を選択します。
データ表示の作成および編集方法、データ表示で使用できるコンポーネント、フィルターおよびセッションの設定の使用方法について詳しくは、データ表示の概要を参照してください。
プロジェクトの設定
Analysis Workspace は、データに基づき、分析をすばやく構築してインサイトを共有できる、柔軟なブラウザーツールです。ワークスペースプロジェクトでは、データコンポーネント、テーブル、およびビジュアライゼーションを組み合わせて、分析を作成し、組織内の任意のユーザーと共有できます。
プロジェクトを作成するには:
-
Customer Journey Analytics UI で、「プロジェクト」をクリックします。
-
左側のナビゲーションの「プロジェクト」を選択します。
-
「プロジェクトを作成」を選択します。
「空のプロジェクト」を選択します。
-
リストからデータ表示を選択します。
します。
-
最初のレポートを作成するには、 パネル の フリーフォームテーブル でディメンションと指標のドラッグ&ドロップを開始します。 例えば、
Program Points Balance
およびPage View
指標、email
をディメンションにドラッグすると、web サイトを訪問し、ロイヤルティポイントを収集するロイヤルティプログラムに参加しているプロファイルの概要をすばやく把握できます。
コンポーネント、ビジュアライゼーション、パネルを使用してプロジェクトを作成し、分析を構築する方法について詳しくは、Analysis Workspace の概要を参照してください。