ドキュメントExperience PlatformWeb SDK チュートリアル

Web SDK を使用したExperience Platformへのデータのストリーミング

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 初心者
  • 中級
  • 開発者

Platform Web SDK を使用して Adobe Experience Platform に web データをストリーミングする方法について説明します。

Experience Platformは、Adobe Real-time Customer Data Platform、Adobe Customer Journey Analytics、Adobe Journey Optimizerなど、すべての新しいExperience Cloudアプリケーションのバックボーンです。 これらのアプリケーションは、web データ収集の最適な方法として Platform Web SDK を使用するように設計されています。

Web SDK とAdobe Experience Platformの図

Experience Platformは、以前に作成したのと同じ XDM スキーマを使用して、Luma web サイトからイベントデータを取得します。 そのデータが Platform Edge Networkに送信されると、データストリーム設定はデータをExperience Platformに転送できます。

学習目標

このレッスンを最後まで学習すると、以下の内容を習得できます。

  • Adobe Experience Platform内でのデータセットの作成
  • Web SDK データをAdobe Experience Platformに送信するようにデータストリームを設定します
  • リアルタイム顧客プロファイル用のストリーミング web データを有効にする
  • データが Platform データセットとリアルタイム顧客プロファイルの両方に到達したことを検証します
  • Platform へのサンプルロイヤルティプログラムデータの取り込み
  • シンプルな Platform オーディエンスの作成

前提条件

このレッスンを完了するには、まず次の操作を行う必要があります。

  • Real-time Customer Data Platform、Journey Optimizer、Customer Journey AnalyticsなどのAdobe Experience Platform アプリケーションにアクセスできる
  • このチュートリアルの初期設定とタグの設定の節で前のレッスンを完了します。
NOTE
Platform アプリケーションがない場合は、このレッスンをスキップするか、先に読み進めることができます。

データセットの作成

Adobe Experience Platformに正常に取り込まれたすべてのデータは、データレイク内にデータセットとして保持されます。 データセットは、データのコレクション、通常、スキーマ（列）とフィールド（行）を含むテーブルのストレージおよび管理用の構成体です。 データセットには、保存するデータの様々な側面を記述したメタデータも含まれます。

Luma web イベントデータのデータセットを設定しましょう。

  1. Experience Platform または Journey Optimizer インターフェイスに移動します

  2. このチュートリアルに使用する開発用サンドボックスに属していることを確認します

  3. 左側のナビゲーションから データ管理/データセット を開きます

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

    スキーマを作成

  5. 「スキーマからデータセットを作成」オプションを選択します

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

  6. 前のレッスンで作成した Luma Web Event Data スキーマを選択し、「次へ」を選択します。

    データセット、スキーマを選択

  7. データセットの 名前 とオプションの 説明 を入力します。 この演習では、Luma Web Event Data を使用し、「終了」を選択します

    データセット名

これで、Platform Web SDK 実装からデータの収集を開始するようにデータセットが設定されました。

データストリームの設定

​ データストリーム ​ を設定して、Adobe Experience Platform にデータを送信できるようになりました。 データストリームは、タグプロパティ、Platform Edge Network、Experience Platformデータセットの間のリンクです。

  1. データ収集インターフェイスを開きます

  2. 左側のナビゲーションから データストリーム を選択します

  3. データストリームの設定のレッスン（）で作成したデータストリームを開きます Luma Web SDK

    Luma Web SDK データストリームを選択します

  4. 「サービスを追加」を選択します。
    データストリームへのサービスの追加

  5. Adobe Experience Platform を サービス として選択

  6. イベントデータセット として「Luma Web Event Data」を選択します

  7. 「保存」を選択します。

    データストリーム設定

タグプロパティにマッピングされた Luma デモサイトでトラフィックを生成すると、Experience Platformのデータセットにデータが入力されます。

データセットの検証

この手順は、データがデータセットに取り込まれていることを確認するために重要です。 データセットに送信されたデータの検証には、2 つの側面があります。

  • Experience Platform デバッガー ​ を使用して検証する
  • ​ データセットをプレビュー ​ を使用して検証
  • ​ クエリサービス ​ を使用した検証

Experience Platform Debugger

これらの手順は、 デバッガーのレッスンで行った手順と多少同じです。 ただし、データはデータストリームで有効にした後にのみ Platform に送信されるので、さらにサンプルデータを生成する必要があります。

  1. Luma デモサイトを開き、Extension DebuggerExperience Platformアイコンを選択します

  2. Debugger を使用した検証のレッスンの説明に従って、タグプロパティを 自分の 開発環境にマッピングするように Debugger を設定します

    デバッガーに表示される Launch 開発環境

  3. 資格情報（test@adobe.com／test）を使用して Luma サイトにログインします。

  4. Luma のホームページに戻ります。

  5. デバッガーによって表示される Platform Web SDK ネットワークビーコン内で、「イベント」行を選択してポップアップで詳細を展開します

    デバッガーの Web SDK

  6. ポップアップ内で「identityMap」を検索します。 authenticatedState、id、および primary の 3 つのキーを持つ lumaCrmId が表示されます
    デバッガーの Web SDK

これで、Luma Web Event Data データセットにデータが入力され、「データセットをプレビュー」の検証の準備が整いました。

データセットのプレビュー

データが Platform のデータレイクに到達したことを確認するには、データセットをプレビュー 機能を使用する簡単なオプションがあります。 Web SDK データは、データレイクにマイクロバッチされ、Platform インターフェイスで定期的に更新されます。 生成したデータが表示されるまで、10～15 分かかる場合があります。

  1. Experience Platform インターフェイスの左側のナビゲーションで データ管理/データセット を選択して データセット ダッシュボードを開きます。

    ダッシュボードリストは、組織で使用可能なすべてのデータセットを管理します。リストに表示された各データセットに関する詳細（名前、データセットが適用されるスキーマ、最新の取得実行のステータスなど）が表示されます。

  2. Luma Web Event Data データセットを選択して、その データセットアクティビティ 画面を開きます。

    データセット Luma Web イベント

    アクティビティ画面には、消費されるメッセージの割合を視覚化したグラフと、成功および失敗したバッチのリストが含まれます。

  3. データセットアクティビティ 画面で、画面の右上隅付近の データセットをプレビュー を選択し、最大 100 行のデータをプレビューします。 データセットが空の場合、プレビューリンクは非アクティブになります。

    データセットプレビュー

    プレビューウィンドウの右側に、データセットのスキーマの階層表示が表示されます。

    データセットプレビュー 1

データのクエリ

  1. Experience Platform インターフェイスの左側のナビゲーションで Data Management > Queroes を選択して Queries 画面を開きます。
  2. 「クエリを作成」を選択します。
  3. まず、クエリを実行して、データレイク内のテーブルのすべての名前を表示します。 クエリエディターに SHOW TABLES と入力し、再生アイコンをクリックしてクエリを実行します。
  4. 結果で、テーブルの名前が luma_web_event_data のようになります
  5. 次に、テーブルを参照する単純なクエリでテーブルをクエリします（デフォルトでは、クエリは 100 件の結果に制限されます）。SELECT * FROM "luma_web_event_data"
  6. しばらくすると、web データのサンプルレコードが表示されます。
ERROR
「テーブルがプロビジョニングされていません」というエラーが発生した場合は、テーブルの名前を再度確認します。 また、データのマイクロバッチがまだデータレイクに到達していない可能性もあります。 10～15 分後にもう一度試してください。
INFO
Adobe Experience Platformのクエリサービスについて詳しくは、Platform チュートリアルの節の データの調査を参照してください。

リアルタイム顧客プロファイルのデータセットとスキーマを有効にする

Real-time Customer Data PlatformおよびJourney Optimizerのお客様に対して、次の手順では、リアルタイム顧客プロファイルのデータセットとスキーマを有効にします。 Web SDK からのデータストリーミングは、Platform に流入する多数のデータソースの 1 つになり、web データを他のデータソースと結合して 360 度の顧客プロファイルを作成する必要があります。 リアルタイム顧客プロファイルについて詳しくは、次の短いビデオをご覧ください。

https://video.tv.adobe.com/v/31660?learn=on&captions=jpn

CAUTION
独自の web サイトとデータを操作する場合は、リアルタイム顧客プロファイルに対してデータを有効にする前に、データのより堅牢な検証をお勧めします。

データセットを有効にするには：

  1. 作成したデータセットを開きます Luma Web Event Data

  2. プロファイル切り替え を選択してオンにします

    プロファイル切り替え

  3. データセットを 有効 することを確認します

    プロファイルを有効にする切替スイッチ

スキーマを有効にするには：

  1. 作成したスキーマを開きます Luma Web Event Data

  2. プロファイル切り替え を選択してオンにします

    プロファイル切り替え

  3. 「このスキーマのデータには、identityMap フィールドにプライマリ ID が含まれます」を選択します。

    note important
    IMPORTANT
    リアルタイムプライマリプロファイルに送信されるすべてのレコードに顧客 ID が必要です。 通常、ID フィールドは、スキーマ内でラベル付けされます。 ただし、ID マップを使用する場合、ID フィールドはスキーマ内に表示されません。 このダイアログは、プライマリ ID を念頭に置いており、データの送信時に ID マップでプライマリ ID を指定することを確認するためのものです。 ご存知のように、Web SDK は、Experience CloudID （ECID）をデフォルトのプライマリ ID として使用し、認証済み ID を利用可能な場合はプライマリ ID として使用する ID マップを使用します。

  4. 選択 有効にする

    プロファイルを有効にする切替スイッチ

  5. 「保存」を選択して、更新されたスキーマを保存します

これで、プロファイルに対してスキーマも有効になります。

IMPORTANT
プロファイルに対してスキーマを有効にすると、サンドボックス全体をリセットまたは削除しない限り、スキーマを無効または削除することはできません。 また、この時点より後にフィールドをスキーマから削除することはできません。
独自のデータを操作する場合は、次の順序で作業を行うことをお勧めします。
  • まず、データセットにデータを取り込みます。
  • データ取り込みプロセス中に発生した問題（データの検証やマッピングの問題など）に対処します。
  • プロファイル用のデータセットとスキーマの有効化
  • 必要に応じて、データを再度取り込みます。

プロファイルの検証

Platform インターフェイス（またはJourney Optimizer インターフェイス）で顧客プロファイルを検索して、データがリアルタイム顧客プロファイルに到達したことを確認できます。 名前が示すように、プロファイルはリアルタイムで入力されるため、データセット内のデータの検証のように遅延はありません。

最初に、サンプルデータをさらに生成する必要があります。 このレッスンの前の手順を繰り返し、タグプロパティにマッピングされたときに Luma web サイトにログインします。 Platform Web SDK リクエストをInspectして、lumaCRMId でデータが送信されることを確認します。

  1. Experience Platform インターフェイスの左側のナビゲーションで 顧客 / プロファイル を選択します

  2. ID 名前空間 として、lumaCRMId を使用します

  3. Experience Platformデバッガーで調べた呼び出しで渡された lumaCRMId の値（この場合は 112ca06ed53d3db37e4cea49cc45b71e）をコピーして貼り付けます。

    プロファイル

  4. lumaCRMId のプロファイルに有効な値がある場合、プロファイル ID がコンソールに入力されます。

    プロファイル

  5. 各 ID のすべての 顧客プロファイル を表示するには、メインウィンドウで プロファイル ID を選択します。

    note note
    NOTE
    プロファイル ID のハイパーリンクを選択できます。行を選択すると、右側のメニューが開き、プロファイル ID のハイパーリンクを選択できます
    顧客プロファイル

    ここでは、ECID など、lumaCRMId にリンクされているすべての ID が表示されます。

    顧客プロファイル

これで、Experience Platform（およびReal-Time CDPの Platform Web SDK が有効になりました。 Journey Optimizer! とCustomer Journey Analytics!）。

ロイヤルティスキーマの作成とサンプルデータの取り込み

この演習は、Real-time Customer Data PlatformおよびJourney Optimizerのお客様が修了すると想定されています。

Web SDK データを Platform に取り込むと、Adobe Experience Platformに取り込んだ他のデータソースによってデータを強化できます。 例えば、ユーザーが Luma サイトにログインすると、ID グラフがExperience Platformに作成され、他のすべてのプロファイル対応データセットを結合してリアルタイム顧客プロファイルを作成できる場合があります。 これを実際に確認するには、サンプルのロイヤルティデータを含む別のデータセットをAdobe Experience Platformですばやく作成して、Real-time Customer Data PlatformとJourney Optimizerでリアルタイム顧客プロファイルを使用できるようにします。 あなたはすでに同様の演習をしたので、指示は簡単になります。

ロイヤルティスキーマを作成します。

  1. 新しいスキーマの作成

  2. 基本クラス として ​ 個人プロファイル ​ を選択します

  3. スキーマに Luma Loyalty Schema という名前を付けます

  4. ​ ロイヤルティの詳細 ​ フィールドグループを追加します

  5. ​ デモグラフィックの詳細 ​ フィールドグループを追加します

  6. 「Person ID」フィールドを選択し、Luma CRM Id ID 名前空間 ​ を使用して、ID および プライマリ ID としてマークします。

  7. ​ プロファイル ​ のスキーマを有効にします。 「プロファイル」切替スイッチが見つからない場合は、左上のスキーマ名をクリックしてみてください。

  8. スキーマの保存

    ロイヤルティスキーマ

データセットを作成してサンプルデータを取り込むには：

  1. Luma Loyalty Schema ージから新しいデータセットを作成

  2. データセットに Luma Loyalty Dataset という名前を付けます

  3. ​ プロファイル ​ のデータセットを有効にする

  4. サンプルファイル luma-loyalty-forWeb.json をダウンロードします。

  5. ファイルをデータセットにドラッグ&ドロップします

  6. データが正常に取り込まれていることを確認します

    ロイヤルティスキーマ

オーディエンスの作成

オーディエンスは、プロファイルを共通の特性に基づいてグループ化します。 Web キャンペーンで使用できるクイックオーディエンスを作成します。

  1. Experience PlatformまたはJourney Optimizer インターフェイスの左側のナビゲーションで 顧客/オーディエンス に移動します

  2. 「オーディエンスを作成」を選択します。

  3. 「ルールを作成」を選択します

  4. 「作成」を選択します。

    オーディエンスの作成

  5. 属性 を選択します。

  6. ロイヤルティ / 層 フィールドを見つけて、「属性」セクションにドラッグします

  7. オーディエンスを tier が gold のユーザーとして定義

  8. オーディエンスに Luma Loyalty Rewards – Gold Status という名前を付ける

  9. Evaluation method として Edge を選択します

  10. 「保存」を選択します

    オーディエンスの定義

これは非常に単純なオーディエンスなので、Edgeの評価方法を使用できます。 Edge オーディエンスはエッジで評価されるので、Web SDK が Platform 定義に対して行うのと同じリクエストで、オーディエンスEdge Networkを評価し、ユーザーが適格かどうかを直ちに確認できます。

次へ：

NOTE
Adobe Experience Platform Web SDK の学習に時間を費やしていただき、ありがとうございます。 ご不明な点がある場合や、一般的なフィードバックを投稿したい場合、または今後のコンテンツに関するご提案がある場合は、この Experience League コミュニティ ディスカッションの投稿でお知らせください
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4