eVar (merchandising)

Questa pagina della guida descrive come implementare le eVar di merchandising. Per informazioni sul funzionamento delle eVar di merchandising come dimensione, consulta eVar (dimensione merchandising) nella guida utente dei Componenti.

Per una discussione dettagliata sul funzionamento delle eVar di merchandising, consulta eVar di merchandising e metodi di ricerca dei prodotti.

Impostare le eVar nelle impostazioni della suite di rapporti

Prima di utilizzare le eVar nell’implementazione, accertati di configurarle nella sintassi desiderata nelle impostazioni della suite di rapporti. Consulta Variabili di conversione nella guida per l’amministratore.

Implementazione utilizzando la sintassi di prodotto

Quando è abilitata la “Sintassi del prodotto”, la categoria merchandising viene popolata direttamente all’interno della variabile products, pertanto non è necessario selezionare e impostare un evento di binding. Questo è il metodo consigliato e deve essere utilizzato a meno che il valore non sia disponibile per essere impostato in products quando si verifica l’evento di successo.

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

Il valore della eVar1 viene assegnato al prodotto. Tutti gli eventi di successo successivi che riguardano questo prodotto vengono attribuiti al valore eVar.

Sintassi di prodotto utilizzando il Web SDK

Se si utilizza l'oggetto XDM, le variabili di merchandising della sintassi di prodotto utilizzano i campi XDM seguenti:

L’esempio seguente mostra un singolo prodotto che utilizza più eVar ed eventi di 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"
          }
        }
      }
    }
  }
]

L’oggetto dell’esempio precedente viene inviato ad Adobe Analytics come ";Bahama Shirt;3;12.99;event4|event10=2:abcd;eVar10=green|eVar33=large".

Se utilizzi l'oggetto dati, eVar merchandising utilizza data.__adobe.analytics.eVar1 - data.__adobe.analytics.eVar250 seguendo la sintassi di AppMeasurement.

Implementazione utilizzando la sintassi per le variabili di conversione

La sintassi per le variabili di conversione viene utilizzata quando il valore eVar non è disponibile per essere impostato nella variabile products. Generalmente, questo scenario indica che la pagina non contiene nessun contesto del canale di merchandising o del metodo di ricerca. In questi casi, è possibile impostare la variabile merchandising prima di arrivare alla pagina del prodotto e il valore persiste finché non si verifica l’evento di binding.

Quando si verifica l’evento di binding selezionato durante la configurazione, il valore persistente dell’eVar è associato al prodotto. Ad esempio, se prodView è specificato come evento di binding, la categoria di merchandising viene associata all’elenco di prodotti corrente solo al momento in cui si verifica l’evento. Solo gli eventi di binding successivi possono aggiornare un’eVar di merchandising già assegnata a un prodotto.

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

Il valore "Aviary" della eVar1 viene assegnato al prodotto "Canary". Tutti gli eventi di successo successivi che riguardano questo prodotto vengono attribuiti a "Canary". Inoltre, il valore corrente della variabile merchandising è associato a tutti i prodotti successivi fino a quando non viene soddisfatta una delle seguenti condizioni:

Sintassi per la variabile di conversione utilizzando il Web SDK

Se utilizzi l'oggetto XDM, la sintassi funziona in modo simile all'implementazione di altri eVar e eventi. L’XDM che rispecchia l’esempio precedente è simile al seguente:

Imposta l’eVar sulla stessa chiamata di evento oppure su quella precedente:

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

Imposta l’evento di binding e i valori per la stringa di prodotti:

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

Se si utilizza l'oggetto dati, gli oggetti dati che rispecchiano l'esempio precedente avranno un aspetto simile al seguente:

Imposta l’eVar sulla stessa chiamata di evento oppure su quella precedente:

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

Imposta l’evento di binding e i valori per la stringa di prodotti:

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