ホーム運用パラメータ
運用パラメータ
フロー・アクションが参照する KV 設定値の編集。
このページの目的
フロー・アクションが参照する運用パラメータを編集します。料率・遅延秒数・Shopify バリアント ID など、コード変更なしで動的に変えられる設定値です。
主な設定キー
- warranty_2yr_rate / warranty_3yr_rate: 保証料の料率 (注文額に対する%)
- upsell_delay_seconds: 注文後何秒でアップセルメール送るか (例: 259200=3日)
- upsell_expiry_seconds: Draft Order の有効期限 (秒)
- repurchase_elapsed_seconds: 買い替え提案の経過 (例: 63072000=2年)
- warranty_product_id / warranty_2yr_variant_id / warranty_3yr_variant_id: Shopify 側の保証商品/バリアントID
- recommend_exclude_product_ids: レコメンドから外す商品ID (CSV)
- recommend_exclude_tags: レコメンドから外すタグ (CSV、デフォルト: 保証, warranty, 決済専用, draft-only, upsell-only)
- ses_region / ses_from_email: SES 設定
変更時の注意
- 変更は即時反映。配信中のフローも次のステップから新しい値を使います。
- 大きな数値変更は監査ログに残ります。後で経緯を追いやすい。
- 誤って空にすると施策が止まります。バックアップ用に値を控えておくと安心。
よくある変更パターン
| 変更 | キー | 例 |
|---|---|---|
| アップセル送信を3日→7日に | upsell_delay_seconds | 604800 |
| Draft Order 期限を3日→14日に | upsell_expiry_seconds | 1209600 |
| 2年保証料率を15%に | warranty_2yr_rate | 0.15 |
| レコメンド除外タグを追加 | recommend_exclude_tags | 保証,warranty,新品同様 |
| 送信元アドレス変更 | ses_from_email | info@mdlmake.jp |
やってはいけない変更
- warranty_*_variant_id を空にすると Draft Order 作成が即失敗します
- shopify_store を変えると全 Shopify API 呼び出しが死にます
- ses_from_email は SES で検証済みのアドレスのみ使用可
- 料率を 1.0 超にすると本体価格より高い保証料に
よくある質問
新しい設定値を追加したい
テーブル直接 INSERT が必要。
wrangler d1 execute mdl-marketing-db --remote --command="INSERT INTO settings (key, value) VALUES ('new_key', 'value')"削除したい
UI から削除はできません (誤削除防止)。必要なら直接 D1 で DELETE。
変更が反映されない
KV キャッシュが残っている可能性。最大 5分待つか、Workers を再デプロイ。
関連ページ