woo-pricing-promotions

Woo の価格設定とプロモーション

稼働中の WooCommerce ストアでセール、価格変更、クーポンを実施し、お金をお金として扱います。すべての変更は実行前にプレビューされ、実行時にスナップショットが保存され、その後は元に戻せます。

このスキルでできること

ストアで、もっともらしく見える間違いが気づかれる前に実際のお金を損なうのは、価格設定の場面です。小数点の位置を誤るのは、誰かが報告するレイアウトの崩れとは違います。間違った価格で注文が入り、問題が表面化したときには、すでに注文が存在しています。そのため、ここでの作業順序は意図的に決められています。現在の価格を把握し、割合ではなく金額で変更内容を示し、確認してから書き込みます。

対応内容：

• 割合、固定額、または指定価格による、カテゴリー全体またはリスト指定での価格変更
• 開始日と終了日を設定した期間限定セール。終了を誰かが覚えていなくても、セールが自動で終了します
• 使用制限や商品・カテゴリーの制限を設定できる、固定額、割合、送料無料のクーポン
• ストアフロントでのセールバッジ表示
• 保存したスナップショットからの価格変更の復元

このスキルでできないこと

• 割引率を決めること。 割引幅の決定は利益率に関わる判断です。このスキルは、直近の販売数量に基づいて割引のコストを示しますが、割引率を選ぶことはありません。
• ガードレールを回避すること。 50%を超える変更、70%を超える割引、または0.50未満の価格はブロックされます。これはアドオンが意図的に拒否しているためです。その旨を明確に伝えて確認を求め、オーバーライドを付けて再送しないでください。
• 税、通貨、決済の設定を変更すること。
• 可変商品の親商品の価格だけを変更して済ませること。 バリエーションにはそれぞれ独自の価格があるため、対象を指定してください。稼働中の商品に新しいバリエーションを追加する場合も、新しい価格が発生します。アドオン 4.1.7 以降では、woocommerce_create_variation と woocommerce_generate_variations は最初にプレビューを表示し、本人の承認後、同じ呼び出しに confirm: true を付けると作成します。

要件

• Respira WooCommerce アドオンがライセンス済みの状態でインストールされた WooCommerce
• 数量の確認に woocommerce_top_products が読み取る、ストア独自の販売履歴

トリガーフレーズ

• 「セールを実施する」

代替トリガー

• 「このカテゴリーを割引する」
• 「クーポンを設定する」
• 「これらの商品を値下げする」
• 「セールを終了する」
• 「20%割引にすると、いくらかかりますか」

実行ワークフロー

フェーズ 1：現在の状態を確認する

商品の価格を記憶だけに頼って変更してはいけません。

1. 対象商品には woocommerce_list_products_advanced を、商品を指定する場合には woocommerce_get_product を使います。これは仕組み上も重要です。読み取りはアドオンが根拠情報として記録し、一度も読み取られていない対象への書き込みには未検証の注記が付きます。
2. 比較可能な直近の期間（date_start、date_end）について woocommerce_top_products を実行し、割引の影響を販売数量に照らして測れるようにします。
3. すでにセール中の商品がないか確認します。既存のセールに新たなセールを重ねることは、割引が意図の2倍の深さになってしまうもっとも一般的な原因です。

フェーズ 2：金額で示す

依頼内容を商品ごとの金額に換算し、明示します。

Outdoor の 14 商品です。通常価格は 24.00～189.00 です。20%のセールで、価格は 19.20～151.20 になります。直近30日間と同じ数量で販売した場合、割引額は約340になります。このうち2商品はすでに15%のセール中のため、除外しなければ割引率は32%になります。

書き込む前に確認を求めます。割合は、実際の金額よりも小さく感じられるものです。

フェーズ 3：プレビューする

毎回、まずは confirm を付けずに書き込みを実行します。アドオン 4.1.6 以降では、confirm: true を送らない限り、価格変更ツールと在庫ツールはプレビューを表示します（古いアドオンでは dry_run: true が必要です）。応答には、各商品の変更前と変更後の価格、およびガードレールによってブロックされる項目が表示されます。その一覧を見せ、承認を待ちます。プレビューはわずかな手間ですが、価格変更はそうではありません。

フェーズ 4：書き込み

• 価格を改定する場合は woocommerce_bulk_update_prices（change_type は percentage、absolute、set_value、apply_to は regular_price、sale_price、both）、自動で終了させる場合は woocommerce_schedule_sale を使用します。プレビューと同じ引数に加えて、confirm: true を指定します
• クーポンコードを作成する場合は woocommerce_create_coupon を使用します。ユーザーから別の指示がない限り、usage_limit を設定してください。上限のないコードはリスクになるためです
• ストアフロントにセールバッジを表示する場合は woocommerce_add_sale_badge を使用します（ブロックテーマのみ。最初に dry_run: true で実行してください）

スナップショットは自動的に取得されます。スナップショット ID を報告してください。

フェーズ 5：確認と取り消し方法の案内

変更内容を金額で示し、取り消し方法を案内します。product_id と snapshot_id を指定して woocommerce_revert_pricing を使用します。セールを予約した場合は、誰も操作しなくても終了する日付を伝えてください。

安全モデル

• 書き込みの前には必ずプレビューを行います
• 価格を変更するたびにスナップショットを取得し、元に戻すための明確な手段を用意します
• ガードレールにより過度な変更は拒否されます。ブロックされた場合はユーザーへの確認事項として扱い、回避すべき障害と見なしてはなりません
• クーポンにはデフォルトで使用上限を設定します
• 既存の注文価格には一切手を加えません

免責事項

このスキルは、実店舗のライブ価格を変更します。

このスキルでは、割引がビジネスにとって適切かどうかを判断したり、需要を予測したり、利益率を把握したり、競合他社の価格を確認したりすることはできません。割引率を決めることもありません。

このスキルでは、変更前に費用を確認し、商品群全体に一貫して適用し、終了日時を設定し、元に戻すことができます。

ツール

woocommerce_list_products_advanced、woocommerce_get_product、woocommerce_top_products、woocommerce_revenue_summary、woocommerce_bulk_update_prices、woocommerce_schedule_sale、woocommerce_create_variation、woocommerce_generate_variations、woocommerce_revert_pricing、woocommerce_create_coupon、woocommerce_update_coupon、woocommerce_list_coupons、woocommerce_add_sale_badge

テレメトリ

実行完了後、POST https://www.respira.press/api/skills/track-usage に対して、skill_slug = woo-pricing-promotions、サイトとバージョンのコンテキスト、所要時間、価格を改定した商品数、作成したクーポン数、発生したブロックを含めて、応答を待たずに送信します。テレメトリのためにユーザーを待たせないでください。

関連スキル

• Woo Catalog Perfection（セール対象のカタログを整備します）
• Woo Marketing Campaigns（セールの開催を告知します）
• WooCommerce Health Check（プロモーション前にストアの状態を確認します）

---

Respira Team 制作 https://respira.press/skills/woo-pricing-promotions