eVar (Merchandising)

此帮助页面介绍了如何实施推销 eVar。 有关推销eVar如何用作维度的信息，请参阅《组件用户指南》中的eVar （促销维度）。

促销eVar将值捆绑到单个产品，以便涉及每个产品的成功事件将点数计入捆绑到该产品的值。 您可以通过以下两种方式之一设置值：

有关绑定、分配和到期的工作方式，请参阅eVar （促销维度）。

在报告包设置中设置 eVar

在实施中使用 eVar 之前，请确保在报告包设置中将 eVar 配置为所需的语法。 请参阅《管理员指南》中的转化变量。

选择语法

当设置products变量时促销值可用，或者同一点击中的产品需要不同的值时，请使用产品语法。 当在产品之前知道该值（例如搜索词或导致访客访问产品的内部促销活动）时，请使用转化变量语法。 有关完整比较，请参阅绑定和分配的工作方式。

使用产品语法实施

启用产品语法后，将直接在products变量中设置推销值，因此不使用捆绑事件。 促销eVar进入每个产品的最后一个区段：

s.products = "[category];[name];[quantity];[revenue];[events];[eVars]";

使用管道字符(|)在同一个产品上分隔多个推销eVar。 即使您未使用数量、收入和事件的空占位符，这些占位符也是必需的。 如果没有这些参数，eVar值将被忽略。

该值将捆绑到该点击上的产品。 以后的值是否替换现有绑定取决于分配设置。 请参阅绑定和分配的工作方式。

// 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 different values on two different products
s.products = "Birds;Scarlet Macaw;1;4200;;eVar1=talking bird,Birds;Turtle dove;2;550;;eVar1=love birds";

使用 Web SDK 的产品语法

如果使用​XDM对象，则产品语法促销变量使用以下XDM字段：

以下示例展示了使用多个推销 eVar 和事件的单一产品：

"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"
          }
        }
      }
    }
  }
]

上述示例对象将作为 ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large" 发送到 Adobe Analytics。

如果使用​数据对象，则在data.__adobe.analytics.products中设置产品语法推销eVar，使用的语法与AppMeasurement products变量相同。 上述XDM示例的数据对象等效项：

"data": {
  "__adobe": {
    "analytics": {
      "products": ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large"
    }
  }
}

使用转化变量语法实施

在products变量中无法设置eVar值时，请使用转化变量语法。 这种情况通常意味着您的产品页面没有促销渠道的上下文或查找方法。 在这些情况下，请将推销eVar设置在捆绑事件发生页面的上面或之前。 该值会一直保留到它过期或被新值覆盖为止。

当点击包含products变量和选定的促销捆绑事件时，eVar的当前值将捆绑到该点击上的每个产品。 在没有捆绑事件的产品旁设置eVar不会捆绑该值。 后续绑定是否替换现有绑定取决于分配设置。 请参阅绑定和分配的工作方式。

有关同时设置多个产品查找方法eVar的示例，请参阅最佳实践：产品查找方法。

以下示例在捆绑事件之前设置推销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"。 与此产品相关的后续成功事件将计入"Aviary"。 值"Aviary"还会绑定到以后包含捆绑事件的点击上的产品，直到满足以下任一条件为止：

使用 Web SDK 的转化变量语法

如果使用​XDM对象，则语法的操作方式与实现其他eVars和events类似。 如果使用​数据对象，则语法遵循AppMeasurement。

镜像上述AppMeasurement示例的XDM如下所示。

在同一或上个事件调用中设置 eVar：

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

设置产品字符串的捆绑事件和值：

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

镜像上述AppMeasurement示例的数据对象如下所示。

在同一或上个事件调用中设置 eVar：

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

设置产品字符串的捆绑事件和值：

"data": {
  "__adobe": {
    "analytics": {
      "events": "prodView",
      "products": ";Canary"
    }
  }
}