ストアを接続し、商品を紹介。

商品とアラートは別の機能です

使う項目： 収益化（Monetization） をSSNで使うと、公開商品や支援ページの紹介、アクティビティの受信、または両方を行えます。このガイドではFourthwall、Ko-fi、Buy Me a Coffeeを扱います。NinjaBacker、Throne、Amazon、eBayはこちら： 収益化ガイド.

アラートを接続 · Fourthwall · Ko-fi · Buy Me a Coffee · 商品をインポート · OBSとQRコード · トラブル対処

アクティビティのアラートを接続

1. 開く項目： 収益化 → Fourthwall・Ko-fi・Buy Me a Coffeeのアラート（Monetization → Fourthwall, Ko-fi & Buy Me a Coffee alerts） を開き、プロバイダーを選びます。
2. クリックする項目： 受信機の設定。既存の次のスイッチを有効にします： 拡張機能のリモートAPI制御（remote API control of extension） のスイッチをオンにし、SSNを有効のままにします。
3. Monetizationに戻り、次をクリックします： Webhook URLをコピー。この非公開アドレスを、以下のプロバイダーのWebhook設定に貼り付けます。
4. 受信機の状態を確認します。 受信機は接続済み（Receiver connected） はSSNが受信待機していることを示し、プロバイダー設定の検証済みを意味しません。解析済みで重複しないプロバイダーイベントが実行中のアプリに届くと、最後のイベント欄が更新されます。再起動するとリセットされます。
5. 使う項目： アラートのサンプルをプレビュー で別のサンプルページを開き、見た目を確認します。支払いの送信、合計の更新、Event Flowの実行、Webhook配信の検証は行いません。

これら3つの既存セッションURLエンドポイントは、URLを非公開に保つことで保護します。現在のSSN設定では、それらの署名シークレットは受け付けません。配信アラート用には使えますが、発送などの履行に必要な支払い証明にはなりません。Webhookアドレスを公開したり、視聴者向けQRコードの宛先に使ったりしないでください。

Fourthwall

1. Fourthwallで次を開きます： 設定 → 開発者向け → Webhook（Settings → For Developers → Webhooks）.
2. Webhookを作成し、SSNからコピーしたFourthwallのURLを貼り付けます。
3. 必要な対応イベントを選択します： ORDER_PLACED, GIFT_PURCHASE, DONATION および SUBSCRIPTION_PURCHASED.
4. Webhookを保存し、SSNを起動したままにします。

注文は購入、商品のギフトはギフト、新規サブスクリプションはメンバーシップとして表示されます。互換性のため、通常のFourthwall注文には従来の寄付額も含まれます。ギフトカード利用の注文では、前払い金額を二重に加算しません。テストと明示されたイベントは除外します。

FourthwallのWebhookドキュメント · 購入のサンプルをプレビュー

Ko-fi

1. 開く項目： Ko-fi Webhooks.
2. SSNからコピーしたKo-fi URLを次に貼り付けます： Webhook URLを設定して、保存・更新します。
3. SSNを起動したままにしてください。公開の投げ銭、メンバーシップの支払い、ショップの注文、コミッションは同じ接続を使います。

非公開の支払いは除外します。メンバーシップの支払いはメンバーシップ活動として、ショップ注文とコミッションは購入として表示され、寄付合計には加算しません。Ko-fiはこのWebhook経由ではメンバーシップの解約通知を提供しません。

テスト： まずSSNの独立したサンプルプレビューを使ってください。Ko-fiのサンプル支払いは実際の支払いに似ており、有効な受信機へ送るとアラート、合計、アクションが実行される場合があります。有料報酬が有効なセッションでは、プロバイダーのテストを使わないでください。

Ko-fiのWebhookドキュメント · サポートのサンプルをプレビュー

Buy Me a Coffee

1. 開く項目： 連携（Integrations） をクリエイターダッシュボードで開き、次を選びます： 新しいWebhook（New webhook）.
2. 名前を付け、SSNのBuy Me a Coffee URLをエンドポイントとして貼り付けます。
3. 選択する項目： donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created および membership.started を必要に応じて使います。
4. 保存し、配信を有効にしたままにします。失敗の調査にはプロバイダーのイベント配信履歴を使ってください。

ショップやコミッションの注文は購入です。ウィッシュリストへの支払いはギフトへの支援です。メンバーシップの開始は加入のお知らせであり、別の確定済み請求ではありません。非公開メモは非公開のまま、匿名の支援者は匿名のまま扱います。ダッシュボードのテストで次の印があるものは live_mode: false 有料アラートを出さずに除外します。返金やライフサイクルの更新は、支払いを作成したり既存の合計を取り消したりしません。

Buy Me a CoffeeのWebhookドキュメント · 支援のサンプルをプレビュー

Fourthwallの商品をインポート

1. Fourthwallの次の場所で： 設定 → 開発者向け（Settings → For Developers）で、次を作成します： Storefrontトークン。公開カタログへのアクセスには、管理用APIキーではなくStorefrontトークンを使ってください。
2. SSNで次を開きます： 商品とサポートのリンク → 商品とリンクを設定 → Fourthwallの商品をインポート（Products & support links → Set up products and links → Import a Fourthwall product）.
3. 公開商品URLとトークンを貼り付け、次をクリックします： 商品情報を読み込む（Load product details）.
4. 読み込まれた名前、画像、価格、公開URLを確認します。独自ドメインの場合も含め、URLがトークンと同じショップのものであることを確認してください。照会するショップのカタログはトークンで決まります。
5. 視聴者が行うことに合わせ、Shop、Gift、Support、Joinを選びます。クリックする項目： 商品またはリンクを追加（Add product or link）でProducts & support linksを有効にし、次に 設定を保存（Save setup）.

FourthwallのStorefront APIで、販売中の公開商品を1件ずつ取り込みます。トークンはそのリクエストだけに使い、処理後に消去し、保存したりオーバーレイへ送ったりしません。バリエーションごとの異なる価格やセット価格は、決済額が固定であるかのように見せないため空欄にします。インポートはその時点の情報であり、価格、在庫、画像は自動更新しません。変わったら再インポートまたは編集してください。カタログには最大20件まで登録でき、再度追加すると別の項目が作成されます。

Storefrontトークンを作成する · Fourthwallの商品欄

商品・公開リンク・QRコードを表示する

Shopify、Tiltify、Patreonなど、任意のサイトの公開商品リンクや支援リンクを手動で入力することもできます。画像URLと任意の価格を追加し、用途を選んでカタログを有効にし、保存してください。リンクを追加しても支払いフィードは接続されません。

1. 選ぶ項目： 商品とサポートのリンク（Products & support links） ／選択欄： 対象のオーバーレイリンク：.
2. 開く項目： オーバーレイリンクの設定。Product showcase、Support card、Activity alerts、または統合表示を選びます。
3. クリックする項目： OBSリンクをコピー をコピーし、OBSのブラウザソースに貼り付けます。まず800 × 600で試してください。商品紹介とアクティビティを別のレイヤーにする場合は、表示ごとにソースを作成します。
4. Display optionsで最初の商品を固定するか、商品を順に切り替えます。QRコードを有効にすると、視聴者が公開ページを読み取れます。使う項目： 公開リンクをコピー を項目の横でクリックすると、そのクリック可能なアドレスを自分でチャットに共有できます。

ショーケースには商品画像があれば表示しますが、小型のサポートカードでは非表示です。アクティビティアラートは独立して動作し、関係のないローテーション商品のQRコードは付けません。公開リンクは読みやすくし、完成したOBSレイアウトを見ながらスマートフォンでQRコードをテストしてください。OBSリンクの拡大率を変えたり、余白を狭く切り取りすぎたりすると読み取りにくくなります。

Multi-Alertsやアクティビティフィードには、同じSSNセッションの既存オーバーレイリンクを使います。これらの既存アクティビティオーバーレイでは、商品カタログの有効化は不要です。汎用のMonetizationアクティビティ表示では、カタログを有効にする必要があります。Event Flowでは、次の値を持つ行のトリガーは引き続きDonationです： hasDonation。購入やギフトの完了にはEvent Typeを使います。参照先： イベントの対応表.

何も表示されない場合

• 受信機がオフの場合： 拡張機能のリモートAPI制御を有効にしてください。他のAPIスイッチは別の用途です。
• 未接続の場合： SSNをオンにし、ネットワーク接続を確認してください。この状態は共通の受信機接続を示し、プロバイダーのダッシュボードにある配信状態とは異なります。
• イベントが届かない場合： 選択したプロバイダー、非公開URL、プロバイダーの配信設定を確認してください。ローカルプレビューの成功で確認できるのは見た目だけです。
• イベントが除外された場合： テストと明示されたもの、非公開の支払い、未対応のイベント種類、不正な金額は除外します。状態欄に購入者の詳細は表示しません。
• イベントは届くのにオーバーレイに出ない場合： セッション・パスワード、ソースフィルター、イベントカテゴリ、SSNルール、OBSでの表示状態を確認してください。購入はサブスクリプションではなく、ほとんどの購入は寄付でもありません。
• 重複する場合： 同じ支払いを直接のプロバイダーと集約サービスの両方から取り込まないでください。再試行の重複除外にはプロバイダーの配信IDを使います。
• インポートに失敗した場合： 商品のスラッグとStorefrontトークンを確認し、商品が公開され、販売中であることを確認してください。手動入力も引き続き利用できます。

これはライブ配信のアクティビティ表示であり、注文台帳ではありません。支払い確認、返金、発送などの履行にはプロバイダーのダッシュボードを使ってください。 Shopifyには、専用の商品インポートと署名付き支払い済み注文の設定が追加されました。Tiltifyのキャンペーン活動とPatreonの有料メンバーシップは、今後の連携対象です。