Promote a Build to Steam on Windows

Last updated on July 20, 2026

適用対象: Windows 版 ADT Hub

Overview​

「Promote to Steam」アクションを使用して、ダウンロード済みのビルドを ADT Hub から Windows 上の Steam プレリリースブランチにプロモートします。このガイドを完了すると、ビルドが Steam に登録され、プロモーションの記録が ADT の Promotions メニューでチーム全体に表示されるようになります。

Prerequisites​

プロモーションをトリガーする前に、以下のすべてを確認してください。

  • ADT Hub がインストールされ、実行されている（Windows マシン上）
  • SteamCMD がインストールされている（Windows マシン上）で、そのパスが ADT Hub Settings → Integrations → SteamCMD に設定されている（緑色の Ready インジケーターが表示される）— まだ完了していない場合は ADT で Steam インテグレーションをセットアップする を参照してください
  • 対象のビルドがローカルマシンにダウンロードされている（ADT Hub 経由）— Hub は ADT のクラウドストレージからではなく、ローカルディスクからプロモートします。ビルドがダウンロードされていない場合は、続行する前に Hub からダウンロードしてください。
  • Steam ボットの認証情報が接続されている（ADT Web → Namespace Settings → Steam Integration で、緑色の Connected ステータスが表示される）— このセットアップはスタジオ管理者が完了する必要があります
  • Game Settings が構成されている（ADT Web → Game Settings → Steam）— App ID、depot マッピング、およびプロモートしたいトラックのブランチマッピングがすべて保存されている必要があります

セットアップが完了しているか不明な場合は、ADT で Steam インテグレーションをセットアップする を参照してください。

Steps​

ステップ 1: 対象のビルドをダウンロードする（まだ行っていない場合）​

ADT Hub を開き、プロモートしたいビルドを含むチャンネルとトラックに移動します。ビルドがまだマシンにダウンロードされていない場合は、トラックカードまたはビルドカードの Download をクリックします。続行する前に、ダウンロードが完了するのを待ちます。

Hub はプロモーションの前提条件の一部としてローカルコピーの有無を確認します。ビルドがディスク上にない場合、Hub はプロモーションをブロックし、ダウンロードアクションを表示します。

ステップ 2: エントリーポイントを選ぶ​

Hub には、プロモーションを開始できる場所が 3 か所あります。現在のワークフローに合ったものを使用してください。

オプション A — Tracks タブから（最速の経路）

  1. Hub で、プロモートしたいトラックを含むチャンネルに移動します。
  2. Tracks タブをクリックします。
  3. トラックカードで、⋯ コンテキストメニューをクリックします。
  4. Build サブメニューを開きます。
  5. Promote to Steam を選択します。

Hub は、そのトラックのヘッドビルドをプロモーションフォームに自動的にプリフィルします。

オプション B — Versions メニューから

  1. Hub で、ゲームに移動し、左メニューの Versions をクリックします。
  2. バージョンの行をクリックして、そのビルドカードを展開します。
  3. プロモートしたい特定のビルドカードで、⋯ コンテキストメニューをクリックします。
  4. Promote to Steam を選択します。

Hub は、ビルドカードのコンテキストからバージョンと特定のビルドの両方をプリフィルします。

オプション C — Promotions メニューから

  1. Hub で、ゲームに移動し、左メニューの Promotions をクリックします。
  2. Promotions メニューの右上の領域で Promote to Steam をクリックします。
  3. フォームのステップ 1 で、ドロップダウンからバージョンを選択し、次に特定のビルドを選択します。

このオプションは、単発のプロモーションや、トラックに直接紐付いていないビルドをプロモートしたい場合に使用します。

ステップ 3: 前提条件のチェックリストを確認する​

プロモーションフォームを開く前に、Hub はすべての前提条件を検証します。不足しているものがある場合、Hub は何が不足しているかを正確に示すチェックリストを、各項目を解決するためのリンクとともに表示します。すべての前提条件が満たされるまで、フォームは開きません。

Hub が確認する一般的な前提条件:

前提条件修正する場所
SteamCMD のパスが未設定または無効Hub Settings → Integrations → SteamCMD
ビルドがローカルマシンにダウンロードされていないトラックカードまたはビルドカードからビルドをダウンロードする
Steam の認証情報が構成されていないADT Web → Namespace Settings → Steam Integration（スタジオ管理者）
App ID または depot が構成されていないADT Web → Game Settings → Steam（スタジオ管理者）
このトラックにブランチマッピングが構成されていないADT Web → Game Settings → Steam（スタジオ管理者）

選択したトラックに depot またはブランチマッピングが構成されていない場合、Hub は不足しているものを一覧表示し、Game Settings → Steam へのリンクを含む「not configured」モーダルを開きます。不足している設定が追加されるまで、プロモーションを開始することはできません。

ステップ 4: 古いビルドの警告に対応する（表示された場合）​

ローカルマシン上のビルドがトラック内の最新ビルドでない場合、Hub はフォームを開く前に警告ダイアログを表示します。

"Build #4818 is on your machine, but #4821 is the latest in this track. Promote #4818 anyway, or download #4821 first?"

  • 古いビルドをプロモートするには（例えば意図的なロールバックのため）、Promote #4818 をクリックします。
  • 先に最新ビルドをダウンロードするには、Cancel をクリックして Hub から最新ビルドをダウンロードし、このステップに戻ります。

ステップ 5: ステップ 1 を完了する — Build and Target​

プロモーション確認フォームが開きます。ステップ 1 のフィールドを確認します。

フィールド動作
Buildエントリーポイントのコンテキストからプリフィルされる（オプション A と B では読み取り専用、オプション C では選択可能）
App ID読み取り専用 — Game Settings から
Depot読み取り専用（ロックアイコン）— Game Settings から。変更するには Game Settings を更新する
Steam Branch編集可能なドロップダウン — 既定ではトラックのマッピングされたブランチが設定される。プロモーションごとに変更可能

この特定のプロモーションで別の Steam ブランチを対象にするには、Steam Branch ドロップダウンをクリックして、必要なブランチを選択します。Game Settings に構成されているブランチのみが表示されます。

Next をクリックしてステップ 2 に進みます。

ステップ 6: ステップ 2 を完了する — Details​

オプションのフィールドを確認して編集します。

フィールド既定値編集できますか?
Build descriptionゲームの説明テンプレートからプリフィルされるはい
Internal notes空はい — ADT の監査ログにのみ保存され、Steam には送信されません
File exclusionsGame Settings の既定値からプリフィルされる（例: *.pdb, *.log, .DS_Store）はい — ここで編集しても、保存された Game Settings の既定値は変更されません
Build sizeADT でのビルドアーティファクトのおおよその合計サイズとして表示される（例: ~6.3 GB）いいえ — 情報提供のみ

ビルドサイズのフィールドは、プロモートを確定する前にアップロードにどれくらいの時間がかかるかを予測するのに役立ちます。

Next をクリックしてステップ 3 に進みます。

ステップ 7: ステップ 3 を完了する — Review and Confirm​

ステップ 3 には、ステップ 1 と 2 のすべてのフィールドの概要が表示されます。送信する前に確認してください。

変更が必要な場合は、Back をクリックして前のステップに戻ります。以前に入力したすべての値は保持されます。

すべてが正しく見えたら、Promote to Steam をクリックします。フォームは、ビルド名を表示する「Promotion queued」成功状態に遷移します。View in Promotions menu をクリックして Promotions メニューに移動し、進行状況を監視します。

ステップ 8: プロモーションを監視する​

Promotions メニューで、プロモーションの行を見つけます。プロモーションが In Progress の間:

  • 行には青色のステータスインジケーターとインラインの進行状況バーが表示されます。
  • 行をクリックすると、ライブ更新されるログとタイムラインを表示するインラインの詳細ドロワーが展開されます。
  • ログは SteamCMD の出力をリアルタイムでストリーミングします — 実行中の各アップロードフェーズを見ることができます。

アップロードは、ADT Hub がマシン上で実行されている限り継続します。Hub を最小化またはバックグラウンドにしても、アップロードは継続します。Hub が強制終了された場合、次回起動時にプロモーションは Failed または Interrupted としてマークされ、再試行オプションが表示されます。

ステップ 9: 結果を確認する​

アップロードが完了すると、Hub は SteamCMD ログを解析して Steam BuildID を取得します。

プロモーションの行は、次のいずれかの最終状態に更新されます。

ステータス意味次のアクション
Succeeded（緑）SteamCMD が正常に完了 — Steam BuildID がドロワーに表示される（ログから解析できなかった場合は「—」）アクションは不要。BuildID が「—」と表示される場合は、Steamworks パートナーポータルで確認する
Failed（赤）アップロードが失敗 — 理由がドロワーにわかりやすい言葉で表示される問題を修正し（下記のトラブルシューティングを参照）、ドロワーで Retry promotion をクリックする

ステータスが Succeeded または Failed に変わると、アプリ内プッシュ通知も届きます。

Validation​

プロモーションが成功したことを確認するには:

  1. ADT の Promotions メニューで、プロモーションの行に Succeeded（緑）ステータスが表示されていることを確認します。
  2. 行をクリックして詳細ドロワーを展開します。Steam BuildID フィールドを確認します — ログから BuildID が解析された場合は数値の ID が表示され、そうでない場合は「—」が表示されます。
  3. Steamworks パートナーポータルで、アプリの Builds セクションに移動し、新しい BuildID が対象ブランチ名とともにリストに表示されていることを確認します。

Troubleshooting​

トラックカードの Build サブメニューに「Promote to Steam」が表示されない トラックのプラットフォームが対象外である（コンソール、モバイル、Windows Server のトラックには「Promote to Steam」がまったく表示されません）か、前提条件のチェックリストに未解決の項目があります。⋯ メニュー → Build サブメニューを開いて項目がないことを確認し、代わりに Promotions メニューからプロモーションを試みて前提条件のチェックリストを確認してください。

フォームを開く前に Hub が前提条件のチェックリストを表示する 1 つ以上の前提条件が満たされていません。チェックリストは不足している各項目を特定し、解決できる場所へのリンクを表示します。一般的な原因: Hub Settings で SteamCMD のパスが設定されていない、ビルドがローカルにダウンロードされていない、または Game Settings がスタジオ管理者によってまだ構成されていない。

アップロードが開始される前に Hub が Steam Guard コードを要求する これは想定される動作です。ボットアカウントの Steam Mobile Authenticator が入っている端末で Steam Mobile App を開き、現在の 6 桁のコードを入力します。(Steam Mobile App では: フッターメニューの Steam Guard アイコンをタップ → 歯車(設定) アイコンをタップ → Get Steam Guard Code。) コードは一度だけ使用され、保存されることはありません。メールベースの Steam Guard はここでは機能しません — Hub は Steam にサインインする前にコードを要求するため、メールは送信されません。入力したコードが拒否された場合は、同じドロワーで Retry をクリックし、新しいコードを入力します — コードは約 30 秒ごとに更新されるため、表示されている最新のものを使用してください。

プロモーションが「Steam credentials are invalid」で失敗する ADT に保存されているボットアカウントのユーザー名またはパスワードが正しくないか、アカウントのパスワードが変更されています。スタジオ管理者が ADT Web → Namespace Settings → Steam Integration で認証情報を更新する必要があります。更新後、失敗したプロモーションのドロワーで Retry promotion をクリックします。ボットアカウントが Steam モバイル認証システムを使用している場合、リージョンの不一致が原因である可能性があります — 解決手順については、セットアップガイドの 認証情報の検証がリージョンまたは位置情報のエラーで失敗する を参照してください。

プロモーションが「The upload was interrupted」で失敗する アップロード中に ADT Hub が閉じられたか、マシンのネットワーク接続が失われました。ドロワーで Retry promotion をクリックして、アップロードを最初からやり直します。

プロモーションが「Account does not have permissions for this app」で失敗する Steam ボットアカウントの Steamworks 権限が変更されたか、Game Settings の App ID がボットアカウントがアクセスできるアプリと一致していません。スタジオ管理者が Steamworks パートナーポータルでボットアカウントの権限を確認する必要があります。

プロモーションが Steam のレート制限エラーで失敗する Steam のコンテンツサーバーが、このアカウントからのアップロードを一時的にレート制限しています。ドロワーのエラーメッセージには推奨される待機時間が含まれています。推奨される期間だけ待ってから、Retry promotion をクリックします。

小さなビルドでプロモーションが 60 分以上「In Progress」のまま止まっている ドロワーのライブログで、認証プロンプトや待機状態を示す行がないか確認します。Hub が SteamCMD への接続を失った場合は、Hub を閉じ（プロモーションが Failed としてマークされます）、再試行します。問題が再発する場合は、スタジオ管理者に連絡して、Namespace Settings で認証情報の状態を確認してもらいます。

プロモーションが「Succeeded」と表示されるが、Steam BuildID フィールドに「—」が表示される SteamCMD は正常に完了しましたが、ログ出力から BuildID を解析できませんでした。ビルドはアップロードされています — Steamworks パートナーポータルでアプリの Builds セクションに移動して BuildID を見つけ、対象ブランチに登録されていることを確認してください。

Next Steps​

に最終更新
On this page