eVar (merchandising)

Esta página de ajuda descreve como implementar as eVars de merchandising. Para obter informações sobre como as eVars de merchandising funcionam como uma dimensão, consulte eVar (dimensão de merchandising) no guia do usuário Componentes.

As eVars de merchandising vinculam um valor a produtos individuais, de modo que os eventos bem-sucedidos envolvendo cada produto são creditados ao valor vinculado a esse produto. Você pode definir o valor de uma das duas formas a seguir:

Para saber como a associação, a alocação e a expiração funcionam, consulte eVar (dimensão de Merchandising).

Configurar eVars nas configurações do conjunto de relatórios

Antes de usar as eVars em sua implementação, configure-as com a sintaxe desejada nas configurações do conjunto de relatórios. Consulte Variáveis de conversão no Guia de administração.

Escolha uma sintaxe

Use a Sintaxe do Produto quando o valor de merchandising estiver disponível no momento em que você definir a variável products, ou quando os produtos na mesma ocorrência precisarem de valores diferentes. Use a Sintaxe de variável de conversão quando o valor for conhecido antes do produto, como o termo de pesquisa ou campanha interna que levou o visitante ao produto. Consulte Como a associação e a alocação funcionam para obter uma comparação completa.

Implementar utilizando a sintaxe do produto

Quando a Sintaxe do Produto está habilitada, o valor de merchandising é definido diretamente na variável products, portanto, os eventos de associação não são usados. As eVars de merchandising aparecem no último segmento de cada produto:

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

Delimite várias eVars de merchandising no mesmo produto usando uma barra vertical (|). Os espaços reservados vazios para quantidade, receita e eventos são necessários, mesmo que você não os use. Sem eles, o valor eVar é ignorado.

O valor está vinculado ao produto nessa ocorrência. A substituição de uma associação existente por um valor posterior depende da configuração Allocation. Consulte Como a associação e a alocação funcionam.

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

Sintaxe do produto usando o SDK da Web

Se estiver usando o objeto XDM, as variáveis de merchandising da sintaxe do produto usarão os seguintes campos XDM:

O exemplo a seguir mostra um único produto que usa vários eventos e eVars de merchandising:

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

O objeto de exemplo acima seria enviado para o Adobe Analytics como ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large".

Se estiver usando o objeto de dados, as eVars de merchandising com sintaxe de produto serão definidas em data.__adobe.analytics.products, usando a mesma sintaxe que a variável products do AppMeasurement. O equivalente do objeto de dados do exemplo XDM acima:

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

Implementar utilizando a sintaxe da variável de conversão

Use a Sintaxe de Variável de Conversão quando o valor de eVar não estiver disponível para definição na variável products. Normalmente, significa que a página do seu produto não tem o contexto do canal de merchandising ou do método de descoberta. Nesses casos, defina o eVar de merchandising na página em que o evento compulsório ocorre ou antes dela. O valor persiste até expirar ou é substituído por um novo valor.

Quando uma ocorrência contém a variável products e um Evento compulsório de merchandising selecionado, o valor atual da eVar vincula-se a cada produto nessa ocorrência. Definir o eVar ao lado de um produto sem um evento compulsório não vincula o valor. Se uma associação posterior substituirá uma existente dependerá da configuração Alocação. Consulte Como a associação e a alocação funcionam.

Para obter um exemplo que define várias eVars de método de descoberta de produto de uma só vez, consulte Prática recomendada: métodos de descoberta de produto.

O exemplo a seguir define um eVar de merchandising antes do evento compulsório:

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

Se o Evento de Exibição de Produto for um evento de associação, o valor "Aviary" para eVar1 será associado ao produto "Canary". Eventos bem-sucedidos subsequentes que envolvem este produto são creditados a "Aviary". O valor "Aviary" também se associa a produtos em ocorrências posteriores que contenham um evento compulsório, até que uma das seguintes condições seja atendida:

Sintaxe de variável de conversão usando o SDK da Web

Se estiver usando o objeto XDM, a sintaxe operará de forma semelhante à implementação de outros eVars e eventos. Se estiver usando o objeto de dados, a sintaxe segue o AppMeasurement.

O espelhamento do XDM no exemplo do AppMeasurement acima seria semelhante ao seguinte.

Defina a eVar na mesma chamada de evento ou na anterior:

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

Defina o evento compulsório e os valores da string de produtos:

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

Os objetos de dados que espelham o exemplo do AppMeasurement acima seriam semelhantes ao seguinte.

Defina a eVar na mesma chamada de evento ou na anterior:

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

Defina o evento compulsório e os valores da string de produtos:

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