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 eVar (dimensión de comercialización) en la guía de usuario sobre componentes.

Las eVars de comercialización enlazan un valor a productos individuales, de modo que los eventos de éxito que involucran a cada producto se acreditan al valor enlazado a ese producto. Puede establecer el valor de una de las dos maneras siguientes:

Para ver cómo funcionan el enlace, la asignación y la caducidad, consulte eVar (dimensión de comercialización).

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.

Elija una sintaxis.

Use Sintaxis del producto cuando el valor de comercialización esté disponible en el momento de establecer la variable products o cuando los productos de la misma visita necesiten valores diferentes. Use Sintaxis de la variable de conversión cuando el valor se conozca antes del producto, como el término de búsqueda o la campaña interna que condujo al visitante al producto. Consulte Funcionamiento del enlace y la asignación para ver una comparación completa.

Implementar mediante sintaxis de producto

Cuando se habilita Sintaxis del producto, el valor de comercialización se establece directamente en la variable products, por lo que no se utilizan eventos de enlace. Las eVars de comercialización van en el último segmento de cada producto:

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

Delimite varias eVars de comercialización en el mismo producto con una barra vertical (|). Los marcadores de posición vacíos para cantidad, ingresos y eventos son necesarios aunque no los utilice. Sin ellos, se ignora el valor eVar.

El valor está enlazado al producto en esa visita. El que un valor posterior reemplace un enlace existente depende de la configuración de Asignación. Ver Cómo funcionan el enlace y la asignación.

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

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:

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, las eVars de comercialización de sintaxis de producto se establecen en data.__adobe.analytics.products, con la misma sintaxis que la variable de AppMeasurement products. El equivalente del objeto de datos del ejemplo de XDM anterior:

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

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

Use Sintaxis de la variable de conversión cuando el valor de eVar no esté disponible para establecerse en la variable products. Esto suele significar que la página de producto no tiene contexto para el método de búsqueda o el canal de comercialización. En estos casos, configure eVar de comercialización en la página donde se produce el evento de enlace o antes de ella. El valor persiste hasta que caduca o se sobrescribe con un nuevo valor.

Cuando una visita contiene la variable products y un evento de enlace de comercialización seleccionado, el valor actual de eVar se enlaza a todos los productos de esa visita. Configurar eVar junto a un producto sin un evento de enlace no enlaza el valor. El que un enlace posterior reemplace a uno existente depende de la configuración de Asignación. Ver Cómo funcionan el enlace y la asignación.

Para ver un ejemplo que establece varias eVars de método de localización de productos a la vez, consulte Práctica recomendada: métodos de localización de productos.

El siguiente ejemplo establece un eVar de comercialización antes del evento de enlace:

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

Si Evento de vista de producto es un evento de enlace, el valor "Aviary" de eVar1 está enlazado al producto "Canary". Los eventos de éxito posteriores que involucran este producto se acreditan a "Aviary". El valor "Aviary" también se enlaza a productos en visitas posteriores que contengan un evento de enlace, hasta que se cumpla una de las siguientes condiciones:

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. Si se usa el objeto de datos, la sintaxis sigue a AppMeasurement.

La duplicación XDM del ejemplo de AppMeasurement 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"
  }
]

Los objetos de datos que reflejan el ejemplo de AppMeasurement 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"
    }
  }
}