コンテンツにスキップ
FirstLook ドキュメント
Get Started

Twitch

エンドツーエンドのウォークスルーについては、Twitch ドロップからアクセスキーを付与するをご覧ください。

設定

Section titled “設定”

Twitch エンタイトルメント API を呼び出すために必要な設定です。

Client ID、Client Secret、Organization and Game ID フィールドが表示された Twitch Configuration タブ

  • Client ID - ドロップキャンペーンを所有する Twitch アプリケーションのクライアント ID。Twitch Developer Console のアプリ管理ページで確認できます。
  • Client Secret - 対応するシークレット。保存後はマスクされた状態で表示されます。ローテーションする場合は失効させてください。
  • Organization and Game ID - Twitch Developer Console にあるゲームのアナリティクスページまたはボックスアートページの URL を貼り付けてください。FirstLook が URL から両方の ID を読み取り、表示します。 
    https://dev.twitch.tv/org/<org-id>/console/games/<game-id>/analytics

リワードマッピング

Section titled “リワードマッピング”

各行は、1 つの Twitch リワード ID を Grant Type（そのリワードが受け取られた際に付与されるキーの種類）にマッピングします。

マッピングされたリワード ID とキーインベントリ数を表示する Grant Type ドロップダウンが表示された Reward Mapping セクション

  • リワード ID は Twitch から提供されており、Twitch Developer Console のリワード管理ページに一覧表示されています。
  • FirstLook がフルフィルメントを担当するリワード ID のみを追加してください。ゲームに設定されているその他のリワード ID はすべて無視されます。

同期コントロールと監視

Section titled “同期コントロールと監視”

Monitor Drops タブでは、Twitch との同期の開始・停止や、同期済みリワードの履歴を確認できます。

Start Syncing

  • Twitch EventSub の drop.entitlement.grant イベントをサブスクライブします。
  • 15 分ごとにバックグラウンド同期を実行し、受け取り済みのリワードを読み取り、キーを付与し、未処理の付与を再試行します。

Stop Syncing

  • EventSub サブスクリプションを削除し、バックグラウンド同期を停止します。

ステータステーブル

このテーブルには FirstLook が記録したすべてのドロップが表示されます。プレイヤー名、Drop Status、リワード ID でフィルタリングできます。

ドロップおよび付与ステータスとともに同期済みリワードを表示する Monitor Drops テーブル

  • Drop Status - Twitch 上のリワードの状態：Claimed（受け取り済み）または Fulfilled（フルフィルメント済み）。
  • Grant Status - キー付与のステータス：Pending（保留中）、Granted（付与済み）、または Player limit reached（プレイヤー上限到達）。