Web SDK を使用したデータの取り込み
このクイックスタートガイドでは、Adobe Experience Platform Web SDK と Edge Network を使用して web サイトトラッキングデータを Adobe Experience Platform に直接取り込み、Customer Journey Analytics で使用する方法について説明します。
これには、次の手順を実行する必要があります。
-
Adobe Experience Platform で スキーマとデータセットを設定 し、収集するデータのモデル(スキーマ)と、実際にデータ(データセット)を収集する場所を定義します。
-
データストリームの設定:収集したデータを Adobe Experience Platform で設定したデータセットにルーティングするように Adobe Experience Platform Edge Network を設定します。
-
タグを使用:web サイト上のデータレイヤーのデータに対して、ルールやデータ要素を容易に設定できます。次に、データが Adobe Experience Platform Edge Network 上に設定されたデータストリームに送信されることを確認します。
-
デプロイと検証 を行います。タグの開発を繰り返し実行し、すべての検証が完了したら、実稼動環境で公開できる環境を構築します。
-
Customer Journey Analytics で、接続を設定 します。この接続には、(少なくとも)Adobe Experience Platform データセットを含める必要があります。
-
Customer Journey Analytics で データ表示を設定 し、Analysis Workspace で使用する指標とディメンションを定義します。
-
Customer Journey Analytics で プロジェクトを設定 して、レポートとビジュアライゼーションを作成します。
スキーマとデータセットの設定
データをAdobe Experience Platformに取り込むには、まず収集するデータを定義する必要があります。 ダウンストリームの機能で認識し、処理するには、Adobe Experience Platform に取り込まれるすべてのデータが、標準的な非正規化された構造に準拠する必要があります。エクスペリエンスデータモデル(XDM)は、この構造をスキーマの形式で提供する標準フレームワークです。
スキーマを定義したら、1 つ以上のデータセットを使用して、データの収集を保存および管理します。データセットは、スキーマ(列)とフィールド(行)を含んだデータのコレクション(通常はテーブル)のストレージおよび管理用の構成体です。
Adobe Experience Platform に取り込まれるすべてのデータは、データセットとして保持する前に、事前定義済みのスキーマに準拠している必要があります。
スキーマの設定
Web サイトを訪問するプロファイルからの最小限のデータ(ページ名、ID など)を追跡することがあります。
まず、このデータをモデル化するスキーマを定義する必要があります。
スキーマを設定するには:
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「スキーマ」を選択します。
-
スキーマを作成 を選択します。
. -
スキーマ作成ウィザードの「クラスを選択」手順で、次の操作を行います。
-
エクスペリエンスイベント を選択します。
note info INFO エクスペリエンスイベントスキーマは、プロファイルの 動作 をモデル化するために使用します(シーン名、買い物かごに追加するプッシュボタンなど)。 個々のプロファイルスキーマは、プロファイル_属性_(名前、メール、性別など)のモデル化に使用されます。 -
「次へ」を選択します。
-
-
スキーマを作成 ウィザードの 名前とレビューの手順 で、次の操作を行います。
-
スキーマの スキーマ表示名 と(オプション) 説明 を入力します。
-
「完了」を選択します。
-
-
「スキーマ例の構造」タブで、次の操作を行います。
-
「フィールドグループ」で「+ 追加」を選択します。
フィールドグループは、スキーマを簡単に拡張できる、再利用可能なオブジェクトと属性のコレクションです。
-
フィールドグループを追加ダイアログで、リストから「AEP Web SDK ExperienceEvent」フィールドグループを選択します。
「プレビュー」ボタンを選択すると、このフィールドグループに属するフィールド(
web > webPageDetails > name
など)のプレビューを表示できます。「戻る」を選択してプレビューを閉じます。
-
「フィールドグループを追加」を選択します。
-
-
構造パネルで、スキーマ名の隣にある「+」をクリックします。
-
「フィールドプロパティ」パネルで、名前に
Identification
、表示名に ID と入力し、タイプで オブジェクト、フィールドグループで ExperienceEvent Core v2.1 を選択します。note note NOTE そのフィールドグループが使用できない場合は、ID フィールドを含む別のフィールドグループを探します。 または 新しいフィールドグループを作成して 新しい ID フィールドを追加( ecid
、crmId
など、必要なその他)をフィールドグループに追加し、その新しいフィールドグループを選択します。ID オブジェクトは、スキーマに ID 機能を追加します。 この場合、Experience Cloud ID とメールアドレスを使用して、サイトを訪問しているプロファイルを識別します。 人物の ID を追跡するために使用できる属性は他にも多数あります(顧客 ID、ロイヤルティ ID など)。
「適用」を選択して、このオブジェクトをスキーマに追加します。
-
先ほど追加した ID オブジェクトで「ecid」フィールドをクリックし、右パネルの ID 名前空間リストから ID、プライマリ ID および ECID を選択します。
Experience Cloud ID を、Adobe Experience Platform Identity Service が同じ ECID を持つプロファイルの動作を組み合わせる(ステッチする)ために使用するプライマリ ID として指定します。
「適用」を選択します。ecid 属性にフィンガープリントアイコンが表示されます。
-
先ほど追加した ID オブジェクトで「メール」フィールドをクリックし、フィールドプロパティパネルのID 名前空間リストから ID と メール を選択します。
メールアドレスを、Adobe Experience Platform Identity Service がプロファイルの動作を組み合わせる(ステッチする)ために使用するもう一つの ID として指定します。
「適用」を選択します。メール属性にフィンガープリントアイコンが表示されます。
「保存」を選択します。
-
スキーマの名前を表示しているスキーマのルート要素を選択してから、プロファイル スイッチをクリックします。
プロファイルのスキーマを有効にするよう求められます。有効にすると、このスキーマに基づくデータセットにデータが取り込まれたときに、そのデータをリアルタイム顧客プロファイルと結合します。
詳しくは、リアルタイム顧客プロファイルで使用するスキーマを有効にするを参照してください。
note important IMPORTANT プロファイルで有効にしたスキーマを保存すると、そのスキーマはプロファイルで無効にできなくなります。 -
「保存」を選択してスキーマを保存します。
Web サイトから取得できるデータをモデル化する、最小限のスキーマを作成しました。このスキーマを使用することで、Experience Cloud ID とメールアドレスを使用してプロファイルを識別できます。プロファイルのスキーマを有効にすることで、web サイトから取り込んだデータをリアルタイム顧客プロファイルへと確実に追加できます。
行動データの横にある、サイトからプロファイル属性データ(ニュースレターを購読したプロファイルの詳細など)を取り込むこともできます。
このプロファイルデータを取得するには、次を実行します。
-
XDM Individual Profile クラスに基づいてスキーマを作成します。
-
Profile Core v2 フィールドグループをスキーマに追加します。
-
Profile Core v2 フィールドグループに基づいて ID オブジェクトを追加します。
-
Experience Cloud ID をプライマリ識別子、メールを識別子として定義します。
-
プロファイルでスキーマを有効にする
フィールドグループと個々のフィールドをスキーマに追加、またはスキーマから削除する方法について詳しくは、UI でのスキーマの作成と編集を参照してください。
データセットの設定
スキーマを使用して、データモデルを定義しました。次に、そのデータを保存および管理するための構成を定義する必要があります。これは、データセットを通じて行われます。
データセットを設定するには:
-
Adobe Experience Platform UI の左パネルの「データ管理」で、「データセット」を選択します。
-
「データセットを作成」を選択します。
-
「スキーマからデータセットを作成」をクリックします。
-
作成したスキーマを選択し、「次へ」を選択します。
-
データセットに名前を付け、(オプション)説明を入力します。
-
「完了」を選択します。
-
「プロファイル」スイッチを選択します。
プロファイルのデータセットを有効にするよう求められます。有効にすると、データセットは、取り込んだデータを使用してリアルタイム顧客プロファイルを強化します。
note important IMPORTANT プロファイルのデータセットを有効にできるのは、データセットが準拠するスキーマがプロファイルに対しても有効になっている場合のみです。
データセットの表示、プレビュー、作成、削除の方法について詳しくは、データセット UI ガイドを参照してください。リアルタイム顧客プロファイルのデータセットを有効にする方法について説明します。
データストリームの設定
データストリームは、Adobe Experience Platform Web および Mobile SDK を実装する際のサーバーサイド設定を表します。Adobe Experience Platform SDK を使用してデータを収集する際、データはAdobe Experience Platform Edge Network に送信されます。データの転送先となるサービスを決定するデータストリームです。
設定では、web サイトから収集したデータを Adobe Experience Platform のデータセットに送信する必要があります。
データストリームを設定するには:
-
Adobe Experience Platform UI の左パネルで、「データ収集」から「データストリーム」を選択します。
-
新しいデータストリーム を選択します。
-
データストリームに名前を付けて説明します。イベントスキーマリストからスキーマを選択します。
-
「保存」を選択します。
-
「サービスを追加」を選択します。
-
サービスを追加画面で、次の操作を行います。
-
サービスリストから Adobe Experience Platform を選択します。
-
「有効」が選択されていることを確認します。
-
イベントデータセットリストからお使いのデータセットを選択します。
-
その他の設定はそのままにし、「保存」を選択してデータストリームを保存します。
-
これで、web サイトから収集したデータを Adobe Experience Platform でデータセットに転送するように、データストリームが設定されました。
データストリームの設定方法と機密データの処理方法について詳しくは、データストリームの概要を参照してください。
タグの使用
データを収集するためのコードをサイトに実装するには、Adobe Experience Platformのタグ機能を使用します。 このタグ管理ソリューションを使用すると、他のタグ要件と共にコードをデプロイできます。タグは、Adobe Experience Platform Web SDK 拡張機能を使用して、Adobe Experience Platform とのシームレスな統合を提供します。
タグを作成する
-
Adobe Experience Platform UI の左パネルの「データ収集」で、「タグ」を選択します。
-
「新しいプロパティ」を選択します。
タグに名前を付け、「Web」を選択し、ドメイン名を入力します。「保存」を選択して続行します。
タグの設定
タグを作成したら、適切な拡張機能を使用してタグを設定し、サイトをトラッキングしてAdobe Experience Platformにデータを送信する方法に応じて、データ要素とルールを設定する必要があります。
タグのプロパティをクリックして新しく作成したタグを開きます。
拡張機能
(データストリーム経由で)Adobe Experience Platformにデータを確実に送信できるようにするには、タグに Platform Web SDKAdobe拡張機能を追加します。
Adobe Experience Platform Web SDK 拡張機能を作成して設定するには:
-
左パネルで「拡張機能」を選択します。
-
上部のバーで「カタログ」をクリックします。
-
Adobe Experience Platform Web SDK 拡張機能を検索またはスクロールし、「インストール」をクリックしてインストールします。
{width="35%"}
-
サンドボックスと、以前に作成した実稼動環境、(オプション)ステージング環境および開発環境用のデータストリームを選択します。
「保存」を選択します。
詳しくは、Adobe Experience Platform Web SDK 拡張機能の設定を参照してください。
Web SDK には、Adobe Experience Cloud ID サービス がネイティブに含まれているので、タグに ID サービス拡張機能を追加する必要はありません。
データ要素
データ要素は、データディクショナリ(またはデータマップ)の構築ブロックです。データ要素を使用して、マーケティングおよび広告テクノロジー全体でデータを収集、整理、配信します。タグでデータレイヤーから読み取り、Adobe Experience Platform にデータを配信するために使用できるデータ要素を設定します。
データ要素には様々なタイプがあります。最初にデータ要素を設定して、サイトでユーザーが表示しているページ名を取り込みます。
ページ名データ要素を定義するには:
-
左パネルで「データ要素」を選択します。
-
「データ要素を追加」を選択します。
-
データ要素を作成ダイアログで、次の手順を実行します。
-
データ要素に名前を付けます(例:
Page Name
)。 -
拡張機能リストから、「Core」を選択します。
-
データ要素タイプリストから、ページ情報 を選択します。
-
属性リストから、「タイトル」を選択します。
または、データレイヤーの変数の値(
pageName
や JavaScript 変数 データ要素タイプなど)を使用して、データ要素を定義できました。 -
「保存」を選択します。
-
次に、Experience Cloud ID(Adobe Experience Platform Web SDK によって自動的に提供され、Experience Cloud ID サービス拡張機能を通じて使用できる)を参照するデータ要素を設定します。
ECID データ要素を定義するには:
-
左パネルで「データ要素」を選択します。
-
「データ要素を追加」を選択します。
-
データ要素を作成ダイアログで、次の手順を実行します。
-
データ要素に名前を付けます(例:
ECID
)。 -
拡張機能リストから、Experience Cloud ID サービス を選択します。
-
データ要素タイプリストから、ECID を選択します。
-
「保存」を選択します。
-
最後に、特定のデータ要素を、前に定義したスキーマにマッピングします。XDM スキーマを表す別のデータ要素を定義します。
XDM オブジェクトデータ要素を定義するには:
-
左パネルで「データ要素」を選択します。
-
「データ要素を追加」を選択します。
-
データ要素を作成ダイアログで、次の手順を実行します。
-
データ要素に名前を付けます(例:
XDM - Page View
)。 -
拡張機能リストから Adobe Experience Platform Web SDK を選択します。
-
データ要素タイプリストから、XDM オブジェクト を選択します。
-
サンドボックスリストでお使いのサンドボックスを選択します。
-
スキーマリストからお使いのスキーマを選択します。
-
スキーマ内で定義した
identification > core > ecid
属性を、ECID データ要素にマッピングします。円柱アイコンを選択すると、データ要素のリストから ECID データ要素を簡単に選択できます。 -
スキーマ内で定義した
web > webPageDetails > name
属性を、ページ名データ要素にマッピングします。 -
「保存」を選択します。
-
ルール
Adobe Experience Platform のタグは、ルールベースのシステムに従います。ユーザーの操作と関する各種データを参照します。ルールで設定された条件が満たされると、ルールは、特定した拡張機能、スクリプトまたはクライアント側コードをトリガーします。ルールを使用し、Adobe Experience Platform Web SDK 拡張機能を使用して、XDM オブジェクトなどのデータを Adobe Experience Platform に送信できます。
ルールを定義するには:
-
左パネルで「ルール」を選択します。
-
「新規ルールを作成」を選択します。
-
ルールを作成ダイアログで、次の手順を実行します。
-
ルールに名前を付けます(例:
Page View
)。 -
「イベント」の下の「+ 追加」を選択します。
-
イベント設定ダイアログで、次の手順を実行します。
-
拡張機能リストから、「Core」を選択します。
-
イベントタイプリストから「読み込んだウィンドウ」を選択します。
-
「変更を保持」を選択します。
-
-
「アクション」の下の「+ 追加」を選択します。
-
アクション設定ダイアログで、次の手順を実行します。
-
拡張機能リストから Adobe Experience Platform Web SDK を選択します。
-
アクションタイプリストから「イベントを送信」を選択します。
-
タイプリストから、web.webpagedetails.pageViews を選択します。
-
XDM データの横にある円柱アイコンを選択し、データ要素のリストから「XDM - ページビュー」を選択します。
- 「変更を保持」を選択します。
-
-
ルールは次のようになります。
-
「保存」を選択します。
-
上記は、他のデータ要素の値を含む XDM データをAdobe Experience Platformに送信するルールを定義する例に過ぎません。
タグ内で様々な方法でルールを使用して、(データ要素を使用して)変数を操作できます。
詳しくは、ルールを参照してください。
タグを作成して公開する
データ要素とルールを定義したら、タグを作成して公開する必要があります。 ライブラリビルドを作成する場合は、そのビルドを環境に割り当てる必要があります。ビルドの拡張機能、ルール、およびデータ要素がコンパイルされ、割り当てられた環境に配置されます。各環境は、割り当てられたビルドをサイトに統合できる、一意の埋め込みコードを提供します。
タグを構築して公開するには、次の手順に従います。
-
左パネルから「公開フロー」をクリックします。
-
作業ライブラリを選択/ライブラリを追加… を選択します。
-
ライブラリを作成ダイアログで、次の手順を実行します。
-
ライブラリに名前を付けます。
-
環境リストから「開発(開発)」を選択します。
-
「+ 変更されたリソースをすべて追加」を選択します。
-
「開発用に保存およびビルド」を選択します。
タグが保存され、開発環境用に作成されます。 緑のドットは、開発環境でタグが正常に作成されたことを示します。
-
-
… を選択してライブラリを再構築するか、ライブラリをステージング環境または実稼動環境に移動することができます。
Adobe Experience Platform タグは、Adobe Experience Platform Web SDK のデプロイに対応する必要がある、シンプルな公開ワークフローから複雑な公開ワークフローをサポートします。
詳しくは、公開の概要を参照してください。
タグコードの取得
最後に、追跡する web サイトにタグをインストールする必要があります。これは、web サイトのテンプレートのヘッダータグにコードを配置することを意味します。
タグを参照するコードを取得するには:
-
左パネルで「環境」を選択します。
-
環境のリストから、正しいインストール(ボックス)ボタンを選択します。
Web インストール手順ダイアログで、次のように読み込むスクリプトコードの横にある「コピー」ボタンを選択します。
code language-none <script src="https://assets.adobedtm.com/2a518741ab24/.../launch-...-development.min.js" async></script>>
-
「閉じる」を選択します。
開発環境用のコードの代わりに、Adobe Experience Platform Web SDK をデプロイするプロセスの場所に基づいて、別の環境(ステージング、実稼動)を選択することもできます。
詳しくは、環境を参照してください。
デプロイと検証
次に、web サイトの開発バージョンで、<head>
タグをデプロイできます。デプロイすると、web サイトは Adobe Experience Platform へのデータの収集を開始します。
実装を検証し、必要に応じて修正したら、タグの公開ワークフロー機能を使用して、ステージング環境と実稼動環境にデプロイします。
接続の設定
Adobe Experience Platform データを Customer Journey Analytics で使用するには、接続(スキーマ、データセット、ワークフローの設定によって生成されたデータを含む)を作成します。
接続を使用すれば、Adobe Experience Platform のデータセットをワークスペースに統合できます。これらのデータセットに関するレポートを作成するには、まずAdobe Experience PlatformとWorkspaceのデータセット間で接続を確立する必要があります。
接続を作成するには:
-
Customer Journey Analytics UI で、「接続」をクリックします。
-
「新しい接続を作成」を選択します。
-
名称未設定の接続画面で、次の手順を実行します。
「接続設定」で接続に名前を付けて説明します。
データ設定のサンドボックスリストから適切なサンドボックスを選択し、毎日のイベントの平均数リストから日次イベントの数を選択します。
「データセットを追加」を選択します。
「データセットを追加」の「データセットを選択」手順で、次の操作を行います。
-
先ほど作成したデータセット(
Example dataset
)や、接続に含める他のデータセットに関連付けます。 -
「次へ」を選択します。
「データセットを追加」の「データセット設定」手順で、次の操作を行います。
-
各データセットに対して、次の手順を行います。
-
Adobe Experience Platform のデータセットスキーマで定義されている使用可能な ID からユーザー ID を選択します。
-
データソースタイプリストから正しいデータソースを選択します。「その他」を指定している場合は、データソースの説明を追加します。
-
必要に応じて すべての新しいデータを読み込み および データセットの既存データのバックフィル を選択します。
-
-
「データセットを追加」を選択します。
「保存」を選択します。
-
接続を作成および管理する方法、およびデータセットを選択して組み合わせる方法について詳しくは、接続の概要を参照してください。
データ表示の設定
データ表示は、Customer Journey Analytics に特有のコンテナで、接続からデータを解釈する方法を決定できます。Analysis Workspace で使用可能なすべてのディメンションと指標、およびこれらのディメンションと指標からデータを取得する列を指定します。データ表示は、Analysis Workspace でレポートの準備を行う際に定義します。
データ表示を作成するには:
-
Customer Journey Analytics UI の上部ナビゲーションで、「データ表示」をクリックします。
-
「新しいデータ表示を作成」を選択します。
-
設定手順で、次の操作を行います。
接続リストで接続を選択します。
接続に名前を付け、(オプションで)説明します。
「保存して続行」を選択します。
-
コンポーネント手順で、次の操作を行います。
指標またはディメンションコンポーネントボックスに含めるスキーマフィールドや標準コンポーネントを追加します。
「保存して続行」を選択します。
-
設定手順で、次の操作を行います。
設定をそのままにし、「保存して終了」を選択します。
データ表示の作成および編集方法、データ表示で使用できるコンポーネント、フィルターおよびセッションの設定の使用方法について詳しくは、データ表示の概要を参照してください。
プロジェクトの設定
Analysis Workspace は、データに基づき、分析をすばやく構築してインサイトを共有できる、柔軟なブラウザーツールです。ワークスペースプロジェクトでは、データコンポーネント、テーブル、およびビジュアライゼーションを組み合わせて、分析を作成し、組織内の任意のユーザーと共有できます。
プロジェクトを作成するには:
-
Customer Journey Analytics UI で、「プロジェクト」をクリックします。
-
左側のナビゲーションの「プロジェクト」を選択します。
-
「プロジェクトを作成」を選択します。
「空のプロジェクト」を選択します。
-
リストからデータ表示を選択します。
します。
-
最初のレポートを作成するには、 パネル の フリーフォームテーブル でディメンションと指標のドラッグ&ドロップを開始します。 例えば、
Program Points Balance
およびPage View
指標、email
をディメンションにドラッグすると、web サイトを訪問し、ロイヤルティポイントを収集するロイヤルティプログラムに参加しているプロファイルの概要をすばやく把握できます。
コンポーネント、ビジュアライゼーション、パネルを使用してプロジェクトを作成し、分析を構築する方法について詳しくは、Analysis Workspace の概要を参照してください。