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

このレッスンでは、Adobe Experience Platform Web SDK を使用してデータをストリーミングします。

データ収集インターフェイスで完了する必要がある主なタスクは 2 つあります。

  • Luma web サイトに Web SDK を実装して、web サイトからの訪問者アクティビティに関するデータをAdobe Edge Network に送信する必要があります。 タグ(旧称 Launch)を使用して簡単な実装をおこないます

  • データストリームを設定する必要があります。これは、データの転送先をEdge ネットワークに指示するものです。 Platform サンドボックスの Luma Web Events データセットにデータを送信するように設定します。

データエンジニア は、このチュートリアル以外でストリーミングデータを取り込む必要があります。 Web SDK または Mobile SDK をAdobe Experience Platformしてを実装する場合、通常、web またはモバイル開発者がデータレイヤーの作成とタグプロパティの設定に関与します。

演習を開始する前に、次の 2 つの短いビデオを視聴して、ストリーミングデータ取り込みと Web SDK について詳しく学びます。

NOTE
このチュートリアルでは、Web SDK を使用して web サイトからストリーミングでデータを取り込む方法を中心に説明しますが、Adobe Mobile SDKApache Kafka Connect などの仕組みを使用してデータをストリーミングすることもできます。

必要な権限

権限の設定レッスンでは、このレッスンを完了するために必要なすべてのアクセス制御を設定します。

データストリームの設定

まず、データストリームを設定します。 データストリームは、Web SDK 呼び出しからデータを受信した後、データを送信する場所をAdobe Edge ネットワークに指示します。 例えば、データをExperience Platform、Adobe AnalyticsまたはAdobe Targetに送信しますか? データストリームは、データ収集ユーザーインターフェイス(旧称 Launch)で管理され、Web SDK を使用したデータ収集にとって重要です。

​ データストリーム ​ を作成するには:

  1. Experience Platformデータ収集ユーザーインターフェイスにログインします

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

  3. 右上隅の 新しいデータストリーム ボタンを選択します

    左側のナビゲーションでのデータストリームの選択

  4. わかりやすい名前 に、Luma Platform Tutorial と入力します(会社の複数のユーザーがこのチュートリアルを受講している場合は、最後に名前を追加します)。

  5. 保存 ボタンを選択します

    データストリームに名前を付けて保存します

次の画面で、データを送信する場所を指定します。 データをExperience Platformに送信するには:

  1. Adobe Experience Platform をオンにして、追加のフィールドを公開します
  2. サンドボックス で、Luma Tutorial を選択します
  3. イベントデータセット で、Luma Web Events Dataset を選択します
  4. 他のAdobeアプリケーションを使用している場合は、自由に他の節を参照して、これらの他のソリューションのEdge設定で必要な情報を確認してください。 Web SDK は、データをExperience Platformにストリーミングするだけでなく、他のAdobeアプリケーションで使用される以前のJavaScript ライブラリをすべて置き換えるために開発されました。 Edge Configuration は、データを送信する各アプリケーションのアカウントの詳細を指定するために使用されます。
  5. 保存」を選択します
    データストリームの設定と保存

Edge Configuration を保存すると、開発用、ステージング用、実稼動用の 3 つの環境が作成されていることが画面に表示されます。 さらに開発環境を追加できます。
各Edge設定に複数の環境を含めることができます
3 つの環境すべてに、入力したプラットフォームの詳細が含まれます。 ただし、これらの詳細は環境ごとに異なる方法で設定できます。 例えば、各環境で異なる Platform サンドボックスにデータを送信することができます。 このチュートリアルでは、データストリームに対して追加のカスタマイズを行いません。

Web SDK 拡張機能のインストール

プロパティを追加

まず、タグプロパティ(以前のタグプロパティ)を作成する必要があります。 プロパティは、web ページから詳細を収集して様々な場所に送信するために必要なすべてのJavaScript、ルール、その他の機能のコンテナです。

プロパティを作成するには:

  1. 左側のナビゲーションの プロパティ に移動します
  2. 新しいプロパティ」ボタンを選択します
    新しいプロパティを追加
  3. 名前 として、Luma Platform Tutorial と入力します(会社の複数のユーザーがこのチュートリアルを受講している場合は、最後に名前を追加します)。
  4. ドメイン として、enablementadobe.com と入力します(後で説明します)。
  5. 保存」を選択します
    プロパティの詳細

Web SDK 拡張機能の追加

プロパティが用意できたので、拡張機能を使用して Web SDK を追加できます。 拡張機能は、データ収集のインターフェイスと機能を拡張するコードのパッケージです。 拡張機能を追加するには:

  1. タグプロパティを開きます
  2. 左ナビゲーションの 拡張機能 に移動します
  3. カタログ タブに移動します
  4. タグに使用できる拡張機能は多数あります。 Web SDK という用語でカタログをフィルタリングします
  5. Adobe Experience Platform Web SDK 拡張機能で、「インストール」ボタンを選択します
    Adobe Experience Platform Web SDK 拡張機能のインストール
  6. Web SDK 拡張機能で使用できる設定はいくつかありますが、このチュートリアルで設定する設定は 2 つだけです。 Edge ドメインdata.enablementadobe.com に更新します。 この設定を使用すると、Web SDK 実装でファーストパーティ Cookie を設定できます。これは推奨されます。 このレッスンの後半では、enablementadobe.com ドメインの web サイトをタグプロパティにマッピングします。 enablementadobe.com ドメインの CNAME は、Adobeサーバーに転送されるように既に設定されて data.enablementadobe.com ます。 Web SDK を独自の web サイトに実装する場合、独自のデータ収集目的で CNAME を作成する必要があります(例:data.YOUR_DOMAIN.com)。
  7. データストリーム ドロップダウンから、Luma Platform Tutorial データストリームを選択します。
  8. その他の設定オプションについては、自由に確認してください(変更しないでください)。 次に、「保存」を選択します

データを送信するルールの作成

次に、データを Platform に送信するルールを作成します。 ルールは、タグに何かをするように指示するイベント、条件、アクションの組み合わせです。 ルールを作成するには:

  1. 左側のナビゲーションで ルール に移動します
  2. 新規ルールを作成」ボタンを選択します
    ルールの作成
  3. ルール名を設定します。All Pages - Library Loaded
  4. イベント で「追加」ボタンを選択します
    ルールに名前を付けてイベントを追加する
  5. Core Extension を使用し、イベントタイプ として Library Loaded (Page Top) を選択します。 この設定は、Launch ライブラリがページに読み込まれるたびにルールが起動することを意味します。
  6. 変更を保持」を選択して、メインのルール画面に戻ります
    ライブラリの読み込みイベントの追加
  7. このルールは、指定した名前に従ってすべてのページで実行する必要があるので、条件 は空のままにします
  8. アクション で「追加」ボタンを選択します
  9. Adobe Experience Platform Web SDK Extension を使用し、Action Type として Send Event を選択します
  10. 右側の「タイプ」ドロップダウンから「web.webpagedetails.pageViews」を選択します。 これは、Luma Web Events Schema の XDM フィールドの 1 つです
  11. 変更を保持」を選択して、メインのルール画面に戻ります
    イベントを送信アクションの追加
  12. 保存」を選択して、ルールを保存します
    ルールの保存

ライブラリ内のルールのPublish

次に、ルールが機能することを検証できるように、開発環境に公開します。

ライブラリを作成するには:

  1. 左側のナビゲーションの 公開フロー に移動します
  2. ライブラリを追加」を選択します。
    「ライブラリを追加」を選択
  3. 名前Luma Platform Tutorial と入力します
  4. 環境 で、「Development」を選択します。
  5. 変更されたすべてのリソースを追加」ボタンを選択します。 (Adobe Experience Platform Web SDK 拡張機能と All Pages - Library Loaded ルールに加えて、すべての Launch web プロパティで必要な基本JavaScriptを含んだ Core 拡張機能も追加されます。)
  6. 開発用に保存してビルド ボタンを選択します
    ライブラリの作成とビルド

ライブラリのビルドには数分かかる場合があり、完了すると、ライブラリ名の左側に緑のドットが表示されます。
ビルド完了

​ 公開フロー ​ 画面で確認できるように、公開プロセスには多くの詳細があり、これはこのチュートリアルの範囲外です。 開発環境では、単一のライブラリを使用します。

リクエスト内のデータを検証します

Adobe Experience Platform Debuggerを追加

Experience Platformデバッガーは、Chromeおよび Firefox ブラウザーで使用できる拡張機能で、web ページに実装されたAdobeテクノロジーを確認するのに役立ちます。 使用するブラウザーのバージョンをダウンロードします。

初めて Debugger を使用する場合(これが古いAdobe Experience Cloud Debugger と異なる場合)は、次の 5 分間の概要ビデオをご覧ください。

Luma web サイトを開きます

このチュートリアルでは、Luma デモ web サイトの公開バージョンを使用します。 これを開いて、ブックマークします。

  1. 新しいブラウザータブで、Luma web サイトを開きます。
  2. チュートリアルの残りの部分で使用するために、ページをブックマークします

このホストされる web サイトで enablementadobe.com、最初のタグプロパティ設定の Domains フィールドに使用した理由と、Adobe Experience Platform Web SDK 拡張機能のファーストパーティドメインとして data.enablementadobe.com を使用した理由です。 見て、私は計画を持っていた!

Luma ホームページ

Experience Platformデバッガーを使用して、タグプロパティにマッピングする

Experience Platformデバッガーには、既存のタグプロパティを別のプロパティに置き換えることができる優れた機能があります。 これは検証に役立ち、このチュートリアルの多くの実装手順をスキップできます。

  1. Luma サイトが開いていることを確認し、「Experience Platformデバッガー」拡張機能アイコンを選択します

  2. デバッガーが開き、ハードコーディングされた実装の詳細が表示されます。これは、このチュートリアルとは無関係です(デバッガーを開いた後に Luma サイトをリロードする必要がある場合があります)

  3. 次の図に示すように、デバッガーが「Luma に接続」されていることを確認し、「lock」アイコンを選択して、デバッガーを Luma サイトにロックします。

  4. 右上の ログイン ボタンを選択して、認証します。

  5. 左側のナビゲーションの ローンチ に移動します

  6. 「設定」タブを選択します。

  7. ページ埋め込みコード が表示されている場所の右側で、「アクション」ドロップダウンを開き、「置換」を選択します
    アクション/置換を選択

  8. 認証されたので、デバッガーは使用可能な Launch プロパティと環境を取り込みます。 Luma Platform Tutorial プロパティを選択します

  9. Development 環境を選択します

  10. 適用 ボタンを選択します
    代替タグプロパティの選択

  11. Luma web サイトが タグプロパティを使用して 再読み込みされるようになりました。 助けて、私はハッキングされました! 冗談だよ。
    タグプロパティが置き換えられました

  12. 左側のナビゲーションの 概要 に移動し、Launch プロパティの詳細を確認します
    「概要」タブ

  13. 左側のナビゲーションで AEP Web SDK に移動して、ネットワークリクエスト を確認します

  14. events 行を開きます

    Adobe Experience Platform Web SDK リクエスト

  15. ​ イベントを送信 ​ アクションで指定した web.webpagedetails.pageView イベントタイプと、AEP Web SDK ExperienceEvent Mixin 形式に準拠するその他の標準変数の確認方法に注意してください
    イベントの詳細

  16. これらのタイプのリクエストの詳細は、ブラウザーの web デベロッパーツールの「ネットワーク タブにも表示さ ます。 ファイルを開き、ページをリロードします。 interact を使用して呼び出しをフィルタリングし、呼び出しを見つけて選択し、「ヘッダー」タブの リクエストペイロード 領域を探します。
    「ネットワーク」タブ

  17. 応答」タブに移動し、ECID 値が応答にどのように含まれるかを確認します。 この値をコピーします。次の演習では、この値を使用してプロファイル情報を検証します。
    「ネットワーク」タブ

Experience Platform内のデータの検証

データに到着したデータのバッチを調べることで、データが Platform にランディングしていることを検証で Luma Web Events Dataset ます。 (ストリーミングデータ取り込みと呼ばれますが、今はバッチで到着すると言っています。 リアルタイムでプロファイルにストリーミングするので、リアルタイムのセグメント化とアクティベーションに使用できますが、データレイクに 15 分ごとにバッチで送信されます)。

データを検証するには:

  1. Platform ユーザーインターフェイスの左側のナビゲーションで データセット に移動します
  2. Luma Web Events Dataset を開き、バッチが到着したことを確認します。 バッチは 15 分ごとに送信されるので、バッチが表示されるまで待つ必要がある場合があります。
  3. データセットをプレビュー」ボタンを選択します
    データセットを開く
  4. プレビューモーダルでは、左側でスキーマの様々なフィールドを選択して、それらの特定のデータポイントをプレビューする方法に注意してください。
    フィールドのプレビュー

また、新しいプロファイルが表示されていることを確認することもできます。

  1. Platform ユーザーインターフェイスで、左側のナビゲーションの プロファイル に移動します
  2. ECID 名前空間を選択し、ECID 値を検索します(応答からコピーします)。 プロファイルには、ECID とは別に独自の ID が割り当てられます。
  3. プロファイル ID を選択して、プロファイルを開きます
    プロファイルを検索して開きます
  4. イベント タブを選択して、表示したページを表示します
    プロファイルイベント \

イベントへのカスタムデータの追加

ページ名のデータ要素を作成

  1. データ収集タグインターフェイスの Luma Platform Tutorial プロパティの右上隅で 作業ライブラリを選択 ドロップダウンを開き、Luma Platform Tutorial ライブラリを選択します。 この設定により、ライブラリに追加の更新を公開しやすくなります。

  2. 左ナビゲーションの データ要素 に移動します

  3. 新しいデータ要素の作成 ボタンを選択します

    新しいデータ要素の作成

  4. 名前 として、Page Name と入力します

  5. データ要素タイプ として、「JavaScript Variable」を選択します

  6. JavaScript変数名 として、digitalData.page.pageInfo.pageName と入力します

  7. 値の形式を標準化するには、「小文字の値を強制 」および「テキストをクリーン のチェックボックスをオンに

  8. 作業ライブラリとして「Luma Platform Tutorial」が選択されていることを確認します

  9. ライブラリに保存」を選択します
    ページ名のデータ要素の作成

ページ名を XDM オブジェクトデータ要素にマッピングします

次に、ページ名を Web SDK にマッピングします。

IMPORTANT
このタスクを完了するには、まずユーザーが実稼動サンドボックスにアクセスできるようにする必要があります。 別の製品プロファイルから実稼動用サンドボックスにまだアクセスできない場合は、す Luma Tutorial Platform に実稼動プロファイルを開いて、権限項目 サンドボックス/実稼動 を追加します。 その後、データ要素ページでシフト再ロードを実行して、キャッシュをクリアします
実稼動サンドボックスを追加

データ要素 ページで、次の操作を行います。

  1. 新しいデータ要素の作成
  2. 名前 として、XDM Object と入力します
  3. 拡張機能 として、「Adobe Experience Platform Web SDK」を選択します
  4. データ要素タイプ として、「XDM object」を選択します
  5. サンドボックス として、Luma Tutorial のサンドボックスを選択します
  6. スキーマ として、Luma Web Events Schema を選択します
  7. web.webPageDetails.name フィールドを選択します
  8. として、アイコンを選択してデータ要素選択モーダルを開き、Page Name データ要素を選択します
  9. ライブラリに保存」を選択します
    ページ名を XDM オブジェクトデータ要素にマッピングする

これと同じプロセスを使用して、web サイト上の追加のカスタムデータを XDM フィールドにマッピングします。

XDM データをイベントを送信アクションに追加します

XDM フィールドにマッピングされたデータがあるので、イベントを送信アクションに含めることができます。

  1. ルール 画面に移動します
  2. All Pages - Library Loaded ルールを開きます
  3. Adobe Experience Platform Web SDK - Send Event アクションを開く
  4. XDM データ として、アイコンを選択してデータ要素選択モーダルを開き、XDM Object データ要素を選択します
  5. 変更を保持」ボタンを選択します
    XDM データをイベントを送信アクションに追加する
  6. 前回の演習 Luma Platform Tutorial 作業ライブラリとしてを選択したので、最近の変更はライブラリに直接保存されています。 公開フロー画面を使用して変更を公開する代わりに、青いボタンのドロップダウンを開いて ライブラリおよびビルドに保存 を選択するだけです
    ライブラリとビルドに保存

これにより、今追加した 3 つの変更を含む新しいタグライブラリの作成が開始されます。

XDM データの検証

先ほど学んだように、デバッガーを使用してタグプロパティにマッピングしながら、Luma ホームページを再読み込みできるようになりました。また、ページ名フィールドがリクエストに入力されていることがわかります。
XDM データの検証

また、データセットとプロファイルをプレビューすることで、Platform で受信したページ名データを検証することもできます。

追加の ID を送信

これで、Web SDK 実装が、Experience Cloud ID (ECID)をプライマリ ID とするイベントを送信するようになりました。 ECID は、Web SDK によって自動的に生成され、デバイスとブラウザーごとに一意です。 1 人の顧客は、使用しているデバイスとブラウザーに応じて、複数の ECID を持つことができます。 では、どうすれば、この顧客の統一されたビューを取得し、顧客のオンラインアクティビティを CRM、ロイヤルティ、オフライン購入データにリンクできるでしょうか。 これを行うには、セッション中に追加の ID を収集し、ID ステッチを使用してプロファイルを決定論的にリンクします。

先ほど思い出していただいたように、ID のマッピングレッスンでは、ECID と CRM ID を web データの ID として使用しています。 Web SDK を使用して CRM ID を収集します。

CRM ID に対応するデータ要素の追加

まず、CRM ID をデータ要素に格納します。

  1. タグインターフェイスで、CRM Id という名前のデータ要素を追加します。
  2. Data Element Type として、「JavaScript変数」を選択します
  3. JavaScript変数名 として、digitalData.user.0.profile.0.attributes.username と入力します
  4. ライブラリに保存」ボタンを選択します(作業ライブラリ Luma Platform Tutorial 残ります)。
    CRM ID のデータ要素を追加

CRM ID を ID マップデータ要素に追加します

CRM ID 値を取得したので、それを ID マップ ​ データ要素と呼ばれる特別なデータ要素タイプに関連付ける必要があります。

  1. Identities という名前のデータ要素を追加

  2. Extension として、「Adobe Experience Platform Web SDK」を選択します

  3. データ要素タイプ として、「ID マップ」を選択します

  4. 名前空間 として、前のレッスンで作成した ​ 名前空間 ​ である Luma CRM Id と入力します

    note warning
    WARNING
    Adobe Experience Platform Web SDK 拡張機能バージョン 2.2 では、Platform アカウントの実際の値を使用して、事前入力されたドロップダウンから名前空間を選択できます。 残念ながら、この機能はまだ「サンドボックス対応」ではないので、Luma CRM Id の値がドロップダウンに表示されない場合があります。 これにより、この演習を完了できない場合があります。 確認後、回避策を掲載します。
  5. ID として、このアイコンを選択してデータ要素選択モーダルを開き、CRM Id データ要素を選択します

  6. 認証状態 として、「認証済み」を選択します

  7. プライマリ オフ のままにします。 CRM ID は Luma web サイトへのほとんどの訪問者に対して存在しないので、プライマリ識別子として ECID を上書きしないでください。 ECID 以外をプライマリ識別子として使用することはめったにありません。 通常、これらの手順ではデフォルト設定については言及しませんが、後で自分の実装で問題が発生するのを防ぐために、この設定を呼び出します。

  8. ライブラリに保存」ボタンを選択します(作業ライブラリ Luma Platform Tutorial 残ります)。
    CRM ID を ID マップデータ要素に追加

NOTE
ID マップ ​ データタイプを使用して、複数の識別子を渡すことができます。

ID マップデータ要素を XDM オブジェクトに追加します

更新が必要なデータ要素として、もう 1 つ XDM オブジェクトデータ要素があります。 この 1 つの ID を渡すために 3 つの個別のデータ要素を更新する必要があると奇妙に思えるかもしれませんが、このプロセスは、複数の ID に対して拡張するように設計されています。 心配しないでください。このレッスンはもうほとんど終わりです。

  1. XDM オブジェクトデータ要素を開きます
  2. IdentityMap XDM フィールドを開きます
  3. データ要素 として、アイコンを選択してデータ要素選択モーダルを開き、Identities データ要素を選択します
  4. 前回の演習 Luma Platform Tutorial 作業ライブラリとしてを選択したので、最近の変更はライブラリに直接保存されています。 公開フロー画面を使用して変更を公開する代わりに、青いボタンのドロップダウンを開いて、「ライブラリおよびビルドに保存 を選択できます
    IdentityMap データ要素を XDM オブジェクトに追加する

ID の検証

CRM ID が Web SDK で現在送信されていることを検証するには、以下を行います。

  1. Luma web サイトを開きます。
  2. 前の手順に従って、デバッガーを使用してタグプロパティにマッピングします。
  3. Luma web サイトの右上にある ログイン リンクを選択します
  4. 資格情報 test@adobe.com/test を使用してログイン
  5. 認証が完了したら、デバッガー(最新のリクエストの Adobe Experience Platform Web SDK/Network Requests/events)でExperience Platform Web SDK 呼び出しを調べると、lumaCrmId が表示されます。
    デバッガーでの ID の検証
  6. ECID 名前空間を使用してユーザープロファイルを検索し、値を再度設定します。 プロファイルには、CRM ID とロイヤルティ ID、名前や電話番号などのプロファイルの詳細が表示されます。 すべての ID とデータは、単一のリアルタイム顧客プロファイルにステッチされています。
    Platform での ID の検証

その他のリソース

お疲れ様でした。 Web SDK と Launch に関する多くの情報でした。 本格的な実装にはさらに多くの関与がありますが、Platform で開始して結果を確認するのに役立つ基本です。

NOTE
ストリーミング取り込みレッスンが完了したので、Luma Tutorial Platform 製品プロファイルから Prod サンドボックスを削除できます

データエンジニアの方は、 クエリを実行のレッスンに進んでください。

データアーキテクトは、 結合ポリシーに進むことができます。

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad