Steam

FirstLookはSteamworks（Steam Publisher アカウント）との深い統合を提供しており、非公開のプレイテストやSteam Storeに表示されていないゲームを含む、すべてのゲームのプレイ時間を追跡できます。さらに、プレイテスターのウィッシュリストおよび所有状況も追跡します。

SteamworksをFirstLookと連携する

この連携を有効にするには、Steam Publisher WebAPI KeyをFirstLookと共有する必要があります。このキーはSteam Web APIへのアクセスと必要な情報の取得に使用されます。安全に保存され、プレイ時間データの取得にのみ使用されます。対象となるエンドポイントとデータは以下のとおりです：

• Player Ownership and Playtime – プレイヤーがゲームを所有しているかどうか、またプレイ時間を確認します。
• List of App IDs and Builds – Steam Publisher アカウント内のApp IDとビルドの一覧を取得し、追跡に使用する正しいものを選択できます。

キーを保存すると、Steam AppのOwnershipも検証されます。これはplayer.ggにゲームを掲載するために必要です。

Publisher Web API Keyの詳細については、公式Steamworksドキュメントをご参照ください。

WebAPI Keyの作成方法

1. Steamworks Partner Portalにサインインします。
2. 「Users & Permissions > Manage Groups」に移動します。
3. 「Create New Group」をクリックし、わかりやすいグループ名を入力します（例：「FirstLook WebAPI」）。
4. 新しいグループページで「Add Application」を使用してゲームを追加します。
5. オートコンプリートフィールドにゲームのメインタイトルを入力し、「Include child apps (DLC, demos, tools) when adding the parent app」チェックボックスが選択されていることを確認します。
6. サイドバーの「Create WebAPI Key」をクリックします。
7. 「Manage WebAPI Key」タブで、「Key Permissions」の下にGeneralにチェックが入っていることを確認します。
8. 下のボックスに表示されたキーをコピーします。

これで、FirstLookのSteam Integration Settingsにキーを貼り付け、「Save」をクリックできます。

ストアページの掲載とウィッシュリストの追跡

SteamworksをFirstLookと連携したら、ドロップダウンからApp IDをストアページとして選択できます。ストアページのプロモーションやウィッシュリストの収集を行う際に、このApp IDが使用されます。

ストアApp IDを手動で入力する場合

WebAPI Keyをまだ追加していない場合は、ストアApp IDを手動で入力できます。これにより、Steam Storeページが公開されているゲームに限定的なウィッシュリスト追跡が追加されます。通常、プレイテストはプレイヤーのプロフィールに表示されず、正確に追跡することができません。より正確な追跡のために、WebAPI Keyの使用を推奨します。

ウィッシュリスト分析（Financial API Key）

SteamworksのFinancial API Keyを使用すると、FirstLookはSteamの公式ウィッシュリストレポートからアプリの日次ウィッシュリストパフォーマンス（新規ウィッシュリスト、削除、購入、累計）を追跡します。データはSteam AnalyticsページのSteam Wishlists グラフに表示されます。

Financial API Keyは、Financial権限を持つ別のPublisher WebAPI Keyです。安全に保存され、ウィッシュリストのレポート（SteamのGetAppWishlistReportingエンドポイント）にのみ使用されます。このエンドポイントはアプリの日次集計ウィッシュリストアクションを返し、プレイヤー個人の情報は含まれません。

要件

• 検証済みのSteam Store App ID。ストアApp IDを設定（上記参照）し、WebAPI Keyを保存すると、App IDが自動的に検証されます。
• Steamworksアカウントでの財務データへのアクセス権限（Financial権限を持つキーを作成するために必要）。

Financial API Keyの作成方法

手順は上記のWebAPI Keyの作成とほぼ同じです。参考スクリーンショットはそちらのセクションをご参照ください。

1. Steamworks Partner Portalにサインインします。
2. 「Users & Permissions > Manage Groups」に移動します。
3. FirstLook WebAPI Key用に作成したグループを開くか、新しいグループ（例：「FirstLook Financial」）を作成してゲームを追加します。手順は上記のWebAPI Keyと同様です。
4. サイドバーの「Create WebAPI Key」をクリックします。
5. 「Manage WebAPI Key」タブで、「Key Permissions」の下にFinancialにチェックが入っていることを確認します。
6. 下のボックスに表示されたキーをコピーします。

FirstLookのSteam Integration Settingsの「Financial API Key」フィールドにキーを貼り付け、「Save」をクリックします。

保存時、FirstLookはストアApp IDのウィッシュリストレポートをリクエストしてキーを検証します。次の2つのエラーが発生する場合があります：

• “Invalid Steam Financial API Key” – Steamがキーを拒否しました。入力ミスがないか確認し、「Key Permissions」の下にFinancialがチェックされていることを確認してください。
• “The Financial API Key does not have access to this game’s Steam app” – キー自体は有効ですが、そのキーが属するグループがストアApp IDへのアクセス権を持っていません。Steamworksポータルでキーのグループにゲームを追加してください。

保存が完了すると、FirstLookはSteamがデータを持つ最も古い日付まで遡ってウィッシュリスト履歴をバックフィルし、その後は1日1回数値を更新します。

インサイト

収集されるデータには、公開プロフィールのウィッシュリスト、すべてのプレイテスターのプレイ時間データ、およびFinancial API Keyが追加された場合のアプリの日次ウィッシュリスト合計が含まれます。