eVar（マーチャンダイジング）

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

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

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

実装で eVar を使用する前に、必ず、レポートスイートの設定で 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 およびイベントを使用した 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" として送信されることになります。

データオブジェクト​を使用する場合、eVar マーチャンダイジングでは、AppMeasurementの構文に従ってdata.__adobe.analytics.eVar1～data.__adobe.analytics.eVar250が使用されます。

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

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" に付与されます。 さらに、以下のどちらかの条件が満たされるまで、マーチャンダイジング変数の現在の値が以後のすべての製品に結び付けられます。

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

XDM オブジェクト​を使用する場合、構文は他のeVarsおよび​ イベント ​の実装と同様に動作します。 上記の例を反映した 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"
    }
  }
}