フォーム連携ガイド

ゲームクリア時のURLに動的な変数（ユーザーIDやシナリオIDなど）を埋め込むことができます。これにより、外部フォーム（Googleフォームなど）にプレイヤーの情報を自動的に引き継ぎ、プレゼント応募やアンケートの集計を効率化できます。

利用可能な変数

URLの中に以下の文字列（プレースホルダー）を含めると、ゲームクリア時に自動的に実際の値に置き換わります。

変数名	説明	実際の値の例
{{userId}}	プレイヤーの固有ID（未ログインの場合はゲストID）	guest_12345, user_...
{{userEmail}}	プレイヤーのメールアドレス（ログイン時のみ）	example@test.com
{{userName}}	プレイヤーの表示名	山田 太郎
{{scenarioId}}	現在のシナリオID	tutorial_escape_01
{{endingId}}	到達したエンディングID（設定されている場合）	true_end
{{endingLabel}}	エンディングの表示名	トゥルーエンド

Googleフォームの設定手順

以下の手順で、Googleフォームでこれらの値を受け取る設定を行います。

1. フォームの作成

Googleフォームを新規作成し、受け取りたい情報（「ユーザーID」「シナリオID」など）に対応する「記述式（短文）」の質問項目を作成します。 ※これらの項目はユーザー編集不可にはできませんが、自動入力されることで入力の手間を省き、誤入力を防ぐことができます。

2. 事前入力したリンクの取得

1. フォーム編集画面右上の「︙（その他）」アイコンをクリックし、**「事前入力したリンクを取得」**を選択します。
2. プレビュー画面が表示されるので、各項目にダミーの値を入力します（例: USER_ID, SCENARIO_ID）。
3. **「リンクを取得」**ボタンをクリックし、URLをコピーします。

3. URLの調整

コピーしたURLは以下のようになっています。 https://docs.google.com/forms/d/e/.../viewform?entry.12345=USER_ID&entry.67890=SCENARIO_ID

このダミー部分を変数に置き換えます。 https://docs.google.com/forms/d/e/.../viewform?entry.12345={{userId}}&entry.67890={{scenarioId}}

4. シナリオYAMLへの記述

完成したURLを、シナリオYAMLの game_clear アクションに設定します。

game_clear:
  next_action: open_url
  url: "https://docs.google.com/forms/d/e/.../viewform?entry.12345={{userId}}&entry.67890={{scenarioId}}"

動作確認

実際にテストプレイを行い、ゲームクリア画面からリンクを開いてみてください。Googleフォームの各項目に、自分のユーザーIDやシナリオIDが自動的に入力されていれば成功です。