Steamゲーム計測の設定

このガイドでは、Steamゲームアプリを設定し、安全なサーバー間(S2S)API連携を確立し、リンクを効果的に管理してアトリビューション計測を行う方法を説明します。ユーザーはSteamストアまたはカスタムストアを使用して、WindowsまたはMacOSのゲームをダウンロードできます。

Steamゲームの計測を設定するには、以下の手順に従ってください。

  1. AppViewで新しいアプリを設定
  2. AdjustのS2S APIを設定して、セッションの記録を開始
  3. Campaign Labでリンクを設定

Steamアプリの設定

PCアプリの追加および設定を開始するには、以下の手順に従ってください。

  1. AppView​ で 全てのアプリ(All apps)​ を選択します。

  2. 新規アプリの追加 (NEW APP)​ を選択します。

  3. アプリの詳細を入力してください(Enter your app details)​ でアプリ名を入力し、レポート通貨を選択し、ゲームが次の要件に準拠する必要があるかどうかを選択します。

    • COPPAコンプライアンス​ 。米国の企業のみが対象です。COPPAの準拠に関する詳細はこちらをご覧ください。
    • Google DMA​ 。欧州経済領域(EEA)外にユーザーベースを持つアプリのみに適用されます。Google DMAの詳細はこちらをご覧ください。
  4. アプリの追加(Add App)​ を選択します。

  5. プラットフォームを追加(Add platform)​ を選択して、ゲームにプラットフォームを追加します。

    1. PC​ > Steam​ を選択します。WindowsおよびMac Steamストアで動作します。
    2. アプリID​ を入力するか、 アプリIDがまだありません(I don't have an App ID yet)​ を選択し、後で入力します。
    3. (オプション)ユーザーをSteamのアプリストアではなくカスタムウェブサイトにリダイレクトする場合は、 全てのクリックをカスタムURLにリダイレクト(Redirect all clicks to a custom URL)​ をONにして、カスタムURLを入力します。アプリIDがない場合は、このオプションをお勧めします。
    4. 保存(Save)​ を選択します。
  1. イベント(Events)​ タブで、アプリ内イベント名を追加して、ゲームのユーザーアクティビティを計測します。

  2. アトリビューション設定(Attribution settings)​ タブで、アトリビューションの設定(デバイスマッチング、確率的モデリング、テンポラリーアトリビューション)およびリアトリビューション設定を行います。

    • クリックとインプレッションの両方に対して確率的モデリングが有効化されていることを確認します。確率的モデリングのアトリビューション期間は24時間に設定することを推奨しますが、最大90日に設定することができます。90日間のアトリビューション期間は、PCおよびコンソールプラットフォームでのみ利用可能です。
  3. データ管理(Data management)​ タブでは、サーバーコールバックまたはクラウドストレージアップロードを設定して、ユーザーレベルのローデータを受信したり、テストコンソールでテストデバイスデータを確認することができます。

  4. S2S APIの設定でトークンが必要になるため、 プロテクション(Protection)​ タブでサーバー間(S2S)セキュリティ(S2S security)を設定します。

Adjust S2S APIの設定

Adjustのサーバー間APIを使用してアプリをAdjustに連携することで、アプリコードを変更することなくユーザーのセッションとイベントの計測を開始できます。

次のsessionエンドポイントを使用して、設定プロセスを続行してください。

事前準備

Adjustサーバーは、システムの悪用や過負荷を防ぐために厳格な一貫性チェックを実施します。S2Sアトリビューションは、Adjust SDKと組み合わせて使用できない限定的な連携です。

認証

サーバー間(S2S)セキュリティを設定して、サーバー間 (S2S) セッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjust管理画面で生成されたトークンが付与されている必要があります。トークンが付与されていないリクエストや、不正なトークンが付与されているリクエストは、サーバーによって拒否されます。

エンドポイント

sessionエンドポイントにより、ユーザーがゲームを起動した際にセッションを記録することができます。セッションがトリガーされるのは、ユーザーがバックグラウンドからゲームを再開したとき、またはゲームを開始したときです。例えば、ゲームの実行中に別のアプリを開いたときや、前回のゲーム終了後にゲームを開始したときが該当します。リソースの不必要な使用を防ぐため、Adjustサーバーは30分ごとに新しいセッションを受け付けます。

https://s2s.adjust.com/session

POSTヘッダー

認証​ :Adjust APIをコールするときは、認証方式をBearerとして設定して、Adjust認証トークンの値を送信します。

例:Bearer authentication_token

POSTペイロード

注意:

*​ でマークされたパラメーターは必須です。

パラメーターデータタイプ入力する値説明
s2s*文字列クエリサーバー間パラメーター:Adjustサーバーがサーバー側のアクティビティを認識することを許可します。常に1として送信される必要があります。
app_token*文字列クエリアプリ固有の認証トークン
os_name*文字列クエリアプリのOSに応じて、利用可能なパラメーターのいずれかを使用します:
  • windows 
  • macos
  • Steamos
ip_address*文字列クエリデバイス IPアドレス
created_at*Timestampクエリタイムゾーンを含むパッケージが作成された時点のローカルデバイスのタイムスタンプ
external_device_id*文字列クエリ一意のuser_id、例:ユーザーのaccount_idまたは暗号化されたメールアドレス
ヒント:

external_device_idパラメーターを使用して、ユーザーのsteam_idをAdjustにパスすることができます。

リクエストの例

cURL
curl -X 'POST' -d 's2s=1&app_token=a1234b2x3a4o&ip_address=0.0.0.0&created_at=2018-03-23T09:46:47.288Z-0400&sent_at=2018-03-23T09:46:47.288Z-0400&external_device_id=099aa0bc' -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' -H 'User-Agent: Adjust Streaming Job (akka-http)' 'https://s2s.adjust.com/session'

サーバー間(S2S)APIを使用してイベントを記録する方法については、サーバー間イベントをご覧ください。

リンクを設定する

アプリのサーバーとAdjustの間でS2S API連携を設定してテストしたら、キャンペーンを実施しているアドネットワークにAdjustを連携する必要があります。

リンクを使用すると、ユーザーが他のデバイスで広告と関わった際のアトリビューションを記録できます。例えば、携帯電話やコネクテッドTVで広告を視聴し、その後、PCでゲームをインストールする場合などです。Webキャンペーンに使用されるネットワーク例:

Campaign Labで、以下の設定手順に従ってください。

  1. Campaign Lab​ にて、 パートナー(Partner)​ を選択します。

  2. 新規パートナー(New partner)​ を選択します。

  3. パートナーの選択(Partner selection)​ 画面で、設定するアドネットワークを選択します。

  4. アプリの選択(App selection)​ 画面で、リンクを作成したいアプリを選択します。

  5. (オプション) データ共有(Data sharing)​ 画面で、ネットワークとAdjustの連携を設定し、データ共有オプションを選択します。

  6. リンク構造(Link structure)​ 画面で、ネットワークから提供されたデフォルトのリンク構造パラメーターを確認し、必要に応じて値を更新します。

  7. (オプション) ユーザーの遷移先(User destinations)​ 画面では、ディープリンクを設定したり、リンクにリダイレクトやフォールバックを追加したりできます。

    • ユーザーを特定のゲームストアにリダイレクトしたい場合は、追加のリダイレクトパラメーターとしてURLを含めてください。
  8. (オプション) アトリビューション設定(Attribution settings)​ 画面では、新規または既存ユーザーに対するアトリビューション設定をカスタマイズできます。これらの設定は、クリックとインプレッションで利用いただけます。このステップを省略した場合は、アプリ設定を行なった際に設定した内容が適用されます。

    • クリックとインプレッションの両方に対して確率的モデリングが有効化されていることを確認します。確率的モデリングのアトリビューション期間は24時間に設定することを推奨しますが、最大90日に設定することができます。90日間のアトリビューション期間は、PCおよびコンソールプラットフォームでのみ利用可能です。
  9. 設定のレビュー(Setup review)​ 画面で内容を確認し、必要に応じて変更してください。

  10. リンクの作成(Create link)​ を選択して、クリックURL、インプレッションURL、QRコード、リンクトークンを作成します。データ共有を設定済みの場合は、これが有効化されます。