カートアイテム
概要
カートエントリを表すオブジェクト。カートアイテムは複数の購入アイテムを表す場合があることに注意してください。CartItem.quantity は購入されたアイテムの数を提供します。
プロパティ
cartItemId
• cartItemId: string
カートアイテムのグローバルに一意の識別子 (GUID)。このIDはカタログアイテムの新しいインプレッション間で一意です。そのため、Rokt SDKが顧客にアイテムを提示するアップセルページへの後続の訪問で変更される可能性があります。通常、カートアイテムの変更の場合、RoktはCart.onUpdateItemをトリガーしますが、この特定のケースでは、更新されたアイテムと古いアイテムが異なるCartItem.cartItemIdを持つことがあります。カート内のアイテムをCart.onUpdateItemコールバックで提供されるアイテムと関連付けるためにCartItem.cartItemIdの値を使用する場合、この動作に注意してください。
catalogItemId
• catalogItemId: string
カタログアイテムの一意の識別子。同じカタログアイテムは異なる顧客に提示され、CartItem.cartItemIdとは異なり、その値はカタログアイテムの新しいインプレッション間で変わりません。これは製品SKUとも考えられます。
currency
• currency: string
ISO 4217 準拠の通貨コード。
description
• description: string
アイテムの説明。
linkedProductId (オプション)
• linkedProductId: string | undefined
パートナーの在庫からRoktのカートアイテムにリンクされた製品のID (SKU)。存在する場合、カートアイテムがパートナー側の製品に付随しており、Roktアイテムがパートナーの製品から独立して販売できないことを示します。
一例として、顧客がRoktのサービ スを利用してパートナーのページで販売されているアイテムの保証を購入する場合があります。この場合、CartItem.linkedProductId はパートナーのアイテムのIDを表します。トランザクションフローのどの時点でも、顧客がパートナーのアイテムをカートから削除することを選択した場合、Roktのカートアイテムも削除されるべきです。保証はそれがカバーするアイテムなしでは購入できません。
name
• name: string
アイテムの名前。
quantityMustBeSynchronized (オプション)
• quantityMustBeSynchronized: boolean | undefined
このフラグが存在することで、カートアイテム CartItem.quantity がパートナーの製品を表す CartItem.linkedProductId の数量と同期されていることを示します。
一例として、顧客がパートナーのページで販売されている製品に対してRoktから保証を購入する場合があります。同じ製品を複数購入する場合、保証は顧客が選択時にカートに追加した製品の数に一致する数量で単一のRoktカートアイテムとして表されます。取引の流れの中で、顧客がパートナーのアイテムをカートから削除することを選択した場合、Roktカートアイテムも削除されるべきです。保証はそれがカバーするアイテムなしでは購入できません。
providerData
• providerData: string
製品またはサービスプロバイダーによって指定された任意の情報を含むJSON文字列。
quantity
• quantity: number
要求されたアイテムの数量。
totalPrice
• totalPrice: number
合計価格は、単価に数量を掛けたものに等しいです。
CartItem.quantityMustBeSynchronized が true に設定されている場合、顧客がリンクされた製品の数量を変更した場合、この値は最終的な合計価格を表さない可能性があります。
unitPrice
• unitPrice: number
アイテムごとの価格。