Prodotto
L'oggetto prodotto rappresenta un articolo di linea di prodotto che si trova nel carrello o che è stato acquistato in un ordine.
Proprietà
id
- Tipo:
string - Obbligatorio
Un identificatore di prodotto univoco. Utilizzato per differenziare i prodotti nel carrello o nell'ordine.
WARNING
Alcuni carrelli della spesa utilizzano lo stesso identificatore o SKU per diverse varianti di un prodotto. Se più prodotti appaiono con lo stesso id, Fanplayr li considererà identici e ne unirà le quantità. Questo può portare al tracciamento di dati indesiderati, quindi è importante fornire un id univoco per ogni prodotto distinto tracciato.
qty
- Tipo:
integer - Obbligatorio
La quantità dell'articolo di linea nel carrello o nell'ordine.
sku
- Tipo:
string - Obbligatorio
Lo SKU del prodotto. Questo può essere lo stesso dell'id, ma è anche reso disponibile come opzione di segmentazione.
name
- Tipo:
string - Obbligatorio
Il nome del prodotto. Ad es. "Scarpe Rosse".
price
- Tipo:
float - Obbligatorio
Il prezzo unitario del prodotto visibile all'utente.
Per i carrelli che implementano un prezzo base e un prezzo scontato/in saldo, usare il prezzo scontato se è il prezzo mostrato agli utenti quando aggiungono il prodotto al carrello.
brands
- Tipo:
string[] - Ambito: Si applica solo agli oggetti Prodotto utilizzati nelle pagine Carrello e Conferma Ordine. Per le pagine Prodotto, utilizzare la proprietà brands a livello di pagina.
Un array di nomi di marchi associati al prodotto.
Esempio: ["Nike"]
categories
- Tipo:
string[] - Ambito: Si applica solo agli oggetti Prodotto utilizzati nelle pagine Carrello e Conferma Ordine. Per le pagine Prodotto, utilizzare la proprietà categories a livello di pagina.
Un array di nomi di categorie associati al prodotto.
Esempio: ["Donna", "Scarpe"]
catId
- Tipo:
string - Deprecato. Usare categories invece.
L'ID della categoria a cui appartiene questo prodotto. È possibile specificare più categorie separandole con virgole. Ad es. "32,762".
catName
- Tipo:
string - Deprecato. Usare categories invece.
Il nome della categoria a cui appartiene questo prodotto. È possibile specificare più categorie separandole con virgole. Ad es. "Parquet,Panchine".
url
- Tipo:
string
L'URL della pagina che mostra i dettagli completi del prodotto.
image
- Tipo:
string
L'URL dell'immagine del prodotto.
Strategia di unione dei prodotti
Fanplayr non sarà in grado di tracciare questi come prodotti separati in quanto condividono lo stesso id:
[
{
id: 'aygwi',
sku: 'aygwi',
name: 'Crew Tee (Black)',
price: 10.0,
qty: 1
},
{
id: 'aygwi',
sku: 'aygwi',
name: 'Crew Tee (White)',
price: 15.0,
qty: 1
}
];Invece, Fanplayr li vedrà come un singolo prodotto perché unisce le quantità di prodotti con lo stesso id. Questo può portare a un calcolo errato dei prezzi e delle quantità dei prodotti.
[
{
id: 'aygwi',
sku: 'aygwi',
name: 'Crew Tee (Black)',
price: 10.0,
qty: 2
}
];Questo può essere evitato fornendo identificatori univoci per i prodotti:
[
{
id: 'aygwi-black',
sku: 'aygwi',
name: 'Crew Tee (Black)',
price: 10.0,
qty: 1
},
{
id: 'aygwi-white',
sku: 'aygwi',
name: 'Crew Tee (White)',
price: 15.0,
qty: 1
}
];