カートオブジェクト

1 つのオブジェクトの形が SDK 全体を流れます。getCart() が返すもの、cart_loaded と cart_updated がハンドラに渡すもの、そして Custom code ブロックが受け取るものがこれです。

すべての金額は通貨の最小単位（USD ならセント）で、フォーマット済みの文字列になることはありません。5779 は $57.79 です。表示には formatMoney を使ってください。

カート

フィールド	型	説明
`token`	`string`	Shopify のカートトークン。
`items`	`AftersellCartLine[]`	ラインアイテム。カートラインを参照。
`itemCount`	`number`	買い物客が見ているアイテムの合計数量。
`hasSubscriptionItems`	`boolean`	`items` 内の少なくとも 1 つのラインが販売プランを持つ場合に `true`。`itemCount` が除外するアドオンラインも含みます。空のカートでは `false`。
`totalPrice`	`number`	現在の合計（セント単位）。
`originalTotalPrice`	`number`	割引前の合計（セント単位）。
`totalDiscount`	`number`	割引の合計（セント単位）。
`compareAtTotalPrice`	`number \| null`	各ラインの compare-at（MSRP）× 数量の合計（セント単位）。利用できない場合は `null` なので、`originalTotalPrice` にフォールバックしてください。
`currency`	`string`	通貨コード。
`discountCodes`	`string[]`	カートで受け付けられたディスカウントコード（ソート済み）。ない場合は `[]`。
`attributes`	`Record<string, string>`	カート属性。SDK からは読み取り専用。

itemCount は必ずしも items の合計と一致しません。 items は実際の Shopify カートを反映し、配送保護など、ドロワーが非表示にするアドオンラインも含みます。itemCount はカートバッジと一致する買い物客向けの数字です。「買い物客がいくつ選んだか」には itemCount を、カートがレンダリングしているラインを走査するには items を使ってください。items から完全に欠けているものが 2 つあります。setHidden で非表示になったラインと、アンカーに移動するバンドルの子です。どちらも Shopify から直接取得されるカート合計には引き続き計上されます。

window.aftersell.cart.events.on('cart_updated', (state) => {
  console.log(state.itemCount, 'items');
  console.log('Total:', window.aftersell.cart.actions.formatMoney(state.totalPrice));
  console.log('Saved:', window.aftersell.cart.actions.formatMoney(state.totalDiscount));
  console.log('Codes:', state.discountCodes.join(', ') || 'none');
});

カートライン

items の各エントリ、および item_added と item_removed の item:

フィールド	型	説明
`key`	`string`	ラインの Shopify key。アイテム系のアクションに渡します。
`productId`	`number`	Shopify の商品 ID。
`variantId`	`number`	Shopify のバリアント ID。
`handle`	`string`	商品ハンドル。
`title`	`string`	表示タイトル。
`productTitle`	`string`	バリアントを含まない商品タイトル。
`variantTitle`	`string \| null`	バリアントのラベル、または `null`。
`variantOptions`	`Array<{ name, value }>`	選択されたオプション。例: `[{ name: 'Size', value: 'Medium' }]`。単一バリアント商品では Shopify は `Title: Default Title` を出力します。
`quantity`	`number`	このラインの数量。
`linePrice`	`number`	ラインの価格（セント単位）。
`finalLinePrice`	`number`	割引後のラインの価格（セント単位）。
`originalLinePrice`	`number`	割引前のラインの価格（セント単位）。
`compareAtPrice`	`number \| null`	バリアントの compare-at（MSRP）の単価（セント単位）。ない場合は `null`。
`properties`	`Record<string, string> \| null`	ラインアイテムのプロパティ。
`internalProperties`	`Record<string, string>`	`registerLineTransform` によるレンダリング専用のオーバーレイ。Shopify に永続化されることはありません。ない場合は `{}`。
`discountAllocations`	`Array<{ title, amount }>`	このラインに適用された割引。`amount` はセント単位。ない場合は `[]`。
`isGiftCard`	`boolean`	ラインがギフトカードかどうか。
`sellingPlan`	`{ id, name } \| null`	有効なサブスクリプションプラン。単発購入の場合は `null`。
`bundle`	`AftersellCartBundle \| null`	アンカーライン上のバンドルビューモデル。バンドル以外のラインと子では `null`。
`metadata`	`Record<string, unknown>`	エンリッチャーの `id` をキーとするエンリッチメントデータ。エンリッチャーが設定するまでは `{}`。

properties には、商品フォームのカスタムテキストフィールドなど、買い物客が入力した内容が含まれることがあります。生の HTML としてではなく、必ずテキストとしてレンダリングしてください。

ラインの識別

ラインに対して操作を行うものには key を、商品を識別するものには variantId または productId を使ってください:

// ✅ Acting on a line: use key.
window.aftersell.cart.actions.removeItem(line.key);

// ✅ Recognising a product: use variantId.
const hasGift = state.items.some((line) => line.variantId === GIFT_VARIANT_ID);

プロパティが異なると、同じバリアントが複数のラインに現れることがあります。刻印テキストの異なる 2 つの刻印入りマグカップは、1 つの variantId を共有する 2 つのラインです。アクションが key を取るのはこのためです。

ラインの価格

混同しやすい 3 つの価格:

知りたいもの	使うフィールド
このラインで買い物客が支払う金額	`finalLinePrice`
カート割引前の金額	`originalLinePrice`
MSRP の取り消し線表示（単価）	`compareAtPrice` × `quantity`

// Is this line discounted?
const isDiscounted = line.finalLinePrice < line.originalLinePrice;

// Is it free? (A common way to detect a gift line.)
const isFree = line.finalLinePrice === 0;

バンドル

ラインがバンドルにグループ化されると、アンカーラインが bundle オブジェクトを持ちます。子はその中に折りたたまれ、items に単独では現れなくなります。グループ化の設定方法については、他のアプリのバンドルラインをグループ化するを参照してください。

フィールド	型	説明
`id`	`string`	バンドルの識別子。
`source`	`'native' \| 'grouped'`	Shopify ネイティブのバンドルか、Aftersell によってグループ化されたラインか。
`memberKeys`	`string[]`	バンドル内のすべてのラインの `key`。
`children`	`AftersellBundleChild[]`	バンドルの内容。
`displayPrice`	`number`	バンドルとして表示される価格（セント単位）。

各子は key（ネイティブコンポーネントの場合は null）、title、variantTitle、quantity、perAnchorQty、imageUrl、finalLinePrice、originalLinePrice、compareAtPrice を持ちます。

// Skip bundle children when totalling your own line list.
const topLevel = state.items.filter((line) => !isBundleChild(line, state));

サブスクリプションプラン

ラインの有効なプランは sellingPlan で、単発購入の場合は null です。カート全体について知りたい場合は、自分でラインを走査するのではなく hasSubscriptionItems を読んでください。これは items には現れるが itemCount からは除外されるアドオンラインもカウントします:

if (state.hasSubscriptionItems) {
  // The cart contains at least one subscription line.
}

const subscriptions = state.items.filter((line) => line.sellingPlan);
console.log(subscriptions.length, 'subscription lines');

ラインで選択可能なプラン（ピッカーに表示されるもの）はカートオブジェクトにはありません。それらは registerSubscriptionOptionsTransform と registerDefaultSubscriptionOptionSelector で加工してください。

次のステップ

アクション: カートを読み取り、変更します。
イベント: このオブジェクトの供給元。
フック: エンリッチャーでラインに独自のデータを追加します。
ユースケース: これらのフィールドを読み取る完全なソリューション。

はじめに

ホームページ

ベストプラクティス

購入後アップセル

カート

チェックアウトアップセル（Shopify Plus）

サンキューページ

商品ページアップセル

Rokt Thanks

戦略

アナリティクスとトラッキング

連携

Aftersell MCP

請求とアカウント

トラブルシューティング

カート

カートライン

ラインの識別

ラインの価格

バンドル

サブスクリプションプラン

次のステップ

​カート

​カートライン

​ラインの識別

​ラインの価格

​バンドル

​サブスクリプションプラン

​次のステップ

カート

カートライン

ラインの識別

ラインの価格

バンドル

サブスクリプションプラン

次のステップ