Whop広告の連携
Whop Ads（Whop の広告機能）を使って Meta（Facebook / Instagram）に広告を出します。広告アカウント・審査・請求は Whop が代行するので、Meta の広告アカウントやトークンは要りません。アプリは Whop Ads API を通じて操作します。同意画面（リダイレクト）はありません。入力した API キーで広告を出せるビジネスを直接登録します（ChatGPT広告と同じ方式）。
| 項目 | 内容 |
|---|---|
| 認可方式 | APIキー（リダイレクトなし） |
| 用意するもの | Whop の API キー（Developer → API keys） |
| 配信先 | Meta（Facebook / Instagram） |
| コールバックURL | 不要 |
事前準備（Whop 側）
- Whop のビジネスで Whop Ads（Ads Manager）が使えることを確認します（現在は段階的に公開されているベータ版です）。
- Whop のダッシュボードの Developer → API keys で API キーを発行します。キーには下の「必須の権限」をすべて付けてください。
- **広告の支払い方法（残高）**を Whop に登録しておきます。無いとキャンペーンを公開できません。
- 自社のサイト（LP）に飛ばす場合は Whop Pixel を設置します。成果（購入・リードなど）は Whop Pixel で計測します。
必須の権限
API キーを発行するときに、次の権限（スコープ）を付けます。1つでも欠けていると連携できません（連携画面に足りない権限の名前が表示されます）。
| 権限 | 使いみち | 必須 |
|---|---|---|
company:balance:read | 連携時にキーのビジネス（ID・名前）を取得する | 必須 |
company:basic:read | 入稿前に、遷移先のページに Whop ピクセルが設置されているかを確認する | 必須 |
ad_campaign:basic:read | キャンペーン・広告グループ・広告と成果の参照（広告管理画面） | 必須 |
ad_campaign:create | キャンペーン・広告グループ・広告の作成（入稿） | 必須 |
ad_campaign:update | 公開・停止・予算や目標単価の変更・名前の変更・削除 | 必須 |
audience:basic:read | オーディエンスの参照（プリセットの選択肢・サイズ確認） | カスタムオーディエンスを使う場合 |
audience:update | オーディエンスの作成・会員の追加・類似の作成・削除 | カスタムオーディエンスを使う場合 |
event:create | コンバージョン送信（フォルダの「コンバージョン設定（CAPI）」からサーバーイベントを送る） | コンバージョン送信を使う場合 |
素材（画像・動画・顧客リスト）のアップロードには追加の権限は要りません。
重要
company:balance:read（残高の参照）は広告の操作には使いませんが、Whop の仕様でキーのビジネス情報を取得する API に必要なため必須です。company:basic:read は、入稿の前に遷移先の Whop ピクセルを確認するのに使います。権限を後から足した場合は、キーを入れ直して「連携する」をもう一度押してください（連携済みのビジネスは重複せず、キーだけ更新されます）。
注意
API キーは他人に見せないでください。 漏れた場合は Whop 側でキーを無効にして発行し直し、アプリでも連携し直してください。
連携の手順【アプリ】
- マイページ「アカウント連携」の「Whop広告」セクションで 「+ アカウントを連携」 を押します。
- 発行した API キーを入力します。
- 「Whop広告を連携する」を押します。リダイレクト・同意画面はありません。
- そのキーで広告を出せるビジネスが登録されます（Whop の API キーは 1キー = 1ビジネスです）。
- プロジェクトの「＋媒体追加」で 「Whop広告」 フォルダを作り、登録したビジネスを紐付けます（入稿のリーフは「Whop（Meta）」と表示されます）。
ヒント
すでに連携済みのビジネスは重複登録されません。もう一度「連携する」を実行すると、API キーが最新の内容に更新されます。
入稿と管理画面での注意
- 広告は「キャンペーン → 広告グループ → 広告」の3段です（Meta と同じ）。素材（画像・動画）1件につき広告1本を作ります。
- 見出し・メインテキストは複数書くと、1本の広告の中のテキストのバリエーションになります。
- キャンペーンは入稿の最後に必ず公開します（作成時のステータスは常にオン。審査を通過すると配信されます）。公開には Whop の支払い方法（残高）が必要です。
- 公開できなかったとき（支払い方法が未登録など）は下書きのまま残ります。原因を解消してから、Whop のダッシュボードか広告管理画面でキャンペーンの配信スイッチをオンにすると公開されます。
- Whop の予算・目標単価は 米ドル（USD） です。プリセットの金額（円）は入稿時にその日のレートで換算されます。管理画面の金額は既定で円に換算して表示します。
- 管理画面のグラフは日別のみ・直近62日までです。
Whop ピクセルの設置（入稿の前に）
Whop は、遷移先のページに Whop ピクセル が無いと広告を作れません。アプリは入稿の前に遷移先（プリセットの「最終ページURL」）を確認し、ピクセルが見つからなければ素材をアップロードする前に入稿を止めて理由を表示します。
- Whop の管理画面「Websites」でピクセルのタグをコピーします（タグの中にビジネス ID
biz_...が入っています）。 - LP の全ページの
<head>に貼ります。 - ページを一度開いてから入稿します（設置直後はイベントが届くまで少し時間がかかることがあります）。
Whop 上のページ（whop.com のストアなど）に飛ばす場合はタグは不要です。
うまくいかないときは
- 「必須の権限「…」がありません」と出る: 表示された権限を Whop のダッシュボードでキーに付けてから、もう一度連携します（このページの「必須の権限」を参照）。
- 「APIキーが無効です」と出る: キーの貼り間違い・失効を確認し、必要なら発行し直します。
- ビジネスが見つからない: そのキーで広告を出せるビジネスがありません。Whop Ads が有効か確認してください。
- 入稿で「遷移先（…）に Whop ピクセルが設置されていません」と出る: 上の「Whop ピクセルの設置」の手順でタグを貼ってから入稿し直します。ページが読み込めないと出る場合は、URL・公開状態・アクセス制限（パスワード保護など）を確認します。
- 公開できない: Whop に広告の支払い方法（残高）が登録されているか、LP に Whop Pixel が設置されているかを確認します。
ヒント
API キーはサーバーで AES-256-GCM 暗号化して保存され、画面や API レスポンスに平文で出ることはありません。