ドキュメントExperience PlatformWeb SDK チュートリアル

タグルールの作成

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 初心者
  • 中級
  • 開発者

タグルールを使用して、XDM オブジェクトと共にイベントをAdobe Experience Platform Edge Networkに送信する方法を説明します。 タグルールは、イベント、条件、アクションを組み合わせたルールで、タグプロパティに対し、アクションの実行を指示します。 Platform Web SDK では、ルールを使用して、適切なデータで Platform Edge Networkにイベントを送信します。

学習目標

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

  • タグ内でルールを管理する際は、命名規則を使用します
  • 「変数を更新」アクションと「イベントを送信」アクションを使用して XDM フィールドでイベントを送信
  • 複数のルールをまたいで複数の XDM フィールドセットをスタックする
  • 個々または全体の配列データ要素の XDM オブジェクトへのマッピング
  • 開発ライブラリへのタグルールの公開

前提条件

データ収集タグと Luma デモサイト そして、チュートリアルの前のレッスンを完了している。

命名規則

タグでルールを管理するには、標準の命名規則に従うことをお勧めします。 このチュートリアルでは、5 つのパートで構成される命名規則を使用します。

  • [場所] - [イベント] - [目的] - [順序]

ここで、

  1. 場所 は、ルールが起動するサイトの 1 つまたは複数のページです
  2. イベント ルールのトリガーです
  3. 目的 ルールによって実行される主なアクションです
  4. 順序 は、他のルールと関連してルールを実行する順序です

タグルールの作成

タグでは、ルールを使用して、様々な条件下でアクション（呼び出し実行）を実行します。 Platform Web SDK タグ拡張機能には、このレッスンで使用する 2 つのアクションが含まれています。

  • 変数を更新 データ要素を XDM オブジェクトのプロパティにマッピングします
  • イベントを送信 xdm オブジェクトをExperience PlatformEdge Networkに送信します

このレッスンの残りの部分では、以下を行います。

  1. を使用したルールの作成 変数を更新 xdm フィールドの「グローバル設定」を定義するアクション。

  2. を使用して追加のルールを作成 変数を更新 「グローバル設定」をオーバーライドし、特定の条件下（例えば、製品ページに製品の詳細を追加する場合）で追加の XDM フィールドを提供するアクション。

  3. 別のルールを作成するには イベントを送信 XDM オブジェクト全体をAdobe Experience Platform Edge Networkに送信するアクション。

これらのルールはすべて、「順序」オプションを選択します。

このビデオでは、プロセスの概要を説明します。

https://video.tv.adobe.com/v/3427710/?learn=on

グローバル設定フィールド

グローバル XDM フィールドのタグルールを作成するには：

  1. このチュートリアルで使用するタグプロパティを開きます

  2. に移動 ルール 左側のナビゲーションで

  3. 「」を選択します 新しいルールの作成 ボタン

    ルールの作成

  4. ルール名を設定します。all pages - library loaded - set global variables - 1

  5. が含まれる イベント セクションで選択 追加

    ルールに名前を付けてイベントを追加する

  6. の使用 Core 拡張機能 を選択して、 ライブラリが読み込まれました（ページのトップ） as the イベントタイプ

  7. を選択 詳細 ドロップダウンと入力 1 as the 順序

    note note
    NOTE
    注文番号が小さいほど、早く実行されます。 したがって、「グローバル設定」には低い注文番号を付けます。

  8. を選択 変更を保持 ルールのメイン画面に戻るには
    ライブラリの読み込みトリガーを選択

  9. が含まれる アクション セクションで選択 追加

  10. として 拡張機能 ​を選択 Adobe Experience Platform Web SDK

  11. として アクションタイプ ​を選択 変数を更新

  12. として データ要素 ​を選択し、 xdm.variable.content 「」に作成しました データ要素の作成 レッスン

    変数スキーマの更新

次に、 データ要素 に スキーマ xdm オブジェクトで使用されます。 個々のプロパティまたはオブジェクト全体にマッピングできます。 この例では、個々のプロパティにマッピングします。

  1. eventType フィールドを見つけて選択します

  2. 値を入力 web.webpagedetails.pageViews

    note tip
    TIP
    で入力する値を理解するには eventType フィールドに移動する必要があります。スキーマページに移動して、 eventType フィールドに入力すると、推奨値が右側のパネルに表示されます。 必要に応じて、新しい値を入力することもできます。
    スキーマページの eventType の推奨値

  3. 次に、を見つけます identityMap スキーマ内のオブジェクトを選択し、以下の手順を実行します

  4. をにマッピングします identityMap.loginID データ要素

    変数 ID マップを更新

    note tip
    TIP
    データ要素が null の場合、XDM フィールドはネットワークリクエストに含まれません。 そのため、ユーザーが認証されない場合は、次のようになります。 identityMap.loginID データ要素が null で、 identityMap オブジェクトは送信されません。 これが、「グローバル設定」で定義できる理由です。

  5. に到達するまで下にスクロールします。 web オブジェクト

  6. 選択して開きます

  7. 次のデータ要素を対応するにマッピングします web XDM 変数

    • web.webPageDetials.name 対象： %page.pageInfo.pageName%
    • web.webPageDetials.server 対象： %page.pageInfo.server%
    • web.webPageDetials.siteSection 対象： %page.pageInfo.hierarchie1%

  8. web.webPageDetials.pageViews.value を 1 に設定します。

    変数の内容を更新

    note tip
    TIP
    も eventType をに設定 web.webpagedetails.pageViews nor web.webPageDetails.pageViews.value Adobe Analyticsがビーコンをページビューとして処理する際に必要です。他のダウンストリームアプリケーションのページビューを示す標準的な手段があると便利です。

  9. を選択 変更を保持 その後 保存 ルールの作成を完了するための次の画面のルール

製品ページフィールド

次に、を使用します 変数を更新 さらに、XDM オブジェクトをに送信する前に強化する順序付きルール Platform Edge Network.

TIP
ルールの順序は、イベントがトリガーされたときに最初に実行されるルールを決定します。 2 つのルールのイベントタイプが同じ場合は、最も数字が小さいルールが最初に実行されます。

まず、Luma の製品詳細ページで製品表示を追跡します。

  1. を選択 ルールを追加

  2. 名前をつける ecommerce - library loaded - set product details variables - 20

  3. 「」を選択します +記号 「イベント」で新しいトリガーを追加

  4. 次の下 拡張機能 ​を選択 コア

  5. 次の下 イベントタイプ ​を選択 ライブラリが読み込まれました（ページのトップ）

  6. 選択して開く 詳細オプション，入力 20. この順序値によって、ルールが確実に実行されます 後 この all pages - library loaded - set global variables - 1 グローバル設定を設定します。

  7. を選択 変更を保持

    Analytics XDM ルール

  8. 次の下 条件、を選択 追加

  9. 移動 論理タイプ as 標準

  10. 移動 拡張機能 as コア

  11. を選択 条件タイプ as クエリ文字列を含まないパス

  12. 右側で、 正規表現 切り替え

  13. 次の下 パスがと等しい set /products/. Luma デモサイトの場合、ルールが製品ページのトリガーのみになります

  14. を選択 変更を保持

    Analytics XDM ルール

  15. 次の下 アクション 選択 追加

  16. を選択 Adobe Experience Platform Web SDK 拡張子

  17. を選択 アクションタイプ as 変数を更新

  18. を選択 xdm.variable.content as the データ要素

  19. にスクロール ダウンします。 commerce オブジェクト

  20. を開きます productViews オブジェクトとセット value 対象： 1

    製品表示の設定

    note tip
    TIP
    XDM で commerce.productViews.value=1 を設定すると、自動的ににマッピングされます prodView analytics のイベント

  21. Scroll down to eventType およびを設定します commerce.productViews

    note note
    NOTE
    このルールは優先順位が高いので、次を上書きします eventType 「グローバル設定」ルールで設定します。 eventType には 1 つの値のみを含めることができ、最も価値のあるイベントで設定することをお勧めします。

  22. にスクロールし、を選択します。 productListItems 配列

  23. を選択 個々の項目を指定

  24. を選択 項目を追加

    製品表示イベントの設定

    note caution
    CAUTION
    この productListItems は array データタイプを使用すると、データは要素の集まりとして取り込まれます。 Luma デモサイトのデータレイヤー構造と、Luma サイトで一度に 1 つの製品しか表示できないので、項目を個別に追加します。 独自の web サイトに実装する場合、データレイヤーの構造によっては、配列全体を指定できる場合があります。

  25. 選択して開く 項目 1

  26. マップ productListItems.item1.SKU 対象： %product.productInfo.sku%

    製品 SKU XDM オブジェクト変数

  27. を選択 変更を保持

  28. を選択 保存 ルールを保存するには

買い物かごフィールド

配列が XDM スキーマの形式と一致する場合は、配列全体を XDM オブジェクトにマッピングできます。 カスタムコードデータ要素 cart.productInfo 前の手順で、 digitalData.cart.cartEntries luma 上のデータレイヤーオブジェクトで、の必要な形式に変換します productListItems xdm スキーマのオブジェクト。

説明するには、以下の Luma サイトデータレイヤー（左）と翻訳済みデータ要素（右）の比較を参照してください。

XDM オブジェクト配列形式

データ要素とを比較します productListItems 構造（ヒント、一致する必要があります）。

IMPORTANT
数値変数の翻訳方法と、データレイヤーの次のような文字列値に注意してください price および qty データ要素内の数値に再書式設定されます。 これらの形式要件は、Platform でのデータ整合性にとって重要であり、次の期間に決定されます スキーマの設定 ステップ。 この例では、 数量 はを使用します 整数 データタイプ。
XDM スキーマデータタイプ

次に、配列を XDM オブジェクトにマッピングします。

  1. という名前の新しいルールを作成します。 ecommerce - library loaded - set shopping cart variables - 20

  2. 「」を選択します +記号 「イベント」で新しいトリガーを追加

  3. 次の下 拡張機能 ​を選択 コア

  4. 次の下 イベントタイプ ​を選択 ライブラリが読み込まれました（ページのトップ）

  5. 選択して開く 詳細オプション，入力 20

  6. を選択 変更を保持

    Analytics XDM ルール

  7. 次の下 条件、を選択 追加

  8. 移動 論理タイプ as 標準

  9. 移動 拡張機能 as コア

  10. を選択 条件タイプ as クエリ文字列を含まないパス

  11. 右に 実行しない を有効にする 正規表現 切り替え

  12. 次の下 パスがと等しい set /content/luma/us/en/user/cart.html. Luma デモサイトの場合、ルールが買い物かごページのトリガーのみになることを確認します

  13. を選択 変更を保持

    Analytics XDM ルール

  14. 次の下 アクション 選択 追加

  15. を選択 Adobe Experience Platform Web SDK 拡張子

  16. を選択 アクションタイプ as 変数を更新

  17. を選択 xdm.variable.content as the データ要素

  18. にスクロール ダウンします。 commerce オブジェクトを選択し、をクリックして開きます。

  19. を開きます productListViews オブジェクトとセット value 対象： 1

    製品表示の設定

    note tip
    TIP
    XDM で commerce.productListViews.value=1 を設定すると、自動的ににマッピングされます scView analytics のイベント

  20. を選択 eventType をに設定します。 commerce.productListViews

  21. にスクロールし、を選択します。 productListItems 配列

  22. を選択 アレイ全体を提供

  23. マッピング先 cart.productInfo データ要素

  24. を選択 変更を保持

  25. を選択 保存 ルールを保存するには

以下の違いを持つ同じパターンに従って、チェックアウトと購入のために他の 2 つのルールを作成します。

ルール名: ecommerce - library loaded - set checkout variables - 20

  1. 条件: /content/luma/us/en/user/checkout.html

  2. eventType を commerce.checkouts に設定します。

  3. commerce.checkout.value を 1 に設定します。

    note tip
    TIP
    これは、の設定と同じです。 scCheckout analytics のイベント

ルール名: ecommerce - library loaded - set purchase variables - 20

  1. 条件: /content/luma/us/en/user/checkout/order/thank-you.html

  2. eventType を commerce.purchases に設定します。

  3. commerce.purchases.value を 1 に設定します。

    note tip
    TIP
    これは、の設定と同じです。 purchase analytics のイベント

  4. を設定 commerce.order.purchaseID に cart.orderId データ要素

  5. を設定 commerce.order.currencyCode ハードコードされた値に USD

    Analytics の purchaseID の設定

    note tip
    TIP
    これは、の設定と同じです。 s.purchaseID および s.currencyCode analytics の変数

  6. にスクロールし、を選択します。 productListItems 配列

  7. を選択 アレイ全体を提供

  8. マッピング先 cart.productInfo.purchase データ要素

  9. を選択 変更を保持

  10. を選択 保存

完了すると、次のルールが作成されます。

Analytics XDM ルール

イベントルールを送信

これで変数を設定できたので、完全な XDM オブジェクトを Platform Edge Networkに送信するルールを、 イベントを送信 アクション。

  1. 右側で、を選択します ルールを追加 別のルールを作成するには

  2. ルール名を設定します。all pages - library loaded - send event - 50

  3. が含まれる イベント セクションで選択 追加

  4. の使用 Core 拡張機能 を選択して、 Library Loaded (Page Top) as the イベントタイプ

  5. を選択 詳細 ドロップダウンと入力 50 。対象： 順序. これにより、設定した他のすべてのルール（以下を設定）の後で、このルールが確実に起動します 1 または 20 as their 順序）に設定します。

  6. を選択 変更を保持 ルールのメイン画面に戻るには
    ライブラリの読み込みトリガーを選択

  7. が含まれる アクション セクションで選択 追加

  8. として 拡張機能 ​を選択 Adobe Experience Platform Web SDK

  9. として アクションタイプ ​を選択 イベントを送信

  10. として XDM ​を選択し、 xdm.variable.content 前のレッスンで作成したデータ要素

  11. を選択 変更を保持 ルールのメイン画面に戻るには

    イベントを送信アクションを追加

  12. を選択 保存 ルールを保存するには

    ルールの保存

ライブラリでのルールの公開

次に、ルールを開発環境に公開して、ルールが機能することを検証します。

ライブラリを作成するには：

  1. に移動 公開フロー 左側のナビゲーションで

  2. を選択 ライブラリを追加

    「ライブラリを追加」を選択します

  3. の場合 名前、と入力します Luma Web SDK Tutorial

  4. の場合 0.5511122 ​を選択 Development

  5. を選択 変更されたリソースをすべて追加

    note note
    NOTE
    前のレッスンで作成したすべてのタグコンポーネントが表示されます。 Core 拡張機能には、すべての web タグプロパティに必要な基本 JavaScript が含まれています。

  6. を選択 開発用に保存してビルド

    ライブラリの作成とビルド

ライブラリのビルドには数分かかる場合があり、完了すると、ライブラリ名の左側に緑のドットが表示されます。

ビルド完了

ご覧のように 公開フロー 画面では、公開プロセスについて詳しく説明します。これは、このチュートリアルの範囲外です。 このチュートリアルでは、開発環境で 1 つのライブラリのみを使用します。

これで、Adobe Experience Platform Debuggerを使用してリクエスト内のデータを検証する準備が整いました。

次へ

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