Platform Web SDK でのAdobe Analyticsの設定
次を使用してAdobe Analyticsを設定する方法を説明します。 Experience PlatformWeb SDKでは、タグルールを作成してAdobe Analyticsにデータを送信し、Analytics が期待どおりにデータをキャプチャしていることを検証します。
Adobe Analytics は、顧客像を把握し、顧客インテリジェンスを活用してビジネスを導く力をユーザーに提供する、業界最先端のアプリケーションです。
学習内容
このレッスンを最後まで学習すると、以下の内容を習得できます。
- Adobe Analytics用の XDM スキーマの設定と、自動マッピングと Analytics 用の手動でマッピングされた XDM 変数の違いについて説明します。
- Adobe Analyticsを有効にするためのデータストリームの設定
- 個々のデータ要素または配列全体のデータ要素を XDM オブジェクトにマッピングする
- XDM オブジェクトを使用してAdobe Analyticsでページビューをキャプチャします
- Adobe Analytics製品文字列の XDM オブジェクトを使用した e コマースデータのキャプチャ
- Adobe Analytics変数が XDM オブジェクトで設定されていることを検証するには、Experience PlatformDebugger を使用します。
- Adobe Analyticsの処理ルールを使用したカスタム変数の設定
- リアルタイムレポートを使用して、Adobe Analyticsがデータを取得したことを検証する
前提条件
タグ、Adobe Analytics、および Luma デモサイト ログイン機能とショッピング機能
テスト/開発レポートスイート ID が少なくとも 1 つ必要です。 このチュートリアルで使用できるテスト/開発用レポートスイートがない場合は、 1 つを作成してください.
チュートリアルの前の節のすべての手順を完了している。
XDM スキーマと Analytics の変数
おめでとうございます。のAdobe Analyticsと互換性のあるスキーマを既に設定しています スキーマの設定 レッスン!
Platform Web SDK の実装は、できる限り製品に依存しない必要があります。 Adobe Analyticsの場合、マッピングされた eVar、prop およびイベントは、従来おこなわれていたように、スキーマの作成時やタグルールの設定時には発生しません。 代わりに、各 XDM キー値ペアは、次の 2 つの方法のいずれかで Analytics 変数にマッピングされるコンテキストデータ変数になります。
- 予約 XDM フィールドを使用して自動的にマッピングされた変数
- Analytics 処理ルールを使用して手動でマッピングした変数
Adobe Analyticsに自動マッピングされる XDM 変数については、 Analytics で自動的にマッピングされる変数. 自動マッピングされない変数は、手動でマッピングする必要があります。
で作成されたスキーマ スキーマの設定 レッスンには、次の表で概要を示すように、Analytics 変数に自動マッピングされるいくつかが含まれます。
identitymap.ecid.[0].id
web.webPageDetails.pageViews.value
web.webPageDetails.name
web.webPageDetails.server
web.webPageDetails.siteSection
commerce.productViews.value
commerce.productListViews.value
commerce.checkouts.value
commerce.purchases.value
commerce.order.currencyCode
commerce.order.purchaseID
productListItems[].SKU
productListItems[].name
productListItems[].quantity
productListItems[].priceTotal
productListItems
オブジェクト。2022 年 8 月 18 日現在
productListItems[].SKU
は、s.products 変数内の製品名へのマッピングを優先します。に設定された値
productListItems[].name
は、次の場合にのみ製品名にマッピングされます: productListItems[].SKU
は存在しません。 それ以外の場合は、マッピングが解除され、コンテキストデータで使用できます。空の文字列や null をに設定しないでください。
productListItems[].SKU
. これにより、s.products 変数内の製品名にマッピングした場合に、望ましくない影響が生じます。データストリームの設定
Platform Web SDK は、Web サイトから Platform Edge Network にデータを送信します。 次に、データストリームが Platform Edge Network に対し、そのデータを転送する場所 ( この場合はAdobe Analyticsレポートスイート ) を伝えます。
-
に移動します。 データ収集 インターフェイス
-
左側のナビゲーションで、「 データストリーム
-
以前に作成したを選択
Luma Web SDK
datastream -
「サービスを追加」を選択します。
-
選択 Adobe Analytics として サービス
-
次を入力します。 レポートスイート ID (開発レポートスイートの)
-
「保存」を選択します
note tip TIP 「 」を選択してレポートスイートを追加する レポートスイートの追加 は、複数のスイートタグ付けと同等です。
追加のデータ要素の作成
次に、Luma データレイヤーから追加のデータをキャプチャし、Platform Edge ネットワークに送信します。 このレッスンでは、一般的なAdobe Analytics要件に焦点を当てていますが、取り込んだすべてのデータを、データストリーム設定に基づいて他の宛先に簡単に送信できます。 例えば、 Adobe Experience Platformレッスンを完了した場合、このレッスンでキャプチャした追加データも Platform に送信されます。
e コマースデータ要素の作成
「データ要素の作成」レッスンでは、次の操作をおこないます。 JavaScript データ要素の作成 がキャプチャしたコンテンツと id の詳細。 次に、e コマースデータをキャプチャするための追加のデータ要素を作成します。 これは、 Luma デモサイト は、買い物かご内の製品詳細ページと製品に異なるデータレイヤー構造を使用します。各シナリオのデータ要素を作成する必要があります。 Luma データレイヤーから必要なものを取得するには、いくつかのカスタムコードデータ要素を作成する必要があります。独自のサイトにを実装する際に必要になる場合と不要な場合があります。 この場合、買い物かごの項目の配列をループして、各製品の特定の詳細を取得する必要があります。 以下の提供されているコードスニペットを使用します。
-
チュートリアルに使用するタグプロパティを開きます。
-
に移動します。 データ要素
-
選択 データ要素を追加
-
名前を付ける
product.productInfo.sku
-
以下を使用します。 カスタムコード データ要素タイプ
-
次のチェックボックスをオンにしておきます。 強制的に小文字に変換値 および クリーンテキスト オフ
-
終了
None
として ストレージ期間 の設定は、ページごとにこの値が異なるので、 -
選択 編集画面を開く
-
次のコードをコピー&ペーストします。
code language-javascript var cart = digitalData.product; var cartItem; cart.forEach(function(item){ cartItem = item.productInfo.sku; }); return cartItem;
-
選択 保存 カスタムコードを保存するには、以下を実行します。
-
選択 保存 データ要素を保存するには、以下を実行します。
同じ手順に従って、これらの追加のデータ要素を作成します。
-
product.productInfo.title
code language-javascript var cart = digitalData.product; var cartItem; cart.forEach(function(item){ cartItem = item.productInfo.title; }); return cartItem;
-
cart.productInfo
code language-javascript var cart = digitalData.cart.cartEntries; var cartItem = []; cart.forEach(function(item, index, array){ var qty = parseInt(item.qty); var price = parseInt(item.price); cartItem.push({ "SKU": item.sku, "name":item.title, "quantity":qty, "priceTotal":price }); }); return cartItem;
これらのデータ要素を追加し、 データ要素の作成 レッスンでは、次のデータ要素が必要になります。
cart.orderId
cart.productInfo
identityMap.loginID
page.pageInfo.hierarchie1
page.pageInfo.pageName
page.pageInfo.server
product.productInfo.sku
product.productInfo.title
user.profile.attributes.loggedIn
user.profile.attributes.username
xdm.content
- identityMap を使用して、 ID マップデータ要素の作成 ~の運動 データ要素の作成 レッスン。
- web 次のようにコンテンツをキャプチャするオブジェクト content XDM オブジェクト ~の運動 データ要素の作成 上記のすべてのデータ要素に関するレッスンです。
ページビュー数を増分
「データ要素の作成」レッスンでは、次の操作をおこないます。 作成済み xdm.content
データ要素 を使用して、コンテンツディメンションを取り込みます。 現在はAdobe Analyticsにデータを送信しているので、追加の XDM フィールドもマッピングして、ビーコンが Analytics のページビューとして処理される必要があることを示す必要があります。
-
を開きます。
xdm.content
データ要素 -
下にスクロールし、を選択して開くまで待ちます。
web.webPageDetails
-
を選択して、 pageViews object
-
設定 値 から
1
-
「保存」を選択します
s.t()
次を使用する Analytics のページビュービーコン AppMeasurement.js
. リンククリックビーコンの場合、 webInteraction.linkClicks.value
から 1
製品文字列の設定
製品文字列にマッピングする前に、XDM スキーマ内に、Adobe Analyticsと特別な関係を持つ e コマースデータを取り込むために使用される、次の 2 つの主なオブジェクトがあることを理解しておくことが重要です。
- The
commerce
オブジェクトは、次のような Analytics イベントを設定します。prodView
,scView
、およびpurchase
- The
productListItems
オブジェクトセット Analytics のディメンション(例: )productID
.
詳しくは、 コマースおよび製品データの収集 を参照してください。
また、次のことを理解することも重要です。 個々の属性を提供する 個々の XDM フィールドまたは 配列全体を提供する を XDM オブジェクトに追加します。
個々の属性の XDM オブジェクトへのマッピング
個々の変数にマッピングして、Luma デモサイトの製品の詳細ページのデータをキャプチャできます。
-
の作成 XDM オブジェクト データ要素タイプ 名前付き
xdm.commerce.prodView
-
以前のレッスンで使用したのと同じ Platform サンドボックスと XDM スキーマを選択します
-
を開きます。 commerce object
-
を開きます。 productViews オブジェクトとセット 値 から
1
note tip TIP この手順は、 prodView
Analytics のイベント -
下にスクロールして、「 」を選択します。
productListItems
配列 -
選択 個々の項目を指定
-
選択 項目を追加
note caution CAUTION The productListItems
はarray
データ型を使用することをお勧めします。 Luma デモサイトのデータレイヤー構造と、Luma サイトでは一度に 1 つの製品のみ表示できるので、項目を個別に追加します。 独自の Web サイトにを実装する場合、データレイヤーの構造に応じて、配列全体を提供できる場合があります。 -
選択して開く 項目 1
-
次の XDM 変数をデータ要素にマッピングします
productListItems.item1.SKU
コピー先:%product.productInfo.sku%
productListItems.item1.name
コピー先:%product.productInfo.title%
note important IMPORTANT この XDM オブジェクトを保存する前に、「グローバル」変数とページビュー増分も設定してください。
-
「保存」を選択します
配列全体の XDM オブジェクトへのマッピング
前述のように、Luma デモサイトでは、買い物かご内の製品に異なるデータレイヤー構造を使用しています。 カスタムコードデータ要素 cart.productInfo
以前に作成したデータ要素は、 digitalData.cart.cartEntries
データレイヤーオブジェクトを作成し、必要な XDM オブジェクトスキーマに変換します。 新しい形式 完全に一致する必要があります で定義されたスキーマ productListItems
XDM スキーマのオブジェクト。
例として、Luma サイトのデータレイヤー(左)と翻訳済みのデータ要素(右)の比較を参照してください。
データ要素との比較 productListItems
構造(ヒント、一致する必要があります)。
price
および qty
データ要素の数値の形式に戻しました。 これらの形式の要件は、Platform のデータの整合性に重要で、 スキーマの設定 手順 この例では、 量 は 整数 データタイプ。次に、XDM オブジェクトを配列全体にマッピングします。 買い物かごページ上の製品を取り込む XDM オブジェクトデータ要素を作成します。
-
の作成 XDM オブジェクト データ要素タイプ 名前付き
xdm.commerce.cartView
-
このチュートリアルで使用するのと同じ Platform サンドボックスと XDM スキーマを選択します
-
を開きます。 commerce object
-
を開きます。 productListViews オブジェクトとセット
value
から1
note tip TIP この手順は、 scView
Analytics のイベント -
下にスクロールして、「 」を選択します。 productListItems 配列
-
選択 アレイ全体を提供
-
マッピング先
cart.productInfo
データ要素note important IMPORTANT この XDM オブジェクトを保存する前に、「グローバル」変数とページビュー増分も設定してください。
-
「保存」を選択します
別のを作成 XDM オブジェクト データ要素タイプ チェックアウトの対象: xdm.commerce.checkout
. 今回は、 commerce.checkouts.value から 1
,マップ productListItems から cart.productInfo
先ほどおこなったように、「グローバル」変数とページビューカウンターを追加します。
scCheckout
Analytics のイベントを取得するための追加の手順があります。 purchase
イベント:
-
別のを作成 XDM オブジェクト データ要素タイプ 次の購入:
xdm.commerce.purchase
-
開く commerce object
-
を開きます。 注文 object
-
マップ purchaseID から
cart.orderId
データ要素 -
設定 currencyCode をハードコードされた値に
USD
note tip TIP これは、 s.purcahseID
およびs.currencyCode
Analytics の変数 -
を選択して、
purchases
オブジェクトとセットvalue
から1
note tip TIP これは、 purchase
Analytics のイベントnote important IMPORTANT この XDM オブジェクトを保存する前に、「グローバル」変数とページビュー増分も設定してください。
-
「保存」を選択します
これらの手順の最後に、次の 5 つの XDM オブジェクトデータ要素を作成する必要があります。
xdm.commerce.cartView
xdm.commerce.checkout
xdm.commerce.prodView
xdm.commerce.purchase
xdm.content
Platform Web SDK 用の追加ルールの作成
複数の XDM オブジェクトデータ要素を作成したら、ルールを使用してビーコンを設定する準備が整いました。 この演習では、e コマースイベントごとに個々のルールを作成し、適切なページでルールが実行されるように条件を使用します。 まず、製品表示イベントを開始します。
-
左側のナビゲーションから、「 」を選択します。 ルール 次に、「 ルールを追加
-
名前を付ける
product view - library load - AA
-
の下 イベント を選択します。 読み込まれたライブラリ(ページ上部)
-
の下 条件 を選択して、 追加
-
終了 論理タイプ as 標準
-
終了 拡張機能 as コア
-
選択 条件タイプ as Path Without Query String
-
右側で、 Regex トグル
-
の下 パスが次と等しい 設定
/products/
. Luma デモサイトの場合、ルールは製品ページ上のトリガーのみを確認します。 -
選択 変更を保持
-
の下 アクション 選択 追加
-
選択 Adobe Experience Platform Web SDK 拡張
-
選択 アクションタイプ as イベントを送信
-
The タイプ フィールドには、選択する値のドロップダウンリストが含まれます。 選択
commerce.productViews
note tip TIP ここで選択した値は、データが Analytics にマッピングされる方法に影響しませんが、Adobe Experience Platformのセグメントビルダーインターフェイスで使用されるので、この変数を慎重に適用することをお勧めします。 選択した値は、 c.a.x.eventtype
コンテキストデータ変数のダウンストリーム。 -
の下 XDM データ を選択し、
xdm.commerce.prodView
XDM オブジェクトのデータ要素 -
選択 変更を保持
-
ルールは次のようになります。 「保存」を選択します
次のパラメーターを使用して、他のすべての e コマースイベントに対しても同じ手順を繰り返します。
ルール名:買い物かご表示 — ライブラリ読み込み — AA
- イベントタイプ:読み込まれたライブラリ(ページ上部)
- 条件: /content/luma/us/en/user/cart.html
- 「Web SDK - Send Action」の値を入力します。: commerce.productListViews
- Web SDK — 送信アクションの XDM データ:
%xdm.commerce.cartView%
ルール名: checkout - library load - AA
- イベントタイプ:読み込まれたライブラリ(ページ上部)
- 条件 /content/luma/us/en/user/checkout.html
- Web SDK のタイプ — 送信アクション: commerce.checkouts
- Web SDK — 送信アクションの XDM データ:
%xdm.commerce.checkout%
ルール名: purchase - library load - AA
- イベントタイプ:読み込まれたライブラリ(ページ上部)
- 条件 /content/luma/us/en/user/checkout/order/thank-you.html
- Web SDK のタイプ — 送信アクション: commerce.purchases
- Web SDK — 送信アクションの XDM データ:
%xdm.commerce.purchase%
完了したら、次のルールが作成されます。
開発環境の構築
新しいデータ要素とルールを Luma Web SDK Tutorial
タグライブラリを追加し、開発環境を再構築します。
Adobe Analytics for Platform Web SDK の検証
Adobe Analytics の デバッガー レッスンでは、Platform Debugger とブラウザー開発者コンソールを使用して、クライアント側 XDM オブジェクトビーコンを検査する方法を学びました。これは、 AppMeasurement.js
Analytics の実装。 Platform Web SDK を使用して Analytics がデータを適切にキャプチャしていることを検証するには、次の 2 つの手順に従う必要があります。
- Platform Edge Network 上の XDM オブジェクトによってデータが処理される方法を検証するには、Experience Platformデバッガーの Edge Trace 機能を使用します。
- 処理ルールとリアルタイムレポートを使用して、Analytics でのデータの処理方法を検証します。
エッジトレースを使用
Experience Platformデバッガーの Edge Trace 機能を使用して、Adobe Analyticsが ECID、ページビュー、製品文字列、e コマースイベントを取り込んでいることを検証する方法について説明します。
Experience CloudID の検証
-
次に移動: Luma デモサイト とExperience PlatformDebugger を使用して サイトのタグプロパティを独自の開発プロパティに切り替える
note warning WARNING 続行する前に、Luma サイトにログインしていることを確認します。 ログインしていない場合、Luma サイトではチェックアウトできません。 -
Luma で、右上のログインボタンを選択し、資格情報を使用します。 u: test@adobe.com p: test 認証を行う
-
自動的に Didi Sport Watch 製品ページ 次のページ読み込み時
-
-
エッジトレースを有効にするには、「Experience Platformデバッガー」に移動し、左側のナビゲーションでを選択します。 ログ を選択し、 Edge 「 」タブで「 」を選択します。 接続
-
現時点では空になります
-
次を更新: Didi Sport Watch 製品ページ 「Experience Platformデバッガー」を再度チェックすると、データが表示されます。 次で始まる行 Analytics の自動マッピング RSID はAdobe Analyticsビーコンです
-
を選択して、両方の
mappedQueryParams
ドロップダウンと、Analytics 変数を表示する 2 番目のドロップダウンnote tip TIP 2 番目のドロップダウンは、データの送信先の Analytics レポートスイート ID に対応しています。 スクリーンショットに示されているレポートスイートではなく、お客様独自のレポートスイートと一致する必要があります。 -
下にスクロールして検索
c.a.x.identitymap.ecid.[0].id
. ECID を取り込むコンテキストデータ変数です。 -
Analytics が表示されるまで下にスクロールし続けます
mid
変数を使用します。 両方の ID がデバイスのExperience CloudID と一致します。note note NOTE ログインしているので、認証済み ID を検証するために少し時間をかけます 112ca06ed53d3db37e4cea49cc45b71e
(ユーザー向け) test@adobe.com は、c.a.x.identitymap.lumacrmid.[0].id
コンテンツページビュー数
同じビーコンを使用して、Analytics がコンテンツページビューを取り込んだことを検証します。
-
を探す
c.a.x.web.webpagedetails.pageviews.value=1
. これは、s.t()
ページビュービーコンが Analytics に送信されています -
下にスクロールして、
gn
変数を使用します。 これは、Analytics の動的構文で、s.pageName
変数を使用します。 データレイヤーからページ名を取り込みます。
製品文字列および e コマースイベント
既に製品ページを使用しているので、この演習では、引き続き同じ Edge Trace を使用して、Analytics によって製品データがキャプチャされたことを検証します。 製品文字列イベントと e コマースイベントの両方が、XDM 変数を Analytics に自動的にマッピングします。 適切な productListItem
XDM 変数を Adobe Analytics用の XDM スキーマの設定を使用する場合、Platform Edge Network は、適切な分析変数へのデータのマッピングを処理します。
-
最初に、
Product String
設定済み -
を探す
c.a.x.productlistitems.[0].sku
. 変数は、productListItems.item1.sku
このレッスンの前の -
下にスクロールして、
pl
変数を使用します。 これは、Analytics 製品文字列変数の動的構文です。 -
両方の値が、データレイヤーで使用可能な製品名に一致します
Edge Trace はを処理します。 commerce
~とは少し異なるイベント productList
ディメンション。 マッピングされた製品名を確認するのと同じ方法でマッピングされたコンテキストデータ変数が表示されません c.a.x.productlistitem.[0].name
上記の 代わりに、Edge Trace は Analytics で最終的なイベントの自動マッピングを表示します event
変数を使用します。 適切な XDM にマッピングしている限り、Platform Edge Network はそれに応じてマッピングします commerce
変数 Adobe Analytics用のスキーマの設定;この場合、 commerce.productViews.value=1
.
-
「Experience Platformデバッガー」ウィンドウに戻り、
event
変数の場合は、に設定されます。prodView
残りの e コマースイベントと製品文字列が Analytics に設定されていることを検証します。
-
追加 Didi Sport Watch カートに
-
次に移動: 買い物かごページ, Edge Trace for をチェックします
events: "scView"
と製品文字列 -
チェックアウトに進み、 Edge Trace for を確認します。
events: "scCheckout"
と製品文字列 -
次の項目だけを入力します。 名 および 姓 配送先フォームのフィールドと、 続行. 次のページで、 発注
-
確認ページで、「Edge Trace for 」をオンにします。
- 設定中の購入イベント
events: "purchase"
- 設定中の通貨コード変数
cc: "USD"
- で設定されている購入 ID
pi
- 製品文字列
pl
製品名、数量および価格の設定
- 設定中の購入イベント
処理ルールとリアルタイムレポート
これで、Edge Trace で Analytics ビーコンを検証したので、リアルタイムレポートを使用して Analytics がデータを処理していることを検証することもできます。 リアルタイムレポートを確認する前に、Analytics の処理ルールを設定する必要があります props
必要に応じて。
カスタム Analytics マッピングの処理ルール
この演習では、1 つの XDM 変数を prop にマッピングし、リアルタイムレポートで表示できるようにします。 すべてのカスタムマッピングに対して同じ手順を実行します。 eVar
, prop
, event
、または処理ルールからアクセス可能な変数。
-
Analytics UI で、に移動します。 管理者 > 管理ツール > レポートスイート
-
チュートリアルで使用する開発/テストレポートスイートを選択します。 > 設定を編集 > 一般 > 処理ルール
-
ルールを作成して の値を上書き
Product Name (prop1)
からa.x.productlistitems.0.name
. ルールを作成する理由を忘れずにメモを追加し、ルールのタイトルに名前を付けてください。 「保存」を選択しますnote important IMPORTANT 最初に処理ルールにマッピングしたとき、UI には XDM オブジェクトのコンテキストデータ変数が表示されません。 任意の値を選択する場合は、「保存」をクリックし、再び編集を開始します。 これで、すべての XDM 変数が表示されます。 -
に移動します。 設定を編集 > リアルタイム. コンテンツページビュー、製品ビュー、購入を検証できるよう、3 つすべてのを以下に示すパラメーターで設定します
-
検証手順を繰り返し、それに応じてリアルタイムレポートにデータが入力されることを確認します。
ページビュー数
製品表示
購入
-
Workspace UI で、購入した製品の e コマースフロー全体を表示するテーブルを作成します
XDM フィールドと Analytics 変数のマッピングについて詳しくは、ビデオを参照してください Web SDK 変数のAdobe Analyticsへのマッピング.
おめでとうございます。これでレッスンが終了し、独自の Web サイト用にAdobe Analytics Platform Web SDK を実装する準備が整いました。