商品

商品オブジェクトは、カートに入っている、または注文で購入された商品の明細項目を表します。

プロパティ

id

• タイプ: string
• 必須

一意の商品識別子。カートまたは注文内の商品を区別するために使用されます。

WARNING

一部のショッピングカートでは、商品の異なるバリエーションに同じ識別子またはSKUを使用しています。同じidを持つ複数の商品が表示された場合、Fanplayrはそれらを同一と見なし、その数量を統合します。これは意図しないデータ追跡につながる可能性があるため、追跡する個々の商品ごとに一意のidを提供することが重要です。

参照: 商品結合戦略

qty

• タイプ: integer
• 必須

カートまたは注文内の明細項目の数量。

sku

• タイプ: string
• 必須

商品SKU。これはidと同じである場合がありますが、セグメンテーションオプションとしても利用可能です。

name

• タイプ: string
• 必須

商品名。例: 「Red Shoes」。

price

• タイプ: float
• 必須

ユーザーに表示される商品の単価。

基本価格と割引価格/セール価格を実装しているカートの場合、ユーザーが商品をカートに追加する際に表示される価格が割引価格である場合は、その割引価格を使用してください。

brands

• タイプ: string[]
• スコープ: ショッピングカートおよび注文確認ページで使用される商品オブジェクトにのみ適用されます。商品ページの場合は、ページレベルのbrandsプロパティを使用してください。

商品に関連付けられたブランド名の配列。

例: ["Nike"]

categories

• タイプ: string[]
• スコープ: ショッピングカートおよび注文確認ページで使用される商品オブジェクトにのみ適用されます。商品ページの場合は、ページレベルのcategoriesプロパティを使用してください。

商品に関連付けられたカテゴリ名の配列。

例: ["Women", "Shoes"]

catId

• タイプ: string
• 非推奨。代わりにcategoriesを使用してください。

この商品が属するカテゴリのID。複数のカテゴリはコンマで区切って指定できます。例: 「32,762」。

catName

• タイプ: string
• 非推奨。代わりにcategoriesを使用してください。

この商品が属するカテゴリの名前。複数のカテゴリはコンマで区切って指定できます。例: 「Hardwood floors,Benches」。

url

• タイプ: string

商品の詳細を表示するページのURL。

image

• タイプ: string

商品画像のURL。

商品結合戦略

Fanplayrは、以下の商品が同じ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
  }
];

代わりに、Fanplayrは同じidを持つ商品の数量を結合するため、これらを単一の商品と見なします。これにより、商品価格と数量の計算が誤る可能性があります。

[
  {
    id: 'aygwi',
    sku: 'aygwi',
    name: 'Crew Tee (Black)',
    price: 10.0,
    qty: 2
  }
];

これは、商品に一意の識別子を提供することで回避できます。

[
  {
    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
  }
];