adjust-icon

サーバー間（S2S）イベント

サーバー間（S2S）イベントAPIを使用して、HTTPリクエストを使ってイベントデータをAdjustに送信してください。インストール、セッション、リアトリビューションを記録するにはAdjust SDK、 カスタム イベントの場合はS2S APIのみを使用して送信してください。

S2SイベントをiOS 14以降のアプリに設定している場合、Adjustはconversion valueをS2Sレスポンスとしてサーバーに送信します。その後、お客様のサーバー側でアプリ内のconversion valueを更新する必要があります。この仕組みの詳細については、iOS 14以降でのS2Sイベントのサポートを参照してください。

この記事では、S2Sイベントの記録の設定方法とトラブルシューティングを紹介します。

エンドポイント
https://s2s.adjust.com/event

S2Sイベントを送信する

/event エンドポイントは、サーバー間イベントの以下のリクエストを受け入れます：

  • URLパラメーターを含むGET。
  • URLパラメーターを含むPOST。
  • bodyパラメーターを含むPOST。Content-Type は application/x-www-form-urlencodedに設定する必要があります。

S2Sセキュリティの設定

S2Sセキュリティを設定してS2Sイベントのセキュリティを保証し、スプーフィングされたリクエストからアプリを保護します。そのためには、受信するリクエストごとに、Adjustダッシュボードで生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、Adjustのサーバーによって拒否されます。

設定するには、S2Sセキュリティに関する記事の手順に従ってください。

必須パラメーター

/event エンドポイントには、各リクエストで以下のパラメーターが必要です：

  1. idfa (iOS) や gps_adid (Android) などの広告ID。
  2. イベントトークン。
  3. アプリトークン。
  4. リクエストがサーバー間であることをエンドポイントに通知するためのハードコーディングされたs2s=1パラメーター。

イベントのアトリビューションを正確に行うために、イベントには以下のパラメーターを含めてください。

イベントのタイムスタンプ

イベントのタイムスタンプは、 created_at_unix パラメーターまたはcreated_atパラメーターを使用して指定できます。

  • created_at_unix：イベント送信時のUNIXタイムスタンプ。例：1484085154。
  • created_at：ISO 8601形式でURLエンコードされたタイムスタンプ。例： 2023-01-02T15%3A04%3A05.000%2B0000

以下の点を確認してください：

  • イベントは、リクエストのタイムスタンプに沿って、発生順にデバイスとイベントトークンごとに送信する必要があります。Adjustが受信したイベントのタイムスタンプが、記載されたデバイスとイベントに対して以前に受信したものよりも前のイベントを受信した場合、そのイベントは拒否されます。
  • 全てのイベントは58日以内に送信される必要があります。58日以上前のタイムスタンプを持つイベントは拒否されます。

カスタムデータを共有する

コールバックとパートナーパラメーターを使用して、カスタムイベントデータをAdjustに送信します。コールバックパラメーターはローデータエクスポートで利用でき、パートナーパラメーターはネットワークパートナーと共有されます。

リクエストにパラメーターを追加するには、以下のパラメーターを使用します：

  • callback_params： 文字列 のキーと値のペアを含む、URLエンコードされたJSONオブジェクト。
  • partner_params： 文字列 のキーと値のペアを含む、URLエンコードされたJSONオブジェクト。
エンコードされていない例
{
   "f0o": "bar",
   "bar": "baz"
}
エンコードの例
%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

ローデータエクスポートでコールバックパラメーターを受信するには、S2Sコールのcallback_paramsパラメーターにデータを追加します。

コールバックパラメータ
curl --location https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

イベント情報をネットワークパートナーに送信するには、S2Sコールのpartner_paramsパラメーターにデータを追加します。

パートナーパラメーター
curl --location https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

収益イベントを記録

S2S収益イベントを記録するには、イベント送信に以下の収益パラメーターを追加します：

例