Élément du panier
Aperçu
Objet représentant une entrée de panier. Notez que l'élément 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 (GUID) d'un élément du panier. Cet ID est unique entre les impressions récentes d'un article du catalogue. Par conséquent, il peut changer lors des 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 de l'élément 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 conscient de 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 du catalogue. Le même article du catalogue est présenté à différents clients et contrairement à CartItem.cartItemId, sa valeur ne change pas entre les nouvelles impressions d'un article du catalogue. On peut également le considérer comme un code 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. S'il est présent, cela signifie que l'article du panier est attaché au produit du côté du partenaire et que l'article de 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 supprimer l'article du partenaire de son panier, l'article du panier de Rokt devrait également être supprimé. La garantie ne peut pas être achetée sans l'article qu'elle couvre.
name
• name: string
Nom d'un élément.
quantityMustBeSynchronized (optionnel)
• quantityMustBeSynchronized: boolean | undefined
La présence du drapeau signifie que la quantité de l'élément 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. En cas d'achat de plusieurs articles du même produit, la garantie serait représentée par un seul élément du 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 flux de transaction, le client choisit de supprimer l'article du partenaire de son panier, l'élément du panier Rokt doit également être supprimé. 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 de produit ou de 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 apporte des modifications à la quantité du produit lié.
unitPrice
• unitPrice: number
Prix par article.