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.

Le eVar di merchandising associano un valore ai singoli prodotti, in modo che gli eventi di successo che riguardano ciascun prodotto vengano attribuiti al valore associato a tale prodotto. È possibile impostare il valore in uno dei due modi seguenti:

Per informazioni sul funzionamento di binding, allocazione e scadenza, vedere eVar (dimensione merchandising).

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.

Scegli una sintassi

Utilizza Product Syntax quando il valore merchandising è disponibile al momento dell’impostazione della variabile products o quando i prodotti nello stesso hit richiedono valori diversi. Utilizzare Conversion Variable Syntax quando il valore è noto prima del prodotto, ad esempio il termine di ricerca o la campagna interna che ha portato il visitatore al prodotto. Vedi Funzionamento del binding e dell’allocazione per un confronto completo.

Implementazione utilizzando la sintassi di prodotto

Quando Product Syntax è abilitato, il valore di merchandising viene impostato direttamente all’interno della variabile products, pertanto gli eventi di binding non vengono utilizzati. Le eVar di merchandising si trovano nell’ultimo segmento di ciascun prodotto:

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

Delimitare più eVar di merchandising sullo stesso prodotto con una barra verticale (|). I segnaposto vuoti per quantità, ricavi ed eventi sono necessari anche se non vengono utilizzati. Senza di essi, il valore eVar viene ignorato.

Il valore è associato al prodotto in tale hit. Se un valore successivo sostituisce un’associazione esistente dipende dall’impostazione Allocation. Vedi Funzionamento del binding e dell’allocazione.

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

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 si utilizza l’oggetto dati, le eVar di merchandising della sintassi prodotto sono impostate in data.__adobe.analytics.products, utilizzando la stessa sintassi della variabile AppMeasurement products. L’equivalente dell’oggetto dati dell’esempio XDM precedente:

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

Implementazione utilizzando la sintassi per le variabili di conversione

Utilizzare Conversion Variable Syntax quando il valore eVar non è disponibile per essere impostato nella variabile products. In genere, questo scenario significa che la pagina di prodotto non presenta alcun contesto del canale di merchandising o del metodo di ricerca. In questi casi, imposta l’eVar di merchandising sulla pagina in cui si verifica l’evento di binding o prima di essa. Il valore persiste fino alla scadenza o viene sovrascritto con un nuovo valore.

Quando un hit contiene sia la variabile products che un Merchandising Binding Event selezionato, il valore corrente di eVar si associa a ogni prodotto in tale hit. L’impostazione di eVar insieme a un prodotto senza un evento di binding non associa il valore. Se un’associazione successiva sostituisce un’associazione esistente dipende dall’impostazione Allocation. Vedi Funzionamento del binding e dell’allocazione.

Per un esempio che imposta più eVar di metodo di ricerca dei prodotti contemporaneamente, vedere Best practice: metodi di ricerca dei prodotti.

L’esempio seguente imposta un’eVar di merchandising prima dell’evento di binding:

// 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 Product View Event è un evento di binding, il valore "Aviary" per eVar1 è associato al prodotto "Canary". Gli eventi di successo successivi che riguardano questo prodotto vengono attribuiti a "Aviary". Il valore "Aviary" si associa anche ai prodotti negli hit successivi che contengono un evento di binding, 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. Se si utilizza l’oggetto dati, la sintassi segue AppMeasurement.

L’XDM che rispecchia l’esempio di AppMeasurement 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"
  }
]

Gli oggetti dati che rispecchiano l’esempio di AppMeasurement precedente hanno l’aspetto 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"
    }
  }
}