products

La variabile products traccia i prodotti e le proprietà ad essi associate. Questa variabile viene generalmente impostata sulle singole pagine di prodotto, sulle pagine del carrello acquisti e sulle pagine di conferma degli acquisti. Si tratta di una variabile con più valori, il che significa che puoi inviare più prodotti nello stesso hit e l’Adobe analizza il valore in elementi dimensionali separati.

NOTA

Se questa variabile viene impostata in un hit senza la variabile events , la metrica Visualizzazioni prodotto incrementa di 1. Assicurati di impostare gli eventi appropriati per ogni hit con la variabile products .

Prodotti che utilizzano i tag in Adobe Experience Platform

Nell’interfaccia utente di raccolta dati non è disponibile un campo dedicato per impostare questa variabile; tuttavia, esistono più estensioni di terze parti per aiutarti.

  1. Accedi all' Interfaccia di raccolta dati utilizzando le tue credenziali AdobeID.
  2. Fai clic sulla proprietà desiderata.
  3. Vai alla scheda Extensions , quindi fai clic su Catalog per visualizzare tutte le estensioni disponibili.
  4. Cerca il termine "prodotto", che rivela diverse estensioni disponibili per impostare questa variabile.

Puoi utilizzare una di queste estensioni, oppure puoi utilizzare l'editor di codice personalizzato seguendo la sintassi AppMeasurement riportata di seguito.

s.products in AppMeasurement e nell’editor di codice personalizzato

La variabile s.products è una stringa che contiene più campi delimitati per prodotto. Delimitare ogni campo con un punto e virgola (;) nella stringa.

  • Categoria (facoltativo): La categoria di prodotto principale. La tua organizzazione decide come raggruppare i prodotti in categorie. La lunghezza massima per questo campo è di 100 byte.
  • Nome del prodotto (obbligatorio): Nome del prodotto. La lunghezza massima per questo campo è di 100 byte.
  • Quantità (facoltativo): Quanti di questi prodotti sono nel carrello. Questo campo si applica solo agli hit con l’evento di acquisto.
  • Prezzo (facoltativo): Prezzo totale del prodotto come decimale. Se la quantità è superiore a uno, impostare il prezzo sul totale e non sul prezzo del singolo prodotto. Allinea la valuta di questo valore in modo che corrisponda alla variabile currencyCode . Non includere il simbolo di valuta in questo campo. Questo campo si applica solo agli hit con l’evento di acquisto.
  • Eventi (facoltativo): Eventi legati al prodotto. Delimitare più eventi con una barra verticale (|). Per ulteriori informazioni, consulta eventi .
  • eVar (facoltativo): eVar di merchandising collegate al prodotto. Delimitare più eVar di merchandising con una pipe (|). Per ulteriori informazioni, consulta eVar per merchandising .
// Set a single product using all available fields
s.products = "Example category;Example product;1;3.50;event1=4.99|event2=5.99;eVar1=Example merchandising value 1|eVar2=Example merchandising value 2";

Questa variabile supporta più prodotti nello stesso hit. È utile per il carrello e gli acquisti contenenti più prodotti. La lunghezza massima per l'intera stringa products è 64K. Separa ogni prodotto con una virgola (,) nella stringa .

// Set multiple products - useful for when a visitor views their shopping cart
s.products = "Example category 1;Example product 1;1;3.50,Example category 2;Example product 2;1;5.99";
IMPORTANTE

Elimina tutti i punti e virgola, le virgole e i tubi dai nomi dei prodotti, dalle categorie e dai valori di eVar merchandising. Se un nome di prodotto include una virgola, AppMeasurement la analizza come inizio di un nuovo prodotto. Questa analisi errata getta via il resto della stringa di prodotto, causando dati errati nelle dimensioni e nei rapporti.

Esempi

La variabile products è flessibile quando si omettono i campi e si includono più prodotti. Questa flessibilità può semplificare la mancanza di un delimitatore, il che fa sì che l’implementazione invii ad Adobe dati errati.

// Include only product and category. Common on individual product pages
s.products = "Example category;Example product";

// Include only product name if you do not want to use product category
s.products = ";Example product";

// One product has a category, the other does not. Note the comma and adjacent semicolon to omit category
s.products = "Example category;Example product 1,;Example product 2";

// A visitor purchases a single product; record quantity and price
s.events = "purchase";
s.products = "Example category;Example product;1;6.99";

// A visitor purchases multiple products with different quantities
s.events = "purchase";
s.products = "Example category;Example product 1;9;26.91,Example category;Example product 2;4;9.96";

// Attribute currency event1 only to product 2 and not product 1
s.events = "event1";
s.products = "Example category 1;Example product 1;1;1.99,Example category 2;Example product 2;1;2.69;event1=1.29";

// Use multiple numeric events in the product string
s.events = "event1,event2";
s.products = "Example category;Example product;1;4.20;event1=2.3|event2=5";

// Use merchandising eVars without any events. Note the adjacent semicolons to skip events
s.products = "Example category;Example product;1;6.69;;eVar1=Merchandising value";

// Use merchandising eVars without category, quantity, price, or events
s.products = ";Example product;;;;eVar1=Merchandising value";

// Multiple products using multiple different events and multiple different merchandising eVars
s.events = "event1,event2,event3,event4,purchase";
s.products = "Example category 1;Example product 1;3;12.60;event1=1.4|event2=9;eVar1=Merchandising value|eVar2=Another merchandising value,Example category 2;Example product 2;1;59.99;event3=6.99|event4=1;eVar3=Merchandising value 3|eVar4=Example value four";

Se si utilizza il digitalData livello dati, è possibile eseguire iterazioni attraverso l'array di oggetti digitalData.product:

for(var i = 0; i < digitalData.product.length; i++) {
    // Add individual product info to the product string
    s.products += digitalData.product[i].category.primaryCategory + ";" + digitalData.product[i].productInfo.productName;
    // If there are more products, add a comma
    if(i != digitalData.product.length - 1) {
        s.products += ",";
    }
}

In questa pagina