eVar (comercialización)

Esta página de ayuda describe cómo implementar eVars de comercialización. Para obtener información sobre cómo funcionan las eVars de comercialización como dimensiones, consulte eVars (dimensión de comercialización) en la guía del usuario de Componentes.

Para obtener información detallada sobre cómo funcionan las eVars de comercialización, consulte eVars de comercialización y métodos de búsqueda de productos.

Configurar eVars en la configuración del grupo de informes

Antes de usar eVars en la implementación, asegúrese de configurar la eVar con la sintaxis deseada en la configuración del grupo de informes. Consulte Variables de conversión en la guía de administración.

WARNING
Si no se configuran correctamente las eVars de comercialización, se pueden producir valores inesperados o incluso perder datos para la variable. Asegúrese de que esté correctamente configurado para su implementación.

Implementar mediante sintaxis de producto

Si se habilita Sintaxis del producto, la categoría de comercialización se rellena directamente en la variable products de los productos y, por ello, no resulta necesario seleccionar y establecer un evento de enlace. Este es el método recomendado y debe usarse a menos que no se encuentre disponible el valor que debe establecerse en products cuando el evento de éxito tiene lugar.

// 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";

El valor de eVar1 se asigna al producto. Todos los eventos de éxito subsiguientes que involucran este producto se acreditan al valor de la eVar.

Sintaxis del producto mediante el SDK web

Si se usa el objeto XDM, las variables de comercialización de sintaxis de producto usan los siguientes campos XDM:

  • Las eVars de comercialización de sintaxis de producto están asignados en xdm.productListItems[]._experience.analytics.customDimensions.eVars.eVar1 a xdm.productListItems[]._experience.analytics.customDimensions.eVars.eVar250.
  • Los eventos de comercialización de sintaxis de producto están asignados en xdm.productListItems[]._experience.analytics.event1to100.event1.value a xdm.productListItems[]._experience.analytics.event901to1000.event1000.value. Los campos XDM de serialización de eventos están asignados en xdm.productListItems[]._experience.analytics.event1to100.event1.id a xdm.productListItems[]._experience.analytics.event901to1000.event1000.id.
NOTE
Cuando establece eventos en productListItems, no es necesario establecerlos en la cadena de evento. Si se establecen en ambos lugares, el valor de la cadena de evento tiene prioridad.

El siguiente ejemplo muestra un único producto que usa varias eVars y eventos de comercialización:

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

El objeto del ejemplo anterior se enviaría a Adobe Analytics como ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large".

Si se usa el objeto de datos, la comercialización de eVar usa la sintaxis de AppMeasurement data.__adobe.analytics.eVar1 - data.__adobe.analytics.eVar250.

Implementación y uso de la sintaxis de la variable de conversión

La sintaxis de la variable de conversión debe usarse cuando no se encuentre disponible el valor de la eVar que debe establecerse en la variable products. Por lo general, esto significa que la página no dispone de contexto para el método de búsqueda o el canal de comercialización. En estos casos, se establece la variable de comercialización antes de llegar a la página del producto. El valor persistirá hasta que se produzca el evento de enlace.

Cuando el evento de enlace seleccionado durante la configuración tenga lugar, el valor de la eVar que se ha mantenido se asociará con el producto. Por ejemplo, si prodView se especifica como evento de enlace, la categoría de comercialización solo se enlazará con la lista de productos actual cuando se produzca el evento. Solo los eventos de enlace subsiguientes podrán actualizar una eVar de comercialización que ya se haya asignado a un producto.

// 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";

El valor "Aviary" de eVar1 se asigna al producto "Canary". Todos los eventos de éxito subsiguientes que involucran este producto se acreditan a "Canary". Asimismo, el valor actual de la variable de comercialización estará enlazado con todos los productos subsiguientes hasta que se cumpla una de estas condiciones:

  • Que caduque la eVar (en función de la opción “Caduca después”).
  • Que la eVar de comercialización se sobrescriba con un nuevo valor.

Sintaxis de variables de conversión mediante el SDK web

Si se usa el objeto XDM, la sintaxis funciona de manera similar a la implementación de otras eVars y eventos. La duplicación XDM del ejemplo anterior tendría el siguiente aspecto:

Establezca la eVar en la misma llamada de evento o en la anterior:

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

Establezca el evento de enlace y los valores para la cadena de productos:

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

Si se usa el objeto de datos, los objetos de datos que reflejan el ejemplo anterior tendrían el siguiente aspecto:

Establezca la eVar en la misma llamada de evento o en la anterior:

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

Establezca el evento de enlace y los valores para la cadena de productos:

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