Article du Panier
Vue d'ensemble
Objet représentant une entrée de panier. Notez que l'article du panier peut représenter plusieurs articles achetés. CartItem.quantity fournit le nombre d'articles achetés.
Propriétés
cartItemId
• cartItemId: string
Identifiant unique global (GUID) d'un article du panier. Cet ID est unique entre les nouvelles impressions d'un article de catalogue. Ainsi, il peut changer lors de visites ultérieures à la page de vente incitative où le SDK Rokt présente des articles à un client. Comme d'habitude, en cas de modification d'un article du panier, Rokt déclenche Cart.onUpdateItem, cependant, dans ce cas particulier, un article mis à jour et un ancien article peuvent avoir un CartItem.cartItemId différent. Soyez attentif à ce comportement si vous utilisez la valeur CartItem.cartItemId pour corréler les articles de votre panier à ceux fournis dans le rappel Cart.onUpdateItem.
catalogItemId
• catalogItemId: string
Identifiant unique d'un article de catalogue. Le même article de catalogue est présenté à différents clients et contrairement à CartItem.cartItemId, sa valeur ne change pas entre les nouvelles impressions d'un article de catalogue. Cela peut également être considéré comme un SKU de produit.
currency
• currency: string
Code de devise conforme à la norme ISO 4217.
description
• description: string
Description d'un article.
linkedProductId (optionnel)
• linkedProductId: string | undefined
ID (SKU) d'un produit de l'inventaire du partenaire lié à l'article du panier de Rokt. Si présent, cela signifie que l'article du panier est attaché au produit du côté du partenaire et que l'article Rokt ne peut pas être vendu séparément du produit du partenaire.
Un exemple serait un client utilisant les services de Rokt pour acheter une garantie pour un article vendu sur la page d'un partenaire. Dans ce cas, CartItem.linkedProductId représenterait l'ID de l'article du partenaire. Si à un moment donné du flux de transaction le client choisit de retirer l'article du partenaire de son panier, l'article du panier Rokt doit également être retiré. La garantie ne peut pas être achetée sans l'article qu'elle couvre.
name
• name: string
Nom d'un article.
quantityMustBeSynchronized (optionnel)
• quantityMustBeSynchronized: boolean | undefined
La présence de ce drapeau indique que la quantité de l'article du panier CartItem.quantity est synchronisée avec la quantité du produit du partenaire représenté par CartItem.linkedProductId.
Un exemple serait un client achetant une garantie de Rokt pour un produit vendu sur la page du partenaire. Dans le cas de l'achat de plusieurs articles du même produit, la garantie serait représentée par un seul article de panier Rokt avec une quantité correspondant au nombre de produits ajoutés au panier par le client au moment de la sélection. Si à un moment donné du processus de transaction, le client choisit de retirer l'article du partenaire de son panier, l'article du panier Rokt devrait également être retiré. La garantie ne peut pas être achetée sans l'article qu'elle couvre.
providerData
• providerData: string
Une chaîne JSON contenant des informations arbitraires spécifiées par le fournisseur du produit ou du service.
quantity
• quantity: number
Quantité d'articles demandés.
totalPrice
• totalPrice: number
Le prix total est égal au prix unitaire multiplié par la quantité.
Si CartItem.quantityMustBeSynchronized est défini sur true, la valeur peut ne pas représenter le prix total final si le client modifie la quantité de produit liée.
unitPrice
• unitPrice: number
Prix par article.