データ要素の作成

で、コンテンツ、コマース、ID データ用のタグでデータ要素を作成する方法を説明します Luma デモサイト. 次に、XDM スキーマのフィールドにAdobe Experience Platform Web SDK 拡張機能の変数データ要素タイプを入力します。

学習目標

このレッスンを終了すると、次の操作を実行できます。

  • データレイヤーを XDM にマッピングする様々なアプローチを理解する
  • データをキャプチャするデータ要素の作成
  • XDM オブジェクトへのデータ要素のマッピング

前提条件

データレイヤーとは何かを理解し、チュートリアルの前のレッスンを完了しました。

IMPORTANT
このレッスンのデータは、 digitalData luma サイト上のデータレイヤー。 データレイヤーを表示するには、開発者コンソールを開いてと入力します。 digitalData 使用可能な完全なデータレイヤーを確認するには、 digitalData データレイヤー

データレイヤーのアプローチ

Adobe Experience Platformのタグ機能を使用して、データレイヤーから XDM にデータをマッピングする方法は複数あります。 次に、3 つの異なるアプローチの長所と短所をいくつか示します。 必要に応じて、次の方法を組み合わせることができます。

  1. データレイヤーへの XDM の実装
  2. タグの XDM へのマッピング
  3. データストリームの XDM へのマッピング
NOTE
このチュートリアルの例では、タグで XDM にマッピングするアプローチに従っています。

データレイヤーへの XDM の実装

このアプローチでは、完全に定義された XDM オブジェクトをデータレイヤーの構造として使用します。 次に、データレイヤー全体をタグの XDM オブジェクトデータ要素にマッピングします。 実装でタグマネージャーを使用していない場合、を使用してアプリケーションから直接 XDM にデータを送信できるので、この方法は理想的です。 XDM sendEvent コマンド. タグを使用する場合は、データレイヤー全体をパススルー JSON オブジェクトとして XDM に取り込むカスタムコードデータ要素を作成できます。 次に、パススルー JSON をイベント送信アクションの XDM オブジェクトフィールドにマッピングします。

以下に、Adobeのクライアントデータレイヤー形式を使用したデータレイヤーの表示例を示します。

データレイヤー内のXDM の例
code language-json
window.adobeDataLayer.push({
"eventType": "web.webPageDetails.pageViews",
"web":{
         "webInteraction":{
            "linkClicks":{
               "id":"",
               "value":""
            },
            "URL":"",
            "name":"",
            "region":"",
            "type":""
         },
         "webPageDetails":{
            "pageViews":{
               "id":"",
               "value":"1"
            },
            "URL":"https://luma.enablementadobe.com/",
            "isErrorPage":"",
            "isHomePage":"",
            "name":"luma:home",
            "server":"enablementadobe.com",
            "siteSection":"home",
            "viewName":""
         },
         "webReferrer":{
            "URL":"",
            "type":""
         }
      }
});

長所

  • データレイヤー変数から XDM への再マッピングの追加手順を不要にします
  • タグ付けデジタル動作も web 開発チームが所有している場合は、のデプロイが早くなる可能性があります

短所

  • XDM に送信するデータを更新するために、開発チームと開発サイクルに完全に依存している
  • XDM はデータレイヤーから正確なペイロードを受け取るので、柔軟性は限られています
  • スクレーピング、永続性、迅速なデプロイメントのための機能など、ビルトインのタグ機能は使用できません
  • サードパーティのピクセルに対してデータレイヤーを使用するのが難しい(ただし、これらのピクセルをに移動したい場合があります) イベント転送!
  • データレイヤーと XDM の間でデータを変換できない

タグ内のデータレイヤーのマッピング

このアプローチでは、個々のデータレイヤー変数またはデータレイヤーオブジェクトをタグのデータ要素にマッピングし、最終的には XDM にマッピングします。 これは、タグ管理システムを使用した実装に対する従来のアプローチです。

長所

  • XDM に到達する前に個々の変数を制御し、データを変換できるため、最も柔軟なアプローチ
  • Adobeタグトリガーとスクレーピング機能を使用して、データを XDM に渡すことができます。
  • データ要素をサードパーティのピクセルにクライアントサイドでマッピングできます。

短所

  • データレイヤーをデータ要素として再構築するのに時間がかかる
TIP
Google データレイヤー
組織が既にGoogle Analyticsを使用しており、web サイトに従来のGoogle dataLayer オブジェクトがある場合は、 Google データレイヤーの拡張機能 タグ内。 これにより、IT チームのサポートを依頼しなくても、Adobeテクノロジを迅速に導入できます。 Google データレイヤーを XDM にマッピングするには、上記と同じ手順に従います。

データストリームの XDM へのマッピング

このアプローチでは、と呼ばれるデータストリーム設定に組み込まれた機能を使用します データ収集のためのデータ準備 データレイヤー変数をタグの XDM にマッピングするをスキップします。

長所

  • 個々の変数を XDM にマッピングできるので、柔軟性があります
  • ~する能力 新しい値を計算 または 変換データタイプ データレイヤーから XDM に移動する前に
  • を活用 マッピング UI ポイントアンドクリック UI を使用してソースデータのフィールドを XDM にマッピングするには

短所

  • データレイヤー変数をクライアントサイドのサードパーティピクセルのデータ要素として使用することはできませんが、イベント転送では使用できます
  • Adobe Experience Platformのタグ機能のスクレーピング機能を使用できない
  • タグとデータストリームの両方でデータレイヤーをマッピングすると、メンテナンスが複雑になります
IMPORTANT
前述のように、このチュートリアルの例では、タグアプローチでの XDM へのマッピングに従います。

データ要素を作成してデータレイヤーをキャプチャする

XDM オブジェクトを作成する前に、次のデータ要素のセットを作成します Luma デモサイト データレイヤー:

  1. に移動 データ要素 を選択して、 データ要素を追加 (または 新しいデータ要素の作成 タグプロパティに既存のデータ要素がない場合)

    データ要素の作成

  2. データ要素に「page.pageInfo.pageName」と名前を付けます。

  3. の使用 JavaScript 変数 データ要素タイプ luma のデータレイヤーの値を指すようにするには: digitalData.page.pageInfo.pageName

  4. チェックボックスをオンにする 小文字の値を強制 および テキストをクリーン 大文字と小文字を統一し、余分なスペースを削除するには

  5. 移動 None as the ストレージ期間 この値はページごとに異なるので、を設定します

  6. を選択 保存

    ページ名データ要素

同じ手順に従って、これらの追加のデータ要素を作成します。

  • 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;
    
CAUTION
この JavaScript 変数 データ要素タイプは、配列参照を角括弧ではなくドットとして扱うので、ユーザー名データ要素はとして参照します digitalData.user[0].profile[0].attributes.username 動作しない.

XDM およびデータオブジェクト用の変数データ要素の作成

作成したデータ要素は、XDM オブジェクト(Platform アプリケーション用)とデータオブジェクト(Analytics、Target およびAudience Manager用)の作成に使用されます。 これらのオブジェクトには、と呼ばれる独自の特別なデータ要素があります 変数 作成が非常に簡単なデータ要素。

XDM の変数データ要素を作成するには、で作成したスキーマに関連付けます。 スキーマの設定 レッスン :

  1. を選択 データ要素を追加

  2. データ要素に名前を付ける xdm.variable.content. タグプロパティを整理しやすくするために、XDM に固有のデータ要素を「xdm」というプレフィックスを付けることをお勧めします

  3. 「」を選択します Adobe Experience Platform Web SDK as the 拡張機能

  4. 「」を選択します 変数 as the データ要素タイプ

  5. を選択 XDM as the プロパティ

  6. 「」を選択します Sandbox スキーマの作成対象

  7. 適切なを選択します スキーマ、この場合は Luma Web Event Data

  8. を選択 保存

    XDM 用の変数データ要素

次に、データオブジェクトの変数データ要素を作成します。

  1. を選択 データ要素を追加

  2. データ要素に名前を付ける data.variable. タグプロパティを整理しやすくするために、データオブジェクトに固有のデータ要素に「data」というプレフィックスを付けることをお勧めします

  3. 「」を選択します Adobe Experience Platform Web SDK as the 拡張機能

  4. 「」を選択します 変数 as the データ要素タイプ

  5. を選択 データ as the プロパティ

  6. このチュートリアルの一部として実装するExperience Cloudソリューションを選択します

  7. を選択 保存

    データオブジェクトの可変データ要素

これらの手順の最後で、次のデータ要素が作成されているはずです。

コア拡張機能のデータ要素
Platform Web SDK 拡張機能のデータ要素
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
TIP
今後 タグルールの作成 レッスンでは、次のことを学習します 変数 データ要素を使用すると、タグ内で複数のルールをスタックできます。 変数アクションタイプを更新.

これらのデータ要素を配置すると、タグルールを使用して Platform Edge Networkへのデータ送信を開始する準備が整います。 ただし、最初に、Web SDK を使用して ID を収集する方法について説明します。

次へ:

NOTE
Adobe Experience Platform Web SDK の学習に時間を費やしていただき、ありがとうございます。 ご質問がある場合、一般的なフィードバックを共有したい場合、または将来のコンテンツに関するご提案がある場合は、このページでお知らせください Experience League コミュニティ ディスカッションの投稿
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4