Bonafan 使い方ガイド
インストール後、最初の抽選販売を開くまでの手順と、抽選後に自動で行われることをまとめました。商品はいつもの Shopify 商品管理で作り、Bonafan では「どのバリエーションを何名に、いつまで応募を受け付けるか」だけを設定します。
1. 事前準備(Shopify 側)
顧客アカウントを有効にする
ストアドメインの応募ページ(/apps/bonafan/…)は、ファンがストアのアカウントでログインしてワンクリックで応募する方式です。Shopify 管理画面 → 設定 → お客様アカウントで、アカウントでのログインを有効にしてください。
メールアドレスだけで応募できる「メール認証応募」は Growth プラン以上で使えます。
販売する商品とバリエーションを作る
いつもどおり商品管理で商品を作成し、サイズなどのバリエーションと価格・在庫を登録します。抽選で売る分の在庫を用意してください(当選者数 ≦ 在庫数)。
- バリエーション ID を控えます: 商品 → 該当バリエーションを開いたときの URL 末尾の数字(例: …/variants/1234567890)。Bonafan の「Variant ID」欄には gid://shopify/ProductVariant/1234567890 の形式を貼り付けても構いません。
- 抽選対象の商品には商品タグ bonafan-target を付けておくと、当選者以外の直接購入を Shopify Flow で検知できます(任意)。
(任意)Shopify Flow で「当選者以外の購入」を検知する
商品ページが公開されていると、当選していない人が通常のカートから買える経路は Shopify の仕様上ふさげません。Bonafan の当選者チェックアウトには bonafan-raffle-<抽選ID> タグが付くので、このタグが無い注文を Flow で検知・通知するレシピを用意しています(セットアップガイド参照)。抽選中は商品を非公開にしておくのが第一の対策です。
2. 抽選を作成する(Bonafan 管理画面)
- タイトル
- 応募ページと当選メールに表示される名前です(例: スニーカーA 抽選販売)。
- Variant ID または 価格
- どちらか必須。Variant ID を入れると当選者のチェックアウトにその商品が Shopify の登録価格で入り、応募ページにも価格が表示されます。Variant ID を使わないときは価格(円)を入力すると、その金額のカスタム明細になります。
- 当選者数 / ファン優遇枠
- 当選する人数と、そのうち実績スコアで重み付けして選ぶ人数です。残りは実績に関係なく全員平等のくじで選ばれ、初めてのお客様にも当選の可能性が残ります。
- ファンの当たりやすさ(倍率)
- 常連ファン(実績スコア20が目安)が初めてのお客様の何倍当たりやすいかです。5 なら 5 倍、1 にすると全員平等です。
- 応募開始日時(任意)
- 設定するとその日時まで応募を受け付けません(予約公開)。空欄なら作成後すぐ受付開始です。
- 応募締切
- 締切を過ぎると 5 分以内に自動で抽選します。管理画面から手動で締め切る・抽選することもできます。
- 支払期限(時間)
- 当選通知(請求書メール)からお支払いまでの猶予です。過ぎると当選は取り消され、次点の応募者に自動で繰り上がります。
作成後も、抽選を実行するまではタイトル・締切・当選者数などを編集できます。抽選実行後は結果の改ざんになるため編集できません(テスト用の抽選は抽選前なら削除できます)。
4. 抽選後に自動で行われること
抽選
締切を過ぎると 5 分以内に自動抽選。応募者本人が同じメールで二重に応募していても 1 人として扱い、ブラックリストの顧客は抽選時に除外されます。
当選通知
当選者ごとに Shopify の下書き注文(draft order)を作成し、ストア名義の請求書メールを送ります。メール本文にお支払い期限が明記されます。
お支払いとリマインド
当選者が請求書のリンクからお支払いすると、注文が作成され Bonafan 側で支払い済みになります。期限の半分が過ぎても未払いの当選者には請求書メールを再送します。
失効と繰り上げ
支払期限を過ぎた当選は取り消され、下書き注文は無効化されます。同じ人数を残りの応募者から追加当選させ、同じように通知します。全員の支払いが確定するまで自動で繰り返します。
結果タグ
抽選が確定した応募者の顧客レコードに bonafan-won-<抽選ID> / bonafan-lost-<抽選ID> タグを付けます(ログイン応募のファンのみ)。
5. 発売前・非公開の商品でも使えますか?
使えます。むしろ推奨です。抽選の作成に必要なのはバリエーション ID だけで、商品がオンラインストアに公開されている必要はありません。当選者のチェックアウトは下書き注文(請求書リンク)なので、非公開・下書きの商品でも決済できます。
- 商品を「下書き」またはオンラインストア未公開のまま作成する(一般のお客様はカートに入れられず、発売前の直接購入を防げます)。
- Bonafan で抽選を作成し、必要なら「応募開始日時」で受付開始を予約する。
- 当選者のお支払いが終わったら、残りの在庫を公開して一般販売に切り替える(bonafan-target タグを外す)。
- 在庫は当選者がお支払いする時点で確保されている必要があります。在庫 0 や「在庫切れでも販売しない」設定のままだと請求書からの決済に失敗します。
- 価格は抽選直後(下書き注文の作成時)の Shopify 登録価格が使われます。抽選前に価格を確定してください。
- 下書きのままだと管理画面で目立たないため、発売日に公開し忘れないようご注意ください(当選者の購入自体は下書きでも可能です)。
6. プランと上限
抽選エンジンの機能(実績スコア・重み付け・繰り上げ・ブラックリスト)はどのプランでも同じです。差があるのは規模と応募方式です。
ベータ期間中の扱い
- 課金はまだ開始していません。ベータ期間中はどのプランでも料金がかかりません。
- インストールした直後は Free の上限で始まります(下表)。表の上限はベータ期間中も実際に適用されます。
- 上限が足りない場合や、メール認証応募を試したい場合はご連絡ください。上限なしのパイロット扱いに切り替えます。
- 有料プランを始めるときは事前にお知らせし、すでにご利用中のストアには移行期間を設けます。
| 項目 | Free | Starter | Growth | Unlimited |
|---|---|---|---|---|
| 月間応募数 | 100 件 | 1,000 件 | 10,000 件 | 無制限 |
| 1 抽選あたりの応募数 | 100 件 | 1,000 件 | 10,000 件 | 40,000 件 |
| 1 抽選あたりの当選者数 | 20 名 | 50 名 | 200 名 | 1,000 名 |
| 同時に受付中の抽選 | 1 件 | 3 件 | 10 件 | 無制限 |
| ブラックリスト | 100 件 | 1,000 件 | 無制限 | 無制限 |
| メール認証応募 | — | — | ✔ | ✔ |
上限に達すると、抽選の作成時はエラーメッセージ、応募時はファン向けに「応募受付は上限に達しました」の案内が表示されます。当選通知は当選確定からおおむね 30 分以内(Free)に届きます。
7. よくある質問
- テストはどうすればいいですか?
- 当選 1 名・締切を数分後にした抽選を作り、自分のアカウントで応募してみてください。締切後に請求書メールが届き、支払い〜繰り上げまでの一連の流れを確認できます。テスト抽選は抽選前なら削除できます。
- 当選メールが届かない応募者がいます
- 管理画面の応募者一覧で当選者の状態を確認してください。通知に失敗した場合は理由が表示され、「再送」でもう一度キューに戻せます。応募者本人は結果ページから支払いリンクを開くこともできます。
- 当選者が支払わなかったらどうなりますか?
- 支払期限を過ぎると自動で失効し、次点の応募者に繰り上げ通知が届きます。管理画面で操作は不要です。
- 転売目的の応募者を弾きたい
- 管理画面のブラックリストに顧客 ID を登録すると、応募は受け付けたまま抽選時に除外されます(入口で弾かないので、検知回避を学習させません)。
- 落選者に連絡したい
- 抽選確定後、応募者の顧客レコードに bonafan-lost-<抽選ID> タグが付きます。Shopify の顧客セグメントでこのタグを条件にし、Shopify Email(月 1 万通まで無料)からストア名義で一斉送信できます。
- 複数のバリエーション(サイズ違い)を抽選したい
- バリエーションごとに抽選を分けて作成してください(Free は同時に受付中の抽選が 1 件までです)。
お問い合わせ
設定でお困りの場合は bonafan098@gmail.com までご連絡ください。