adjust-icon

サーバー間 (S2S) API

Adjustのサーバー間APIを使用することで、アプリコードを変更することなくアプリをAdjustに連携できます。

認証

サーバー間(S2S)APIは認証にベアラートークンを使用します。ブロックリストAPIにリクエストを行う全てのリクエストには、Adjust APIトークンをAuthorizationヘッダーに含める必要があります。

自社でシングルサインオン(SSO)を有効にしている場合は、 Adjustの担当者またはsupport@adjust.comにお問い合わせください。APIトークンの取得方法についてサポートいたします。

SSO以外のアカウントの場合、APIガイドはユーザーの プロフィール に表示されます。トークンを確認するには、以下の手順に従ってください。

  1. アカウント(ユーザー)アイコンを選択します。
  2. アカウント設定(Account Settings) を選択します。
  3. マイプロフィール(My Profile) を選択します。
  4. APIトークンユーザー情報(User details) に表示されます。コピーボタンを選択して、トークンをクリップボードにコピーします。

Adjust APIトークンをリセットする

Adjust APIトークンはいつでもリセットできます。トークンをリセットすると、古いトークンは無効になります。Adjust APIトークンをリセットした場合、使用中の古いトークンを新しいトークンに置き換える必要があります。無効になったトークンを使用したリクエストは、Adjustによって拒否されます。

Adjust APIトークンをリセットする方法:

  1. アカウント(ユーザー)アイコンを選択します。
  2. アカウント設定(Account Settings) を選択します。
  3. マイプロフィール(My Profile) を選択します。
  4. APIトークンユーザー情報(User details) に表示されます。
  5. APIトークンをリセットする(Reset API token) を選択します。
  6. 表示されたモーダルにアカウントのパスワードを入力し、 リセット を選択してAPIトークンをリセットします。画面の右上に確認メッセージが表示されます。
  7. APIトークン の横にあるコピーボタンを選択して、トークンをクリップボードにコピーします。

S2Sエンドポイント

エンドポイント機能
https://s2s.adjust.com/eventアプリ内イベントをAdjustに通知
https://s2s.adjust.com/ad_revenue広告収益データをAdjustに通知
https://s2s.adjust.com/sessionセッションデータをAdjustに通知

デバイスID

S2Sイベントで受け付けるデバイスIDは以下のとおりです:

推奨されるID

名前
RawのIDFA(iOSのみ)idfa
RawのGoogle広告IDgps_adid
Amazon Fire広告IDfire_adid
Open Advertising ID(OAID、Huaweiのみ)oaid
Web ID(Adjust Web SDKで生成)web_uuid

バックアップID

名前
RawのIDFV(iOSのみ)idfv
Android ID(Androidのみ)android_id

イベント送信のレスポンス

正常に記録された全てのイベントは、 OKレスポンスを返します。

計測に失敗したイベントは、HTTPエラーコードとJSONメッセージを返します。

エラーレスポンス
{ "error": "Event request failed (${error_message})" }

エラーメッセージは、リクエストにどのような問題が発生したかを示します。以下の表からエラーを特定し、設定をご確認いただくか、support@adjust.comにお問い合わせください。

エラーコードエラーメッセージ理由
400Bad event stateリクエストの詳細が期待値と異なる場合に発生します。例:created atの時間がinstalled_atの時間より前である。
400Invalid app tokenアプリトークンが正しく設定されていません。
400Ignoring event, earlier unique event trackedユニークイベントがすでに記録されています。重複しているため、このイベントは記録されません。
400Invalid callback parametersコールバックパラメーターを抽出できませんでした。
400Invalid event tokenイベントトークンが存在しないか、正しく設定されていない、あるいはアプリトークンと一致しません。
400Invalid revenue無効な収益:金額が正しく設定されていないか、値が大き過ぎます(上限 = 100,000,000,000)。
401Failed to authorize request承認トークンが見つからない、あるいは一致しません。
403App is inactiveアプリがダッシュボードで無効化されました。
403Tracking disabledこのプラットフォームでは計測が有効化されていません。
403Event token blocklistedEvent token blocklisted
404App token not foundApp token not found
404Device not foundデバイスデータが見つかりません。
413Request size too largeリクエストが上限の1MBを超えています。
451Device is opted outDevice is opted out
500Internal error, contact support@adjust.comデバイスデータ更新時に発生した内部エラー。