Edge Network Server APIを介したデータの取り込み
このクイックスタートガイドでは、Adobe Experience Platform Edge Network Server APIとEdge Networkを使用して、IoT デバイス、セットトップボックス、ゲーム機、デスクトップアプリケーションなどのデバイスからAdobe Experience Platformにトラッキングデータを直接取り込む方法について説明します。 そのデータをCustomer Journey Analyticsで使用し。
これを実現するには、次の操作を実行する必要があります。
-
Adobe Experience Platform で スキーマとデータセットを設定 し、収集するデータのモデル（スキーマ）と、実際にデータ（データセット）を収集する場所を定義します。
-
データストリームの設定：収集したデータを Adobe Experience Platform で設定したデータセットにルーティングするように Adobe Experience Platform Edge Network を設定します。
-
サーバーAPIを使用して、デスクトップ、ゲーム コンソール、IoT デバイス、またはセットトップボックスで実行されているアプリケーションまたはゲームから直接データストリームにデータを送信します。
-
デプロイと検証を行います。 開発作業を繰り返し実行し、すべての検証が完了したら、本番環境で公開できます。
-
Customer Journey Analytics で、接続を設定します。 この接続には、（少なくとも）Adobe Experience Platform データセットを含める必要があります。
-
Customer Journey Analytics で データ表示を設定 し、Analysis Workspace で使用する指標とディメンションを定義します。
-
Customer Journey Analytics で プロジェクトを設定 して、レポートとビジュアライゼーションを作成します。
スキーマとデータセットの設定
Adobe Experience Platformにデータを取り込むには、まず、収集するデータを定義する必要があります。 ダウンストリームの機能で認識し、処理するには、Adobe Experience Platform に取り込まれるすべてのデータが、標準的な非正規化された構造に準拠する必要があります。 Experience Data Model （XDM）は、スキーマの形式で構造を提供する標準フレームワークです。
スキーマを定義したら、1 つ以上のデータセットを使用して、データのコレクションを保存および管理します。 データセットは、スキーマ（列）とフィールド（行）を含むデータのコレクション（通常はテーブル）のストレージおよび管理構造です。
Adobe Experience Platform に取り込まれるすべてのデータは、データセットとして保持する前に、事前定義済みのスキーマに準拠している必要があります。
スキーマを設定する
コンソールでゲームをプレイしているプロファイルから、識別、スコア、進行状況などの最小限のデータを追跡する必要があります。
まず、このデータをモデル化するスキーマを定義する必要があります。
スキーマを設定するには：
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「スキーマ」を選択します。
-
「スキーマを作成」を選択します。
. -
スキーマを作成ウィザードの「クラスを選択」ステップで、次の操作を行います。
-
「エクスペリエンスイベント」を選択します。
note info INFO エクスペリエンスイベントスキーマを使用すると、プロファイルの_動作_（シーン名、買い物かごに追加するプッシュボタンなど）をモデル化できます。 個々のプロファイルスキーマは、プロファイル_属性_（名前、メール、性別など）のモデル化に使用されます。 -
「次へ」を選択します。
-
-
スキーマを作成ウィザードの名前とレビューの手順で、次の操作を行います。
-
スキーマの スキーマ表示名 と説明（オプション）を入力します。
-
「完了」を選択します。
-
-
「スキーマの例」の「構造」タブで、次の操作を行います。
-
「フィールドグループ」で「+ 追加」を選択します。
フィールドグループは、スキーマを簡単に拡張できる、再利用可能なオブジェクトと属性のコレクションです。
-
フィールドグループを追加 ダイアログで、リストからブラインドライト フィールドグループを選択します。 このフィールドグループは、コンソールで「Blinding Light」というタイトルの架空のゲームをプレイしているユーザーの進捗状況を追跡するために作成されました。
「プレビュー」ボタンを選択すると、このフィールドグループに属するフィールド（
scores > afterMatchなど）のプレビューを表示できます。
「戻る」を選択してプレビューを閉じます。
-
「フィールドグループを追加」を選択します。
-
-
スキーマ名の横にある + を選択します。
-
フィールドプロパティ パネルで、
identificationを フィールド名として、識別を表示名として入力し、オブジェクトを タイプ として選択し、ExperienceEvent Core v2.1を フィールドグループ として選択します。note NOTE このフィールドグループが使用できない場合は、ID フィールドを含む別のフィールドグループを検索します。 または、フィールドグループに新しいフィールドグループを作成し、（ ecid、crmIdなど）新しい ID フィールドを追加して、この新しいフィールドグループを選択します。
ID オブジェクトは、スキーマに ID 機能を追加します。 この場合は、Experience Cloud IDとゲームコンソールへのログインに使用するメールアドレスを使用して、ゲームをプレイしているプロファイルを特定する必要があります。 個人の識別を追跡するために使用できる他の多くの属性があります。
「適用」を選択して、このオブジェクトをスキーマに追加します。
-
先ほど追加した ID オブジェクトで「ecid」フィールドをクリックし、右パネルの ID 名前空間リストから ID、プライマリ ID および ECID を選択します。
Experience Cloud ID を、Adobe Experience Platform Identity Service（ID サービス）が同じ ECID を持つプロファイルの動作を組み合わせる（ステッチする）ために使用するプライマリ ID として指定します。
「適用」を選択します。 ecid 属性にフィンガープリントアイコンが表示されます。
-
先ほど追加した ID オブジェクトで「メール」フィールドをクリックし、フィールドプロパティパネルのID 名前空間リストから ID と メール を選択します。
メールアドレスを、Adobe Experience Platform Identity Service（ID サービス）がプロファイルの動作を組み合わせる（ステッチする）ために使用するもう 1 つの ID として指定します。
「適用」を選択します。 メール属性にフィンガープリントアイコンが表示されます。
「保存」を選択します。
-
スキーマの名前を表示しているスキーマのルート要素を選択してから、プロファイルスイッチをクリックします。
プロファイルのスキーマを有効にするよう求められます。 有効にすると、このスキーマに基づくデータセットにデータが取り込まれたときに、そのデータをリアルタイム顧客プロファイルと結合します。
詳しくは、リアルタイム顧客プロファイルで使用するスキーマを有効にするを参照してください。
note important IMPORTANT プロファイルで有効にしたスキーマを保存すると、そのスキーマはプロファイルで無効にできなくなります。 
-
「保存」を選択してスキーマを保存します。
ゲームから取得できるデータをモデル化する最小限のスキーマを作成しました。 このスキーマを使用することで、Experience Cloud ID とメールアドレスを使用してプロファイルを識別できます。 プロファイルのスキーマを有効にすると、コンソールゲームからキャプチャしたデータがリアルタイム顧客プロファイルに追加されます。
ビヘイビアーデータの横に、コンソールからプロファイル属性データを取り込むこともできます（コンソールにサインインしているプロファイルの詳細など）。
プロファイルデータをキャプチャするには、次のことをおこないます。
-
XDM Individual Profile クラスに基づいてスキーマを作成します。
-
Profile Core v2 フィールドグループをスキーマに追加します。
-
Profile Core v2 フィールドグループに基づいて識別オブジェクトを追加します。
-
Experience Cloud ID をプライマリ識別子として定義し、メールを識別子として定義します。
-
プロファイル用にスキーマを有効にする
フィールドグループと個々のフィールドをスキーマに追加、またはスキーマから削除する方法について詳しくは、UI でのスキーマの作成と編集を参照してください。
データセットの設定
スキーマを使用して、データモデルを定義しました。 データセットを使用して、そのデータを保存および管理するための構造を定義する必要があります。
データセットを設定するには、次の手順を実行します。
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「データセット」を選択します。
-
「データセットを作成」を選択します。
-
「スキーマからデータセットを作成」をクリックします。
-
作成したスキーマを選択し、「次へ」を選択します。
-
データセットに名前を付け、（オプション）説明を入力します。
-
「完了」を選択します。
-
「プロファイル」スイッチを選択します。
プロファイル用にデータセットを有効にするよう求めるプロンプトが表示されます。 有効にすると、データセットは、取り込んだデータを使用してリアルタイム顧客プロファイルを強化します。
note important IMPORTANT プロファイルのデータセットを有効にできるのは、データセットが準拠するスキーマがプロファイルに対しても有効になっている場合のみです。 
データセットの表示、プレビュー、作成、削除の方法について詳しくは、データセット UI ガイドを参照してください。 リアルタイム顧客プロファイルのデータセットを有効にする方法について説明します。
データストリームの設定
データストリームは、Adobe Experience Platform Web と Mobile SDK、および Adobe Experience Platform Edge Network Server API を実装する際のサーバーサイド設定を表します。 Adobe Experience Platform SDKとEdge Network Server APIを使用してデータを収集すると、データはAdobe Experience Platform Edge Networkに送信されます。 これは、データの転送先となるサービスを決定するデータストリームです。
設定では、ゲームから収集したデータをAdobe Experience Platformのデータセットに送信する必要があります。
データストリームを設定するには：
-
Adobe Experience Platform UI の左パネルで、「データ収集」から「データストリーム」を選択します。
-
新しいデータストリームを選択します。
-
データストリームに名前を付けて説明します。 イベントスキーマリストからスキーマを選択します。
-
「保存」を選択します。
-
「サービスを追加」を選択します。
-
サービスを追加画面で、次の操作を行います。
-
サービスリストからAdobe Experience Platform を選択します。
-
「有効」が選択されていることを確認します。
-
イベントデータセットリストからお使いのデータセットを選択します。
-
その他の設定はそのままにし、「保存」を選択してデータストリームを保存します。
-
これで、ゲームから収集したデータをAdobe Experience Platformのデータセットに転送するようにデータストリームが設定されました。
データストリームの設定方法と機密データの処理方法について詳しくは、データストリームの概要を参照してください。
Edge Network Server APIの使用
ゲームの開発では、必要に応じてAdobe Experience Platform Edge Network Server APIに関連する呼び出しを追加できます。
例えば、プレーヤーのスコアを更新するには、次を使用します。
curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
"event": {
"xdm": {
"identityMap": {
"Email_LC_SHA256": [
{
"id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
"primary": true
}
]
},
"eventType": "game.scoreUpdate",
"{sandbox}": {
"scores": {
"afterMatch": 132391",
}
},
"timestamp": "2021-08-09T14:09:20.859Z"
}
}
}'
POST リクエストの例では、{DATASTREAM_ID}は先ほど設定したデータストリームの例の識別子を指します。 {sandbox}は、カスタムブラインドライトフィールドグループへのパスを識別するサンドボックスの一意の名前です。
Edge Network Server APIの使用方法について詳しくは、 インタラクティブデータ収集および非インタラクティブデータ収集を参照してください。
接続の設定
Adobe Experience Platform データを Customer Journey Analytics で使用するには、接続（スキーマ、データセット、ワークフローの設定によって生成されたデータを含む）を作成します。
接続を使用すれば、Adobe Experience Platform のデータセットをワークスペースに統合できます。 これらのデータセットについてレポートを作成するには、まずAdobe Experience PlatformとWorkspaceのデータセット間の接続を確立する必要があります。
接続を作成するには：
-
Customer Journey Analytics UIの上部メニューで、Data managementから Connections を選択します（オプション）。
-
「新しい接続を作成」を選択します。
-
名称未設定の接続画面で、次の手順を実行します。
「接続設定」で接続に名前を付けて説明します。
データ設定のサンドボックスリストから適切なサンドボックスを選択し、毎日のイベントの平均数リストから日次イベントの数を選択します。
「データセットを追加」を選択します。
「データセットを追加」の「データセットを選択」手順で、次の操作を行います。
-
以前に作成したデータセットや、接続に含める関連データセットを選択します
-
「次へ」を選択します。
「データセットを追加」の「データセット設定」手順で、次の操作を行います。
-
各データセットに対して、次の手順を行います。
-
Adobe Experience Platform のデータセットスキーマで定義されている使用可能な ID からユーザー ID を選択します。
-
データソースタイプリストから正しいデータソースを選択します。 「その他」を指定している場合は、データソースの説明を追加します。
-
必要に応じて すべての新しいデータを読み込み および データセットの既存データのバックフィル を選択します。
-
-
「データセットを追加」を選択します。
「保存」を選択します。
-
接続を作成および管理する方法、およびデータセットを選択して組み合わせる方法について詳しくは、接続の概要を参照してください。
データ表示の設定
データビューは、Customer Journey Analytics に特有のコンテナで、接続からのデータをどのように解釈するかを指定できます。 Analysis Workspace で使用可能なすべてのディメンションと指標、およびこれらのディメンションと指標からデータを取得する列を指定します。 データビューは、Analysis Workspace でレポートの準備を行う際に定義します。
データビューを作成するには：
-
Customer Journey Analytics UIの上部メニューで、データビュー （オプションで データ管理 から）を選択します。
-
「新しいデータ表示を作成」を選択します。
-
設定手順で、次の操作を行います。
接続リストで接続を選択します。
接続に名前を付け、（オプションで）説明します。
「保存して続行」を選択します。
-
コンポーネント手順で、次の操作を行います。
指標またはディメンションコンポーネントボックスに含めるスキーマフィールドや標準コンポーネントを追加します。
「保存して続行」を選択します。
-
設定手順で、次の操作を行います。
設定をそのままにし、「保存して終了」を選択します。
データビューの作成と編集方法、データビューで使用できるコンポーネント、セグメントとセッションの設定の使用方法について詳しくは、 データビューの概要を参照してください。
プロジェクトの設定
Analysis Workspace は、データに基づき、分析をすばやく構築してインサイトを共有できる、柔軟なブラウザーツールです。 ワークスペースプロジェクトでは、データコンポーネント、テーブル、およびビジュアライゼーションを組み合わせて、分析を作成し、組織内の任意のユーザーと共有できます。
プロジェクトを作成するには：
-
Customer Journey Analytics UIで、上部メニューの「プロジェクト」を選択します。
-
左側のナビゲーションの「プロジェクト」を選択します。
-
「プロジェクトを作成」を選択します。
「空のプロジェクト」を選択します。
-
リストからデータビューを選択します。
-
最初のレポートを作成するには、 パネル の自由形式テーブル で、ディメンションと指標のドラッグ&ドロップを開始します。
コンポーネント、ビジュアライゼーション、パネルを使用してプロジェクトを作成し、分析を構築する方法について詳しくは、Analysis Workspace の概要を参照してください。