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 eVars (dimensão de merchandising) no guia do usuário dos Componentes.

Para ver em detalhes como as eVars de merchandising funcionam, consulte eVars de merchandising e métodos de descoberta de produtos.

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.

WARNING
A falha na configuração correta das eVars de merchandising resulta em valores inesperados ou perda de dados para a variável. Verifique se a configuração está correta para a implementação.

Implementar utilizando a sintaxe do produto

Quando a “Sintaxe do produto” estiver ativada, a categoria de merchandising será preenchida diretamente na variável products, portanto, não é necessário selecionar ou configurar um evento compulsório. Esse é o método recomendado e que deve ser utilizado, salvo quando o valor não estiver disponível para definição em products quando o evento bem-sucedido ocorrer.

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

O valor para eVar1 é atribuído ao produto. Todos os eventos bem-sucedidos subsequentes e que envolverem este produto são creditados ao valor da eVar.

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:

  • As eVars de merchandising da sintaxe do produto são mapeadas em xdm.productListItems[]._experience.analytics.customDimensions.eVars.eVar1 para xdm.productListItems[]._experience.analytics.customDimensions.eVars.eVar250.
  • Os eventos de merchandising da sintaxe do produto são mapeados em xdm.productListItems[]._experience.analytics.event1to100.event1.value para xdm.productListItems[]._experience.analytics.event901to1000.event1000.value. Os campos XDM da serialização de eventos são mapeados em xdm.productListItems[]._experience.analytics.event1to100.event1.id a xdm.productListItems[]._experience.analytics.event901to1000.event1000.id.
NOTE
Ao definir eventos em productListItems, não é necessário defini-los na string do evento. Se estiverem definidos em ambos os lugares, o valor na string do evento terá prioridade.

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, o merchandising de eVar usará data.__adobe.analytics.eVar1 - data.__adobe.analytics.eVar250 seguindo a sintaxe do AppMeasurement.

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

A sintaxe da variável de conversão deve ser utilizada quando o valor da eVar não estiver disponível para a variável products. Normalmente, significa que sua página não tem o contexto do canal de merchandising ou do método de descoberta. Nesses casos, você define a variável de merchandising antes de chegar à página do produto e o valor persiste até que o evento compulsório ocorra.

Quando o evento compulsório selecionado durante a configuração ocorre, o valor persistente da eVar é associado ao produto. Por exemplo, se prodView for especificado como o evento compulsório, a categoria de merchandising está vinculada à lista de produtos atual somente no momento em que o evento ocorre. Somente eventos compulsórios subsequentes podem atualizar uma eVar de merchandising que já foi atribuída a um produto.

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

O valor "Aviary" para eVar1 é atribuído ao produto "Canary". Todos os eventos bem-sucedidos subsequentes que envolvem este produto são creditados a "Canary". Além disso, o valor atual da variável de merchandising está vinculado a todos os produtos subsequentes até que uma destas condições seja atendida:

  • A eVar expira (com base na configuração "Expirar após")
  • A eVar de merchandising é substituída por um novo valor.

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. O espelhamento do XDM no exemplo 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"
  }
]

Se estiver usando o objeto de dados, os objetos de dados que espelham o exemplo 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"
    }
  }
}
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690