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

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

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

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 as the サービス

  6. を選択 Luma Web Event Data as the イベントデータセット

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

    データストリーム設定

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

データセットの検証

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

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

Experience Platform Debugger

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

  1. を開きます Luma デモサイト を選択し、 Experience Platformデバッガー 拡張機能アイコン

  2. タグプロパティをマッピングするようにデバッガーを設定します。 あなたの 開発環境（「」を参照） デバッガーでの検証 レッスン

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

    プロファイルの有効化切り替え

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

  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. を選択 Enable （有効）

    プロファイルの有効化切り替え

  5. を選択 保存 更新したスキーマを保存するには、次の手順を実行します

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

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

プロファイルの検証

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

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

  1. が含まれる Experience Platform インタフェース、選択 顧客 > プロファイル 左側のナビゲーションで

  2. として ID 名前空間 use lumaCRMId

  3. の値をコピー&ペースト lumaCRMId Experience Platformデバッガーで調べた呼び出しで渡されます（ここでは）。 112ca06ed53d3db37e4cea49cc45b71e.

    プロファイル

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

    プロファイル

  5. 完全な 顧客プロファイル 各 ID に対して、 プロファイル ID メインウィンドウで。

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

    ここでは、にリンクされているすべての ID を確認できます lumaCRMId、例： ECID.

    顧客プロファイル

これで、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. を選択 個人プロファイル as the 基本クラス

  3. スキーマに名前を付ける Luma Loyalty Schema

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

  5. を追加 人口統計の詳細 フィールドグループ

  6. 「」を選択します Person ID フィールドに入力し、 ID および プライマリ ID の使用 Luma CRM Id ID 名前空間.

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

  8. スキーマの保存

    ロイヤルティスキーマ

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

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

  2. データセットに名前を付ける Luma Loyalty Dataset

  3. のデータセットを有効にする Profile

  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. を選択 Edge as the 評価方法

  10. を選択 保存

    オーディエンスの定義

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

次へ：

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