データ要素の作成
で、コンテンツ、コマース、ID データ用のタグでデータ要素を作成する方法を説明します Luma デモサイト. 次に、XDM スキーマのフィールドにAdobe Experience Platform Web SDK 拡張機能の変数データ要素タイプを入力します。
学習目標
このレッスンを終了すると、次の操作を実行できます。
- データレイヤーを XDM にマッピングする様々なアプローチを理解する
- データをキャプチャするデータ要素の作成
- XDM オブジェクトへのデータ要素のマッピング
前提条件
データレイヤーとは何かを理解し、チュートリアルの前のレッスンを完了しました。
digitalData
luma サイト上のデータレイヤー。 データレイヤーを表示するには、開発者コンソールを開いてと入力します。 digitalData
使用可能な完全なデータレイヤーを確認するには、
データレイヤーのアプローチ
Adobe Experience Platformのタグ機能を使用して、データレイヤーから XDM にデータをマッピングする方法は複数あります。 次に、3 つの異なるアプローチの長所と短所をいくつか示します。 必要に応じて、次の方法を組み合わせることができます。
- データレイヤーへの XDM の実装
- タグの XDM へのマッピング
- データストリームの XDM へのマッピング
データレイヤーへの XDM の実装
このアプローチでは、完全に定義された XDM オブジェクトをデータレイヤーの構造として使用します。 次に、データレイヤー全体をタグの XDM オブジェクトデータ要素にマッピングします。 実装でタグマネージャーを使用していない場合、を使用してアプリケーションから直接 XDM にデータを送信できるので、この方法は理想的です。 XDM sendEvent コマンド. タグを使用する場合は、データレイヤー全体をパススルー JSON オブジェクトとして XDM に取り込むカスタムコードデータ要素を作成できます。 次に、パススルー JSON をイベント送信アクションの XDM オブジェクトフィールドにマッピングします。
以下に、Adobeのクライアントデータレイヤー形式を使用したデータレイヤーの表示例を示します。
code language-json |
---|
|
長所
- データレイヤー変数から XDM への再マッピングの追加手順を不要にします
- タグ付けデジタル動作も web 開発チームが所有している場合は、のデプロイが早くなる可能性があります
短所
- XDM に送信するデータを更新するために、開発チームと開発サイクルに完全に依存している
- XDM はデータレイヤーから正確なペイロードを受け取るので、柔軟性は限られています
- スクレーピング、永続性、迅速なデプロイメントのための機能など、ビルトインのタグ機能は使用できません
- サードパーティのピクセルに対してデータレイヤーを使用するのが難しい(ただし、これらのピクセルをに移動したい場合があります) イベント転送!
- データレイヤーと XDM の間でデータを変換できない
タグ内のデータレイヤーのマッピング
このアプローチでは、個々のデータレイヤー変数またはデータレイヤーオブジェクトをタグのデータ要素にマッピングし、最終的には XDM にマッピングします。 これは、タグ管理システムを使用した実装に対する従来のアプローチです。
長所
- XDM に到達する前に個々の変数を制御し、データを変換できるため、最も柔軟なアプローチ
- Adobeタグトリガーとスクレーピング機能を使用して、データを XDM に渡すことができます。
- データ要素をサードパーティのピクセルにクライアントサイドでマッピングできます。
短所
- データレイヤーをデータ要素として再構築するのに時間がかかる
データストリームの XDM へのマッピング
このアプローチでは、と呼ばれるデータストリーム設定に組み込まれた機能を使用します データ収集のためのデータ準備 データレイヤー変数をタグの XDM にマッピングするをスキップします。
長所
短所
- データレイヤー変数をクライアントサイドのサードパーティピクセルのデータ要素として使用することはできませんが、イベント転送では使用できます
- Adobe Experience Platformのタグ機能のスクレーピング機能を使用できない
- タグとデータストリームの両方でデータレイヤーをマッピングすると、メンテナンスが複雑になります
データ要素を作成してデータレイヤーをキャプチャする
XDM オブジェクトを作成する前に、次のデータ要素のセットを作成します Luma デモサイト データレイヤー:
-
に移動 データ要素 を選択して、 データ要素を追加 (または 新しいデータ要素の作成 タグプロパティに既存のデータ要素がない場合)
-
データ要素に「
page.pageInfo.pageName
」と名前を付けます。 -
の使用 JavaScript 変数 データ要素タイプ luma のデータレイヤーの値を指すようにするには:
digitalData.page.pageInfo.pageName
-
チェックボックスをオンにする 小文字の値を強制 および テキストをクリーン 大文字と小文字を統一し、余分なスペースを削除するには
-
移動
None
as the ストレージ期間 この値はページごとに異なるので、を設定します -
を選択 保存
同じ手順に従って、これらの追加のデータ要素を作成します。
-
page.pageInfo.server
マッピング先digitalData.page.pageInfo.server
-
page.pageInfo.hierarchie1
マッピング先digitalData.page.pageInfo.hierarchie1
-
user.profile.attributes.username
マッピング先digitalData.user.0.profile.0.attributes.username
-
user.profile.attributes.loggedIn
マッピング先digitalData.user.0.profile.0.attributes.loggedIn
-
product.productInfo.sku
マッピング先digitalData.product.0.productInfo.sku
-
product.productInfo.title
マッピング先digitalData.product.0.productInfo.title
-
cart.orderId
マッピング先digitalData.cart.orderId
-
product.category
の使用 カスタムコード データ要素タイプ 次のカスタムコードを使用して、トップレベルカテゴリのサイト URL を解析します。code language-javascript var cat = location.pathname.split(/[/.]+/); if (cat[5] == 'products') { return (cat[6]); } else if (cat[5] != 'html') { return (cat[5]); }
-
cart.productInfo
次のカスタムコードを使用します。code language-javascript var cart = digitalData.cart.cartEntries; var cartItem = []; cart.forEach(function(item, index, array){ cartItem.push({ "SKU": item.sku }); }); return cartItem;
-
cart.productInfo.purchase
次のカスタムコードを使用します。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, "quantity": qty, "priceTotal": price }); }); return cartItem;
digitalData.user[0].profile[0].attributes.username
動作しない.XDM およびデータオブジェクト用の変数データ要素の作成
作成したデータ要素は、XDM オブジェクト(Platform アプリケーション用)とデータオブジェクト(Analytics、Target およびAudience Manager用)の作成に使用されます。 これらのオブジェクトには、と呼ばれる独自の特別なデータ要素があります 変数 作成が非常に簡単なデータ要素。
XDM の変数データ要素を作成するには、で作成したスキーマに関連付けます。 スキーマの設定 レッスン :
-
を選択 データ要素を追加
-
データ要素に名前を付ける
xdm.variable.content
. タグプロパティを整理しやすくするために、XDM に固有のデータ要素を「xdm」というプレフィックスを付けることをお勧めします -
「」を選択します Adobe Experience Platform Web SDK as the 拡張機能
-
「」を選択します 変数 as the データ要素タイプ
-
を選択 XDM as the プロパティ
-
「」を選択します Sandbox スキーマの作成対象
-
適切なを選択します スキーマ、この場合は
Luma Web Event Data
-
を選択 保存
次に、データオブジェクトの変数データ要素を作成します。
-
を選択 データ要素を追加
-
データ要素に名前を付ける
data.variable
. タグプロパティを整理しやすくするために、データオブジェクトに固有のデータ要素に「data」というプレフィックスを付けることをお勧めします -
「」を選択します Adobe Experience Platform Web SDK as the 拡張機能
-
「」を選択します 変数 as the データ要素タイプ
-
を選択 データ as the プロパティ
-
このチュートリアルの一部として実装するExperience Cloudソリューションを選択します
-
を選択 保存
これらの手順の最後で、次のデータ要素が作成されているはずです。
cart.orderId
data.variable
cart.productInfo
xdm.variable.content
cart.productInfo.purchase
page.pageInfo.hierarchie1
page.pageInfo.pageName
page.pageInfo.server
product.category
product.productInfo.sku
product.productInfo.title
user.profile.attributes.loggedIn
user.profile.attributes.username
これらのデータ要素を配置すると、タグルールを使用して Platform Edge Networkへのデータ送信を開始する準備が整います。 ただし、最初に、Web SDK を使用して ID を収集する方法について説明します。