eVar(マーチャンダイジング)

このヘルプページでは、マーチャンダイジング eVar の実装方法について説明します。マーチャンダイジング eVar がディメンションとしてどのように機能するかについては、コンポーネントユーザガイドの eVar(マーチャンダイジングディメンション)を参照してください。

マーチャンダイジング eVar の仕組みについて詳しくは、マーチャンダイジング eVar と製品検索方法を参照してください。

レポートスイート設定での eVar の設定

実装で eVar を使用する前に、必ず、レポートスイートの設定で eVar を目的の構文に設定してください。詳しくは、『管理者ガイド』のコンバージョン変数を参照してください。

WARNING
マーチャンダイジング eVar を正しく設定しないと、変数の予期しない値やデータ損失が発生します。お使いの実装に合わせて正しく設定されていることを確認します。

製品の構文を使用した実装

「製品の構文」が選択されている場合、マーチャンダイジングカテゴリーが products 変数に直接入力されるので、バインディングイベントを選択して設定する必要はありません。これが推奨される方法であり、成功イベントが発生したときにその値を products に設定できない場合を除いて、この方法を使用してください。

// The bare minimum to set a merchandising eVar with product syntax
s.products = ";Example product;;;;eVar1=Example merchandising value";

// An example single product with product syntax
s.products = "Example category;Example product;1;5.99;event1=1;eVar1=Turtles";

// Tie a merchandising eVar to a different values on two different products
s.products = "Birds;Scarlet Macaw;1;4200;;eVar1=talking bird,Birds;Turtle dove;2;550;;eVar1=love birds";

eVar1 の値が製品に割り当てられます。この製品を含む以降の成功イベントはすべて eVar 値に配分されます。

Web SDK を使用した製品構文

XDM オブジェクト を使用する場合、製品構文マーチャンダイジング変数は次の XDM フィールドを使用します。

  • 製品構文マーチャンダイジング eVar は、xdm.productListItems[]._experience.analytics.customDimensions.eVars.eVar1 から xdm.productListItems[]._experience.analytics.customDimensions.eVars.eVar250 までにマッピングされます。
  • 製品構文マーチャンダイジングイベントは、xdm.productListItems[]._experience.analytics.event1to100.event1.value から xdm.productListItems[]._experience.analytics.event901to1000.event1000.value までにマッピングされます。イベントのシリアル化 XDM フィールドは、xdm.productListItems[]._experience.analytics.event1to100.event1.id から xdm.productListItems[]._experience.analytics.event901to1000.event1000.id までにマッピングされます。
NOTE
productListItems でイベントを設定する場合は、イベントをイベント文字列で設定する必要はありません。両方で設定されている場合は、イベント文字列の値が優先されます。

次の例では、複数のマーチャンダイジング eVar およびイベントを使用した 1 つの製品を示します。

"productListItems": [
  {
    "name": "Bahama Shirt",
    "priceTotal": "12.99",
    "quantity": 3,
    "_experience": {
      "analytics": {
        "customDimensions" : {
          "eVars" : {
            "eVar10" : "green",
            "eVar33" : "large"
          }
        },
        "event1to100" : {
          "event4" : {
            "value" : 1
          },
          "event10" : {
            "value" : 2,
            "id" : "abcd"
          }
        }
      }
    }
  }
]

上記の例のオブジェクトは、Adobe Analytics に ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large" として送信されることになります。

data object を使用する場合、eVarマーチャンダイジングは data.__adobe.analytics.eVar1 – 次 data.__adobe.analytics.eVar250AppMeasurement構文を使用します。

コンバージョン変数の構文を使用した実装

eVar 変数を products に設定できない場合、コンバージョン変数の構文を使用する必要があります変数。このシナリオは一般的には、ページにマーチャンダイジングチャネルや検索方法のコンテキストがない場合です。そのような場合、製品ページに到達する前にマーチャンダイジング変数を設定し、その値がバインディングイベントの発生時まで保持されるようにします。

設定時にバインディングイベントが選択されると、保持された eVar の値が製品に関連付けられます。例えば、バインディングイベントとして prodView が指定されている場合、イベントの発生時にのみ現在の製品リストにマーチャンダイジングカテゴリーが結び付けられます。既に製品に割り当てられているマーチャンダイジング eVar を更新できるのは、以降のバインディングイベントのみです。

// Place on the same or previous page before the binding event:
s.eVar1 = "Aviary";

// Place on the page where the binding event occurs:
s.events = "prodView";
s.products = ";Canary";

eVar1"Aviary" の値が製品に割り当てられます"Canary"。この製品に関連する以降の成功イベントのクレジットはすべて "Canary" に付与されます。さらに、以下のどちらかの条件が満たされるまで、マーチャンダイジング変数の現在の値が以後のすべての製品に結び付けられます。

  • eVar の期限が切れます(「有効期限」の設定に基づきます)。
  • マーチャンダイジング eVar が新しい値で上書きされる。

Web SDK を使用したコンバージョン変数構文

XDM オブジェクト を使用する場合、構文は他の eVars および events の実装と同じように動作します。 上記の例を反映した XDM は、次のようになります。

同じまたは前のイベントコールで eVar を設定します。

"_experience": {
  "analytics": {
    "customDimensions": {
      "eVars": {
        "eVar1" : "Aviary"
      }
    }
  }
}

製品文字列の入札イベントと値を設定します。

"commerce": {
  "productViews" : {
    "value" : 1
  }
},
"productListItems": [
  {
    "name": "Canary"
  }
]

データオブジェクト を使用する場合、上記の例を反映したデータオブジェクトは次のようになります。

同じまたは前のイベントコールで eVar を設定します。

"data": {
  "__adobe": {
    "analytics": {
      "eVar1": "Aviary"
    }
  }
}

製品文字列の入札イベントと値を設定します。

"data": {
  "__adobe": {
    "analytics": {
      "events": "prodView",
      "products": ";Canary"
    }
  }
}
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690