ストリーミングデータの取り込み
このレッスンでは、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 について詳しく学びます。
必要な権限
権限の設定レッスンでは、このレッスンを完了するために必要なすべてのアクセス制御を設定します。
データストリームの設定
まず、データストリームを設定します。 データストリームは、Web SDK 呼び出しからデータを受信した後、データを送信する場所をAdobe Edge ネットワークに指示します。 例えば、データをExperience Platform、Adobe AnalyticsまたはAdobe Targetに送信しますか? データストリームは、データ収集ユーザーインターフェイス(旧称 Launch)で管理され、Web SDK を使用したデータ収集にとって重要です。
データストリーム を作成するには:
-
左側のナビゲーションで データストリーム を選択します
-
右上隅の 新しいデータストリーム ボタンを選択します
-
わかりやすい名前 に、
Luma Platform Tutorial
と入力します(会社の複数のユーザーがこのチュートリアルを受講している場合は、最後に名前を追加します)。 -
「保存 ボタンを選択します
次の画面で、データを送信する場所を指定します。 データをExperience Platformに送信するには:
- Adobe Experience Platform をオンにして、追加のフィールドを公開します
- サンドボックス で、
Luma Tutorial
を選択します - イベントデータセット で、
Luma Web Events Dataset
を選択します - 他のAdobeアプリケーションを使用している場合は、自由に他の節を参照して、これらの他のソリューションのEdge設定で必要な情報を確認してください。 Web SDK は、データをExperience Platformにストリーミングするだけでなく、他のAdobeアプリケーションで使用される以前のJavaScript ライブラリをすべて置き換えるために開発されました。 Edge Configuration は、データを送信する各アプリケーションのアカウントの詳細を指定するために使用されます。
- 「保存」を選択します
Edge Configuration を保存すると、開発用、ステージング用、実稼動用の 3 つの環境が作成されていることが画面に表示されます。 さらに開発環境を追加できます。
3 つの環境すべてに、入力したプラットフォームの詳細が含まれます。 ただし、これらの詳細は環境ごとに異なる方法で設定できます。 例えば、各環境で異なる Platform サンドボックスにデータを送信することができます。 このチュートリアルでは、データストリームに対して追加のカスタマイズを行いません。
Web SDK 拡張機能のインストール
プロパティを追加
まず、タグプロパティ(以前のタグプロパティ)を作成する必要があります。 プロパティは、web ページから詳細を収集して様々な場所に送信するために必要なすべてのJavaScript、ルール、その他の機能のコンテナです。
プロパティを作成するには:
- 左側のナビゲーションの プロパティ に移動します
- 「新しいプロパティ」ボタンを選択します
- 名前 として、
Luma Platform Tutorial
と入力します(会社の複数のユーザーがこのチュートリアルを受講している場合は、最後に名前を追加します)。 - ドメイン として、
enablementadobe.com
と入力します(後で説明します)。 - 「保存」を選択します
Web SDK 拡張機能の追加
プロパティが用意できたので、拡張機能を使用して Web SDK を追加できます。 拡張機能は、データ収集のインターフェイスと機能を拡張するコードのパッケージです。 拡張機能を追加するには:
- タグプロパティを開きます
- 左ナビゲーションの 拡張機能 に移動します
- 「カタログ タブに移動します
- タグに使用できる拡張機能は多数あります。
Web SDK
という用語でカタログをフィルタリングします - Adobe Experience Platform Web SDK 拡張機能で、「インストール」ボタンを選択します
- 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
)。 - データストリーム ドロップダウンから、
Luma Platform Tutorial
データストリームを選択します。 - その他の設定オプションについては、自由に確認してください(変更しないでください)。 次に、「保存」を選択します
データを送信するルールの作成
次に、データを Platform に送信するルールを作成します。 ルールは、タグに何かをするように指示するイベント、条件、アクションの組み合わせです。 ルールを作成するには:
- 左側のナビゲーションで ルール に移動します
- 「新規ルールを作成」ボタンを選択します
- ルール名を設定します。
All Pages - Library Loaded
- イベント で「追加」ボタンを選択します
- Core Extension を使用し、イベントタイプ として Library Loaded (Page Top) を選択します。 この設定は、Launch ライブラリがページに読み込まれるたびにルールが起動することを意味します。
- 「変更を保持」を選択して、メインのルール画面に戻ります
- このルールは、指定した名前に従ってすべてのページで実行する必要があるので、条件 は空のままにします
- アクション で「追加」ボタンを選択します
- Adobe Experience Platform Web SDK Extension を使用し、Action Type として Send Event を選択します
- 右側の「タイプ」ドロップダウンから「web.webpagedetails.pageViews」を選択します。 これは、
Luma Web Events Schema
の XDM フィールドの 1 つです - 「変更を保持」を選択して、メインのルール画面に戻ります
- 「保存」を選択して、ルールを保存します
ライブラリ内のルールのPublish
次に、ルールが機能することを検証できるように、開発環境に公開します。
ライブラリを作成するには:
- 左側のナビゲーションの 公開フロー に移動します
- 「ライブラリを追加」を選択します。
- 名前 に
Luma Platform Tutorial
と入力します - 環境 で、「
Development
」を選択します。 - 「変更されたすべてのリソースを追加」ボタンを選択します。 (Adobe Experience Platform Web SDK 拡張機能と
All Pages - Library Loaded
ルールに加えて、すべての Launch web プロパティで必要な基本JavaScriptを含んだ Core 拡張機能も追加されます。) - 「開発用に保存してビルド ボタンを選択します
ライブラリのビルドには数分かかる場合があり、完了すると、ライブラリ名の左側に緑のドットが表示されます。
公開フロー 画面で確認できるように、公開プロセスには多くの詳細があり、これはこのチュートリアルの範囲外です。 開発環境では、単一のライブラリを使用します。
リクエスト内のデータを検証します
Adobe Experience Platform Debuggerを追加
Experience Platformデバッガーは、Chromeおよび Firefox ブラウザーで使用できる拡張機能で、web ページに実装されたAdobeテクノロジーを確認するのに役立ちます。 使用するブラウザーのバージョンをダウンロードします。
初めて Debugger を使用する場合(これが古いAdobe Experience Cloud Debugger と異なる場合)は、次の 5 分間の概要ビデオをご覧ください。
Luma web サイトを開きます
このチュートリアルでは、Luma デモ web サイトの公開バージョンを使用します。 これを開いて、ブックマークします。
- 新しいブラウザータブで、Luma web サイトを開きます。
- チュートリアルの残りの部分で使用するために、ページをブックマークします
このホストされる web サイトで enablementadobe.com
、最初のタグプロパティ設定の Domains フィールドに使用した理由と、Adobe Experience Platform Web SDK 拡張機能のファーストパーティドメインとして data.enablementadobe.com
を使用した理由です。 見て、私は計画を持っていた!
Experience Platformデバッガーを使用して、タグプロパティにマッピングする
Experience Platformデバッガーには、既存のタグプロパティを別のプロパティに置き換えることができる優れた機能があります。 これは検証に役立ち、このチュートリアルの多くの実装手順をスキップできます。
-
Luma サイトが開いていることを確認し、「Experience Platformデバッガー」拡張機能アイコンを選択します
-
デバッガーが開き、ハードコーディングされた実装の詳細が表示されます。これは、このチュートリアルとは無関係です(デバッガーを開いた後に Luma サイトをリロードする必要がある場合があります)
-
次の図に示すように、デバッガーが「Luma に接続」されていることを確認し、「lock」アイコンを選択して、デバッガーを Luma サイトにロックします。
-
右上の ログイン ボタンを選択して、認証します。
-
左側のナビゲーションの ローンチ に移動します
-
「設定」タブを選択します。
-
ページ埋め込みコード が表示されている場所の右側で、「アクション」ドロップダウンを開き、「置換」を選択します
-
認証されたので、デバッガーは使用可能な Launch プロパティと環境を取り込みます。
Luma Platform Tutorial
プロパティを選択します -
Development
環境を選択します -
「適用 ボタンを選択します
-
Luma web サイトが タグプロパティを使用して 再読み込みされるようになりました。 助けて、私はハッキングされました! 冗談だよ。
-
左側のナビゲーションの 概要 に移動し、Launch プロパティの詳細を確認します
-
左側のナビゲーションで AEP Web SDK に移動して、ネットワークリクエスト を確認します
-
events 行を開きます
-
イベントを送信 アクションで指定した
web.webpagedetails.pageView
イベントタイプと、AEP Web SDK ExperienceEvent Mixin
形式に準拠するその他の標準変数の確認方法に注意してください
-
これらのタイプのリクエストの詳細は、ブラウザーの web デベロッパーツールの「ネットワーク タブにも表示さ ます。 ファイルを開き、ページをリロードします。
interact
を使用して呼び出しをフィルタリングし、呼び出しを見つけて選択し、「ヘッダー」タブの リクエストペイロード 領域を探します。
-
「応答」タブに移動し、ECID 値が応答にどのように含まれるかを確認します。 この値をコピーします。次の演習では、この値を使用してプロファイル情報を検証します。
Experience Platform内のデータの検証
データに到着したデータのバッチを調べることで、データが Platform にランディングしていることを検証で Luma Web Events Dataset
ます。 (ストリーミングデータ取り込みと呼ばれますが、今はバッチで到着すると言っています。 リアルタイムでプロファイルにストリーミングするので、リアルタイムのセグメント化とアクティベーションに使用できますが、データレイクに 15 分ごとにバッチで送信されます)。
データを検証するには:
- Platform ユーザーインターフェイスの左側のナビゲーションで データセット に移動します
Luma Web Events Dataset
を開き、バッチが到着したことを確認します。 バッチは 15 分ごとに送信されるので、バッチが表示されるまで待つ必要がある場合があります。- 「データセットをプレビュー」ボタンを選択します
- プレビューモーダルでは、左側でスキーマの様々なフィールドを選択して、それらの特定のデータポイントをプレビューする方法に注意してください。
また、新しいプロファイルが表示されていることを確認することもできます。
- Platform ユーザーインターフェイスで、左側のナビゲーションの プロファイル に移動します
- ECID 名前空間を選択し、ECID 値を検索します(応答からコピーします)。 プロファイルには、ECID とは別に独自の ID が割り当てられます。
- プロファイル ID を選択して、プロファイルを開きます
。 - イベント タブを選択して、表示したページを表示します
\
イベントへのカスタムデータの追加
ページ名のデータ要素を作成
-
データ収集タグインターフェイスの
Luma Platform Tutorial
プロパティの右上隅で 作業ライブラリを選択 ドロップダウンを開き、Luma Platform Tutorial
ライブラリを選択します。 この設定により、ライブラリに追加の更新を公開しやすくなります。 -
左ナビゲーションの データ要素 に移動します
-
「新しいデータ要素の作成 ボタンを選択します
-
名前 として、
Page Name
と入力します -
データ要素タイプ として、「
JavaScript Variable
」を選択します -
JavaScript変数名 として、
digitalData.page.pageInfo.pageName
と入力します -
値の形式を標準化するには、「小文字の値を強制 」および「テキストをクリーン のチェックボックスをオンに ま。
-
作業ライブラリとして「
Luma Platform Tutorial
」が選択されていることを確認します -
「ライブラリに保存」を選択します
ページ名を XDM オブジェクトデータ要素にマッピングします
次に、ページ名を Web SDK にマッピングします。
Luma Tutorial Platform
に実稼動プロファイルを開いて、権限項目 サンドボックス/実稼動 を追加します。 その後、データ要素ページでシフト再ロードを実行して、キャッシュをクリアしますデータ要素 ページで、次の操作を行います。
- 新しいデータ要素の作成
- 名前 として、
XDM Object
と入力します - 拡張機能 として、「
Adobe Experience Platform Web SDK
」を選択します - データ要素タイプ として、「
XDM object
」を選択します - サンドボックス として、
Luma Tutorial
のサンドボックスを選択します - スキーマ として、
Luma Web Events Schema
を選択します web.webPageDetails.name
フィールドを選択します- 値 として、アイコンを選択してデータ要素選択モーダルを開き、
Page Name
データ要素を選択します - 「ライブラリに保存」を選択します
これと同じプロセスを使用して、web サイト上の追加のカスタムデータを XDM フィールドにマッピングします。
XDM データをイベントを送信アクションに追加します
XDM フィールドにマッピングされたデータがあるので、イベントを送信アクションに含めることができます。
- ルール 画面に移動します
All Pages - Library Loaded
ルールを開きますAdobe Experience Platform Web SDK - Send Event
アクションを開く- XDM データ として、アイコンを選択してデータ要素選択モーダルを開き、
XDM Object
データ要素を選択します - 「変更を保持」ボタンを選択します
- 前回の演習
Luma Platform Tutorial
作業ライブラリとしてを選択したので、最近の変更はライブラリに直接保存されています。 公開フロー画面を使用して変更を公開する代わりに、青いボタンのドロップダウンを開いて ライブラリおよびビルドに保存 を選択するだけです
これにより、今追加した 3 つの変更を含む新しいタグライブラリの作成が開始されます。
XDM データの検証
先ほど学んだように、デバッガーを使用してタグプロパティにマッピングしながら、Luma ホームページを再読み込みできるようになりました。また、ページ名フィールドがリクエストに入力されていることがわかります。
また、データセットとプロファイルをプレビューすることで、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 をデータ要素に格納します。
- タグインターフェイスで、
CRM Id
という名前のデータ要素を追加します。 - Data Element Type として、「JavaScript変数」を選択します
- JavaScript変数名 として、
digitalData.user.0.profile.0.attributes.username
と入力します - 「ライブラリに保存」ボタンを選択します(作業ライブラリ
Luma Platform Tutorial
残ります)。
CRM ID を ID マップデータ要素に追加します
CRM ID 値を取得したので、それを ID マップ データ要素と呼ばれる特別なデータ要素タイプに関連付ける必要があります。
-
Identities
という名前のデータ要素を追加 -
Extension として、「Adobe Experience Platform Web SDK」を選択します
-
データ要素タイプ として、「ID マップ」を選択します
-
名前空間 として、前のレッスンで作成した 名前空間 である
Luma CRM Id
と入力しますnote warning WARNING Adobe Experience Platform Web SDK 拡張機能バージョン 2.2 では、Platform アカウントの実際の値を使用して、事前入力されたドロップダウンから名前空間を選択できます。 残念ながら、この機能はまだ「サンドボックス対応」ではないので、 Luma CRM Id
の値がドロップダウンに表示されない場合があります。 これにより、この演習を完了できない場合があります。 確認後、回避策を掲載します。 -
ID として、このアイコンを選択してデータ要素選択モーダルを開き、
CRM Id
データ要素を選択します -
認証状態 として、「認証済み」を選択します
-
プライマリ オフ のままにします。 CRM ID は Luma web サイトへのほとんどの訪問者に対して存在しないので、プライマリ識別子として ECID を上書きしないでください。 ECID 以外をプライマリ識別子として使用することはめったにありません。 通常、これらの手順ではデフォルト設定については言及しませんが、後で自分の実装で問題が発生するのを防ぐために、この設定を呼び出します。
-
「ライブラリに保存」ボタンを選択します(作業ライブラリ
Luma Platform Tutorial
残ります)。
ID マップデータ要素を XDM オブジェクトに追加します
更新が必要なデータ要素として、もう 1 つ XDM オブジェクトデータ要素があります。 この 1 つの ID を渡すために 3 つの個別のデータ要素を更新する必要があると奇妙に思えるかもしれませんが、このプロセスは、複数の ID に対して拡張するように設計されています。 心配しないでください。このレッスンはもうほとんど終わりです。
- XDM オブジェクトデータ要素を開きます
- IdentityMap XDM フィールドを開きます
- データ要素 として、アイコンを選択してデータ要素選択モーダルを開き、
Identities
データ要素を選択します - 前回の演習
Luma Platform Tutorial
作業ライブラリとしてを選択したので、最近の変更はライブラリに直接保存されています。 公開フロー画面を使用して変更を公開する代わりに、青いボタンのドロップダウンを開いて、「ライブラリおよびビルドに保存 を選択できます
ID の検証
CRM ID が Web SDK で現在送信されていることを検証するには、以下を行います。
- Luma web サイトを開きます。
- 前の手順に従って、デバッガーを使用してタグプロパティにマッピングします。
- Luma web サイトの右上にある ログイン リンクを選択します
- 資格情報
test@adobe.com
/test
を使用してログイン - 認証が完了したら、デバッガー(最新のリクエストの Adobe Experience Platform Web SDK/Network Requests/events)でExperience Platform Web SDK 呼び出しを調べると、
lumaCrmId
が表示されます。
- ECID 名前空間を使用してユーザープロファイルを検索し、値を再度設定します。 プロファイルには、CRM ID とロイヤルティ ID、名前や電話番号などのプロファイルの詳細が表示されます。 すべての ID とデータは、単一のリアルタイム顧客プロファイルにステッチされています。
その他のリソース
お疲れ様でした。 Web SDK と Launch に関する多くの情報でした。 本格的な実装にはさらに多くの関与がありますが、Platform で開始して結果を確認するのに役立つ基本です。
Luma Tutorial Platform
製品プロファイルから Prod サンドボックスを削除できますデータエンジニアの方は、 クエリを実行のレッスンに進んでください。
データアーキテクトは、 結合ポリシーに進むことができます。