> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bouquet-inc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# クーポン獲得ボタンで、ボタンを押したお客様だけにクーポンを配る

> 商品ページやトップページに「クーポンを獲得する」ボタンを置き、押したお客様だけがクーポンを使えるようにする設定です。獲得していないお客様がコードを入力しても、チェックアウトでは使えません。Standardプラン以上でご利用いただけます。

## クーポン獲得ボタンとは

テーマに「クーポン獲得ボタン」のブロックを置くと、ログインしたお客様がボタンを押したときだけ、そのクーポンが使えるようになります。獲得したクーポンは、マイページやチェックアウトのクーポン一覧にも表示されます。

ボタンを押していないお客様は、コードを知っていてもチェックアウトで使えません。使えるかどうかはShopifyが判定します。

獲得ボタンを押すと、お客様に「`dd-claim-`」で始まる顧客タグが付きます。Discount Deckは、このタグを条件にした顧客セグメント（獲得セグメント）を作ります。クーポンの対象をこの獲得セグメントだけにしておくことで、獲得したお客様だけが使える状態になります。

**こんな施策にお使いいただけます**

* **商品ページで配るクーポン** … 商品を見ているお客様に、その場で獲得してもらう
* **LP・キャンペーンページのクーポン** … ページを訪れた方だけが受け取れる特典にする
* **会員登録のきっかけ作り** … 獲得にはログインが必要なので、未登録のお客様に登録を促せる
* **メルマガ・SNSからの誘導** … リンク先のページでボタンを押した方だけに配る

> [!NOTE]
>
> Standard・Pro・Enterpriseプランでご利用いただけます。Freeプラン・Starterプランではご利用いただけません。

## ご利用いただける条件

| 項目 | 条件 |
| - | - |
| プラン | Standardプラン以上（Standard・Pro・Enterprise） |
| アプリの権限 | 新しい権限（App Proxy）を承認していること。2026年11月9日以降に初めてアプリを開くと、承認の画面が表示されます |
| クーポンの種類 | コードの割引（金額・割合の割引、Buy X Get Y、送料無料）。自動ディスカウントは対象外です |
| コードの数 | 1つのディスカウントにコードが1つだけ |
| 除外キーワード | [マイページに表示しないクーポンコード](https://docs.bouquet-inc.com/apps/discount-deck/setup/auto-display-exclusion.md)に当たらないこと |
| 本数 | 獲得タグが残っている獲得型のクーポンは、1ストアあたり20本まで |

条件を満たしていないクーポンは、クーポンの詳細画面に「このクーポンはまだ獲得ボタンで配れません」と理由が表示され、獲得型にできません。

## 設定方法

**1. アプリの新しい権限を承認する（初回のみ）**

クーポン獲得ボタンを使うために、アプリに新しい権限（App Proxy）が必要になりました。2026年11月9日以降に初めてDiscount Deckを開くと、権限の承認画面が表示されますので、承認してください。

承認していない場合は、クーポンの詳細画面に「アプリの新しい権限（App Proxy）を承認してください」と表示され、獲得ボタンで配ることができません。アプリを開き直すと承認の画面が出ます。

**2. Shopifyでクーポンを作る**

Shopify管理画面の「ディスカウント」から、コードの割引を作ります。割引額・コード・有効期間・1人1回の制限などは、通常どおり設定してください。

> [!WARNING]
>
> **開始日は未来の日時にしておいてください。** この時点ではクーポンの利用資格が「すべてのお客様」のため、設定を終える前に有効になると、コードを知っている人なら誰でも使えてしまいます。配り始める日時には、手順6で変更します。

**3. Discount Deckのクーポン詳細で「獲得ボタンで配る」を押す**

アプリの「クーポン一覧」から対象のクーポンを開き、「**獲得ボタンでクーポンを表示する**」のカードにある「**獲得ボタンで配る**」を押します。

![クーポン詳細の「獲得ボタンでクーポンを表示する」のカード（未設定）](https://mintcdn.com/bouquet-inc/qmc3ru5_JfavW2OB/images/discount-deck/coupon-claim-button-1.jpg?fit=max\&auto=format\&n=qmc3ru5_JfavW2OB\&q=85\&s=ee1d49c9f4c9b86bb0ee306ab955a86c)

Discount Deckが、獲得セグメント「Claim coupon / 獲得型クーポン:クーポン名(クーポンの ID)」を作り、カードの状態が「対象の設定待ち」になります。

![獲得セグメントが作られ、「対象の設定待ち」になったカード](https://mintcdn.com/bouquet-inc/qmc3ru5_JfavW2OB/images/discount-deck/coupon-claim-button-2.jpg?fit=max\&auto=format\&n=qmc3ru5_JfavW2OB\&q=85\&s=7736e4d12808eaf6105317b601160548)

**4. Shopifyでクーポンの対象を獲得セグメントだけにする**

カードの「**Shopify でディスカウントを開く**」から、Shopifyのディスカウントの編集画面を開きます。「利用資格」を「顧客セグメント」にして、手順3で作られた獲得セグメント**だけ**を選び、保存してください。

![Shopifyのディスカウントの「利用資格」を「顧客セグメント」にして、獲得セグメントだけを選んだ状態](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-3.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=96cbb61f6b70fc046004cdc035857de5)

> [!WARNING]
>
> ほかのセグメントも一緒に選ぶと、そのセグメントのお客様は獲得しなくてもクーポンを使えてしまいます。獲得セグメントだけを選んでください。

**5. Discount Deckに戻って「確認」を押す**

クーポンの詳細画面に戻り、「**確認**」を押します。対象が獲得セグメントだけになっていれば、状態が「有効」になり、クーポンはマイページに表示する扱いになります。クーポン一覧からの同期操作は不要です。

カードに「**ボタン用の ID**」が表示されますので、「**ID をコピー**」でコピーしておきます。

![「有効」になり、ボタン用のIDが表示されたカード](https://mintcdn.com/bouquet-inc/qmc3ru5_JfavW2OB/images/discount-deck/coupon-claim-button-4.jpg?fit=max\&auto=format\&n=qmc3ru5_JfavW2OB\&q=85\&s=7be674266b4af15afdac26d37a3d0b7b)

対象の設定が違う場合は、「利用資格が、まだ顧客セグメントになっていません」「獲得セグメント以外のセグメントも選ばれています」などの理由が表示され、有効になりません。手順4の設定を見直してください。

**6. テーマエディタで「クーポン獲得ボタン」のブロックを置く**

カードの「**テーマエディタでボタンを置く**」を押すと、商品ページのテンプレートにブロックが追加された状態でテーマエディタが開きます。ほかのページに置くときは、オンラインストア > テーマ > カスタマイズ、からページを開き、「ブロックを追加」>「アプリ」>「**クーポン獲得ボタン**」を選んでください。

ブロックの設定の「**ボタン用の ID**」に、手順5でコピーしたIDを貼り付けます。見出し・説明・ボタンの文言・色を設定し、「保存」を押してください。設定項目は下の「ブロックの設定項目」をご覧ください。

![テーマエディタで「クーポン獲得ボタン」のブロックを商品ページに置き、ボタン用のIDと見出し・説明を入れた状態](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-5.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=8822876f6cd7a9307a48e76dcd9aed5b)

> [!NOTE]
>
> ブロックを追加できるセクションがないページでは、先に「アプリ」のセクションを追加し、その中にブロックを置いてください。

**7. 開始日を配り始める日時にして、動作を確かめる**

Shopifyのディスカウントの開始日を、配り始める日時に変更します。

テスト用のお客様でストアにログインし、ボタンを押してください。ボタンが「獲得済み」に変わり、クーポンコードとコピーのボタン、「マイページで見る」のリンクが表示されます。数秒後には、マイページとチェックアウトのクーポン一覧にも表示されます。

![ログイン中のお客様に表示される「クーポンを獲得する」のボタン](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-7.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=41ab0f90a7767a7edc3b1040685ad748)

![ボタンを押した直後の表示。「獲得済み」とクーポンコード、コピーのボタン、「マイページで見る」のリンク](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-8.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=43033b5a4d16043bd528f32ffc941bf9)

ログインしていない状態では、ボタンの代わりに「ログインして獲得する」が表示されます。

![ログインしていないお客様に表示される「ログインして獲得する」](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-6.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=ce2011f1458e57c45707d8f5b205132f)

## ブロックの設定項目

| 設定 | 内容 |
| - | - |
| ボタン用のID | Discount Deckのクーポン詳細に表示されるID。数字以外が入っていると、ストアにボタンが表示されません |
| 見出し | ボタンの上に表示する見出し（例: 「10%OFFクーポン」） |
| 説明 | 見出しの下に表示する説明文 |
| ボタンの文言 | 獲得前のボタンの文言。空欄なら「クーポンを獲得する」 |
| 獲得後の文言 | 獲得したあとに表示する文言。空欄なら「獲得済み」 |
| ログイン前のボタンの文言 | 未ログインのお客様に表示するボタンの文言。空欄なら「ログインして獲得する」 |
| ボタンの背景色・ボタンの文字色・文字色 | ボタンと文字の色 |
| ボタンの角丸 | ボタンの角の丸み（0〜30px） |

ボタン用のIDが未入力のときは、テーマエディタ上にだけ「ボタン用の ID を入れてください」の案内が表示され、ストアには何も表示されません。

## お客様の画面の動き

| お客様の状態 | 表示 |
| - | - |
| ログインしていない | 「ログインして獲得する」のボタン。押すとログイン画面に移ります。ログイン後、ボタンのあるページに戻って、もう一度ボタンを押してください |
| ログイン済みで、まだ獲得していない | 「クーポンを獲得する」のボタン |
| ボタンを押した直後 | 「獲得済み」の表示と、クーポンコード・「コピー」ボタン・「マイページで見る」のリンク。数秒後にマイページとチェックアウトの一覧にも表示されます |
| 獲得済みで、ページをもう一度開いた | 最初から「獲得済み」と「マイページで見る」が表示されます。コードはマイページで確認できます |
| クーポンの期限が切れている | 押すと「このクーポンの配布は終了しました。」と表示されます |
| 獲得する前に、1人1回のクーポンをすでに使っていた | 押すと「このクーポンはすでにご利用済みです。」と表示されます |
| 獲得ボタンを停止中、または設定が合っていない | 押すと「このクーポンは現在獲得できません。」と表示されます |

![獲得済みのお客様がページをもう一度開いたときの表示](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-9.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=d3489cef80ec8d193bd7c1e931414f9b)

ボタンの文言は、ストアの言語（日本語・英語・繁体字中国語）に合わせて表示されます。ブロックの設定で文言を入力した場合は、入力した文言がそのまま表示されます。

## 配布を止める・終える

* **期限が来たとき**: クーポンの有効期間が終わると、配布も自動で終わります。獲得していたお客様も使えなくなります
* **途中で止めるとき**: クーポン詳細の「**獲得ボタンを停止する**」を押すと、新たに獲得できなくなります。すでに獲得したお客様は、クーポンの期限まで使えます。「**獲得ボタンを再開する**」で配布を再開できます
* **クーポンを削除したとき**: ストアのボタンは「現在獲得できません」の表示になります。翌日に、獲得したお客様から獲得タグが外れ、獲得セグメントも削除されます

**獲得タグの自動削除**

獲得ボタンで付いた顧客タグは、ディスカウントを削除した翌日か、期限切れから30日後に、Discount Deckが自動で外します。外す予定日はクーポンの詳細画面に表示されます。

> [!WARNING]
>
> 期限の切れたクーポンを延長して使う場合は、期限切れから30日以内に行ってください。獲得タグが外れたあとに延長しても、獲得していたお客様は使えません。

獲得タグが外れるまでは、そのクーポンは「獲得型のクーポン20本まで」の数に含まれます。今の本数は、クーポン詳細の「獲得型クーポンの使用状況」で確認できます。

## 守っていただきたいこと

獲得ボタンは、顧客タグ・獲得セグメント・ディスカウントの対象の3つがそろって動きます。どれかを手で変えると、獲得していないお客様が使えたり、獲得したお客様が使えなくなったりします。

* 「`dd-claim-`」で始まる顧客タグを、手で付けたり外したりしないでください。ストアの運用で使うタグにも「`dd-claim-`」を使わないでください
* Discount Deckが作った獲得セグメントの条件を変更したり、削除したりしないでください
* ディスカウントの利用資格は、獲得セグメントだけのままにしてください。対象が変わると、クーポンの詳細画面に「獲得ボタンの設定が変わっています」と警告が表示されます
* 獲得型の設定を終えるまで、ディスカウントの開始日は未来にしておいてください
* Shopifyのお客様1人に付けられるタグは250個までです。ほかのアプリやストアの運用でタグが多いお客様は獲得できず、「獲得できませんでした。お店にお問い合わせください。」と表示されます
* Shopify管理画面の「設定」>「アプリと販売チャネル」にあるDiscount DeckのApp ProxyのURLは、変更しないでください。変更すると、ボタンを押しても獲得できなくなります

## 獲得したお客様を確認する

獲得したお客様の一覧と人数は、Shopify管理画面の「顧客管理」で、顧客セグメント「Claim coupon / 獲得型クーポン:クーポン名(クーポンの ID)」を開くと確認できます（以前に作られた獲得セグメントは「獲得型クーポン:クーポン名(クーポンの ID)」の名前のままです）。アプリの画面には表示されません。

獲得したお客様にクーポンのお知らせを送りたいときは、[クーポン付与通知](https://docs.bouquet-inc.com/apps/discount-deck/flows/coupon-issued-notification.md)のShopify Flowがそのまま使えます。

## よくある質問

> [accordion] 獲得したお客様が、チェックアウトでコードを使えません
>
> 次の順でご確認ください。
>
> 1. Discount Deckのクーポン詳細に「獲得ボタンの設定が変わっています」の警告が出ていないか。出ている場合は、Shopifyでディスカウントの対象が獲得セグメントだけになっているか、獲得セグメントが削除・変更されていないかを確認してください
> 2. ディスカウントが有効期間内か
> 3. 1人1回のクーポンを、そのお客様がすでに使っていないか
> 4. お客様の顧客タグに「`dd-claim-`」で始まるタグが残っているか。期限切れから30日を過ぎると自動で外れます

> [accordion] 獲得したのに、マイページの一覧にクーポンが出ません
>
> 獲得してから一覧に表示されるまでに数秒かかります。しばらく待ってからマイページを開き直してください。
>
> お客様が持っているクーポンの数が表示の上限に達している場合は、期限の遠いクーポンから一覧に入らなくなります。この場合もボタンにコードが表示されていれば、チェックアウトでそのまま使えます。

> [accordion] ストアにボタンが表示されません
>
> ブロックの「ボタン用の ID」に、クーポン詳細に表示されたIDが正しく入っているかをご確認ください。IDが未入力か、数字以外の文字が含まれていると、テーマエディタ上にだけ案内が表示され、ストアには何も表示されません。
>
> ログインしていないお客様には、ボタンの代わりに「ログインして獲得する」が表示されます。

> [accordion] ボタンを押すと「獲得できませんでした」と表示されます
>
> 次をご確認ください。
>
> * Discount Deckのクーポン詳細で、状態が「有効」になっているか。「停止中」や「対象の設定待ち」の間は獲得できません
> * ブロックの「ボタン用の ID」が、そのクーポンのIDと一致しているか
> * Shopify管理画面の「設定」>「アプリと販売チャネル」で、Discount DeckのApp ProxyのURLを変更していないか
>
> 「混み合っています」と表示された場合は、少し時間をおいてからもう一度お試しください。

> [accordion] 「獲得ボタンで配る」を押せません
>
> カードに「このクーポンはまだ獲得ボタンで配れません」と理由が表示されます。上の「ご利用いただける条件」をご確認ください。たとえば、Standardプラン未満のプラン、権限の未承認、自動ディスカウント、コードが複数あるディスカウント、除外キーワードに当たるコード、獲得型のクーポンが20本に達している場合は獲得型にできません。

> [accordion] 獲得していないお客様にも、同じクーポンを使わせたいです
>
> ディスカウントの対象に、獲得セグメント以外のセグメントや「すべてのお客様」を足さないでください。獲得ボタンが正しく動かなくなります。獲得せずに使えるクーポンが必要な場合は、別のディスカウントとして作成してください。

> [accordion] 獲得した1人1回のクーポンをお客様が使うと、ボタンはどうなりますか？
>
> ボタンは「獲得済み」のまま表示され、押すことはできません。使ったクーポンはマイページの一覧から外れます。
>
> 獲得する前に、そのクーポンをすでに使っていたお客様がボタンを押した場合は、「このクーポンはすでにご利用済みです。」と表示され、獲得できません。

> [accordion] 獲得できる期間や人数を区切れますか？
>
> 獲得できる期間は、ディスカウントの有効期間と同じです。期間を区切りたいときは、Shopifyのディスカウントの開始日と終了日で設定してください。
>
> 先着何名までといった人数の制限には対応していません。クーポンの合計の使用回数を制限したい場合は、Shopifyのディスカウントの「使用回数の上限」をご利用ください。

## 関連ページ

* [Discount Deckの初期設定](https://docs.bouquet-inc.com/apps/discount-deck/setup.md)
* [クーポン付与通知](https://docs.bouquet-inc.com/apps/discount-deck/flows/coupon-issued-notification.md)
* [マイページに表示しないクーポンコードを設定する](https://docs.bouquet-inc.com/apps/discount-deck/setup/auto-display-exclusion.md)
* [Discount Deckのよくある質問](https://docs.bouquet-inc.com/apps/discount-deck/faq.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.