ストリーミングデータの取り込みと使用

このクイックスタートガイドでは、ストリーミングデータを 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 で​ プロジェクトを設定 ​して、レポートとビジュアライゼーションを作成します。

NOTE
このクイックスタートガイドは、ストリーミングデータをAdobe Experience Platformに取り込み、Customer Journey Analyticsで使用する方法を説明する簡単なガイドです。 参照する際には、追加情報を調べることを強くお勧めします。

スキーマとデータセットの設定

データをAdobe Experience Platformに取り込むには、まず収集するデータを定義する必要があります。 ダウンストリームの機能で認識し、処理するには、Adobe Experience Platform に取り込まれるすべてのデータが、標準的な非正規化された構造に準拠する必要があります。エクスペリエンスデータモデル(XDM)は、この構造をスキーマの形式で提供する標準フレームワークです。

スキーマを定義したら、1 つ以上のデータセットを使用して、データの収集を保存および管理します。データセットは、スキーマ(列)とフィールド(行)を含んだデータのコレクション(通常はテーブル)のストレージおよび管理用の構成体です。

Adobe Experience Platform に取り込まれるすべてのデータは、データセットとして保持する前に、事前定義済みのスキーマに準拠している必要があります。

スキーマの設定

このクイックスタートでは、ロイヤルティ ID、ロイヤルティポイント、ロイヤルティステータスなど、一部のロイヤルティデータを収集します。まず、このデータをモデル化するスキーマを定義する必要があります。

スキーマを設定するには:

  1. Adobe Experience Platform UI の左パネルの「データ管理」で、「スキーマ」を選択します。

  2. スキーマを作成 を選択します。
    .

  3. スキーマ作成ウィザードの「クラスを選択」手順で、次の操作を行います。

    1. 個人プロファイル を選択します。

      スキーマ

      note info
      INFO
      エクスペリエンスイベントスキーマは、プロファイルの 動作 をモデル化するために使用します(シーン名、買い物かごに追加するプッシュボタンなど)。 個々のプロファイルスキーマは、プロファイル​_属性_(名前、メール、性別など)のモデル化に使用されます。
    2. 次へ」を選択します。

  4. ​ スキーマを作成 ​ ウィザードの ​ 名前とレビューの手順 ​ で、次の操作を行います。

    1. スキーマの スキーマ表示名 と(オプション) 説明 を入力します。

      スキーマに名前を付ける

    2. 完了」を選択します。

  5. 「スキーマ例の構造」タブで、次の操作を行います。

    1. 「フィールドグループ」で「+ 追加」を選択します。

      フィールドグループを追加

      フィールドグループは、スキーマを簡単に拡張できる、再利用可能なオブジェクトと属性のコレクションです。

    2. フィールドグループを追加ダイアログで、リストから「ロイヤルティの詳細」フィールドグループを選択します。

      AEP Web SDK ExperienceEvent フィールドグループ

      「プレビュー」ボタンを選択すると、このフィールドグループに属するフィールドのプレビューを確認できます。

      AEP Web SDK ExperienceEvent フィールドグループのプレビュー

      戻る」を選択してプレビューを閉じます。

    3. フィールドグループを追加」を選択します。

  6. 構造パネルで、スキーマ名の隣にある「+」をクリックします。

    スキーマ追加フィールドボタンの例

  7. 「フィールドプロパティ」パネルで、名前に Identification、表示名に​ ID と入力し、タイプで​ オブジェクト、フィールドグループで Profile Core v2 を選択します。

    ID オブジェクト

    この id オブジェクトは、スキーマに ID 機能を追加します。 その場合は、バッチデータのメールアドレスを使用してロイヤルティ情報を識別します。

    適用」を選択して、このオブジェクトをスキーマに追加します。

  8. 先ほど追加した ID オブジェクトで「メール」フィールドをクリックし、フィールドプロパティパネルのID 名前空間から ID と​ メール ​を選択します。

    メールを ID として指定

    メールアドレスを、Adobe Experience Platform Identity Service がプロファイルの動作を組み合わせる(ステッチする)ために使用する ID として指定します。

    適用」を選択します。メール属性にフィンガープリントアイコンが表示されます。

  9. (スキーマ名を使用して)スキーマのルートレベルを選択してから、プロファイル ​スイッチをクリックします。

    プロファイルのスキーマを有効にするよう求められます。有効にすると、このスキーマに基づくデータセットにデータが取り込まれたときに、そのデータをリアルタイム顧客プロファイルと結合します。

    詳しくは、リアルタイム顧客プロファイルで使用するスキーマを有効にするを参照してください。

    note important
    IMPORTANT
    プロファイルで有効にしたスキーマを保存すると、そのスキーマはプロファイルで無効にできなくなります。

    プロファイルでスキーマを有効にする

  10. 保存」を選択してスキーマを保存します。

Adobe Experience Platform に取り込むロイヤルティデータをモデル化する最小限のスキーマを作成しました。このスキーマを使用すると、メールアドレスを使用してプロファイルを識別できます。プロファイルのスキーマを有効にすると、ストリーミングソースのデータがリアルタイム顧客プロファイルへと確実に追加されます。

フィールドグループと個々のフィールドをスキーマに追加、またはスキーマから削除する方法について詳しくは、UI でのスキーマの作成と編集を参照してください。

データセットの設定

スキーマを使用して、データモデルを定義しました。次に、そのデータを保存および管理するための構成を定義する必要があります。これは、データセットを通じて行われます。

データセットを設定するには:

  1. Adobe Experience Platform UI の左パネルの「データ管理」で、「データセット」を選択します。

  2. データセットを作成」を選択します。

    データセットの作成

  3. スキーマからデータセットを作成」をクリックします。

    スキーマからのデータセットの作成

  4. 作成したスキーマを選択し、「次へ」を選択します。

  5. データセットに名前を付け、(オプション)説明を入力します。

    名前データセット

  6. 完了」を選択します。

  7. プロファイル」スイッチを選択します。

    プロファイルのデータセットを有効にするよう求められます。有効にすると、データセットは、取り込んだデータを使用してリアルタイム顧客プロファイルを強化します。

    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 ソースコネクタを作成するには:

  1. Experience Platform UI の左パネルで、「接続」から「ソース」を選択します。

  2. 「カテゴリ」のリストから「ストリーミング」を選択します。

  3. HTTP API タイルで「設定」を選択します。

    HTTP API タイルの設定

  4. データを追加画面の認証手順で、次の操作を行います。

    HTTP API 接続の名前と説明を入力します。

    XDM 互換」を選択して、ストリーミングするデータに、既存の XDM スキーマとの互換性があることを示します。

    ソースに接続」を選択します。接続が成功すると、「接続済み」と表示されます。

    HTTP API 認証

    次へ」をクリックして続行します。

  5. データを追加画面のデータフローの詳細手順で、次の操作を行います。

    既存のデータセット」でデータセットリストからデータセットを選択し、データフロー名を指定します。

    データフローの詳細

    次へ」を選択します。

  6. データを追加画面のレビュー手順には、HTTP API 接続の概要が表示されます。

    データフローの詳細

    完了」を選択します。

  7. 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のデータセット間で接続を確立する必要があります。

接続を作成するには:

  1. Customer Journey Analytics UI で、「接続」をクリックします。

  2. 新しい接続を作成」を選択します。

  3. 名称未設定の接続画面で、次の手順を実行します。

    「接続設定」で接続に名前を付けて説明します。

    データ設定のサンドボックスリストから適切なサンドボックスを選択し、毎日のイベントの平均数リストから日次イベントの数を選択します。

    接続設定

    データセットを追加」を選択します。

    「データセットを追加」の「データセットを選択」手順で、次の操作を行います。

    • 先ほど作成したデータセット(Example Loyalty Dataset)や、接続に含める他のデータセットに関連付けます。

      データセットを追加

    • 次へ」を選択します。

    「データセットを追加」の「データセット設定」手順で、次の操作を行います。

    • 各データセットに対して、次の手順を行います。

      • Adobe Experience Platform のデータセットスキーマで定義されている使用可能な ID からユーザー ID を選択します。

      • データソースタイプリストから正しいデータソースを選択します。「その他」を指定している場合は、データソースの説明を追加します。

      • 必要に応じて​ すべての新しいデータを読み込み ​および​ データセットの既存データのバックフィル ​を選択します。

      データセットの設定

    • データセットを追加」を選択します。

    保存」を選択します。

接続を作成および管理する方法、およびデータセットを選択して組み合わせる方法について詳しくは、接続の概要を参照してください。

データ表示の設定

データ表示は、Customer Journey Analytics に特有のコンテナで、接続からデータを解釈する方法を決定できます。Analysis Workspace で使用可能なすべてのディメンションと指標、およびこれらのディメンションと指標からデータを取得する列を指定します。データ表示は、Analysis Workspace でレポートの準備を行う際に定義します。

データ表示を作成するには:

  1. Customer Journey Analytics UI の上部ナビゲーションで、「データ表示」をクリックします。

  2. 新しいデータ表示を作成」を選択します。

  3. 設定手順で、次の操作を行います。

    接続リストで接続を選択します。

    接続に名前を付け、(オプションで)説明します。

    データ表示の設定

    保存して続行」を選択します。

  4. コンポーネント手順で、次の操作を行います。

    指標またはディメンションコンポーネントボックスに含めるスキーマフィールドや標準コンポーネントを追加します。

    データ表示コンポーネント

    保存して続行」を選択します。

  5. 設定手順で、次の操作を行います。

    データ表示設定

    設定をそのままにし、「保存して終了」を選択します。

データ表示の作成および編集方法、データ表示で使用できるコンポーネント、フィルターおよびセッションの設定の使用方法について詳しくは、データ表示の概要を参照してください。

プロジェクトの設定

Analysis Workspace は、データに基づき、分析をすばやく構築してインサイトを共有できる、柔軟なブラウザーツールです。ワークスペースプロジェクトでは、データコンポーネント、テーブル、およびビジュアライゼーションを組み合わせて、分析を作成し、組織内の任意のユーザーと共有できます。

プロジェクトを作成するには:

  1. Customer Journey Analytics UI で、「プロジェクト」をクリックします。

  2. 左側のナビゲーションの「プロジェクト」を選択します。

  3. プロジェクトを作成」を選択します。

    ワークスペースプロジェクト

    空のプロジェクト」を選択します。

    ワークスペース - 空のプロジェクト

  4. リストからデータ表示を選択します。

    ワークスペースでデータ表示を選択 します。

  5. 最初のレポートを作成するには、​ パネル ​ の ​ フリーフォームテーブル ​ でディメンションと指標のドラッグ&ドロップを開始します。 例えば、Program Points Balance および Page View 指標、email をディメンションにドラッグすると、web サイトを訪問し、ロイヤルティポイントを収集するロイヤルティプログラムに参加しているプロファイルの概要をすばやく把握できます。

    ワークスペース - 最初のレポート

コンポーネント、ビジュアライゼーション、パネルを使用してプロジェクトを作成し、分析を構築する方法について詳しくは、Analysis Workspace の概要を参照してください。

SUCCESS
すべての手順が完了しました。まずどのロイヤルティデータ(スキーマ)を収集するか、Adobe Experience Platform 内のどこにそのデータセットを保存するかを定義して、データセットに直接ロイヤルティデータをストリーミングするよう HTTP API ソースコネクタを設定しました。データ表示の定義では、使用するディメンションと指標を指定でき、最後に、最初のプロジェクトを作成し、データを視覚化および分析します。
recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79