サーバー間（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 エンドポイントには、各リクエストで以下のパラメーターが必要です：

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

パラメーター	説明	例
`idfa` (iOS) や `gps_adid` (Android) などの広告ID	使用可能なKPIリストをご覧ください。	`idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E gps_adid=660e1d86-6796-463a-be86-897993136018`
`event_token`	ダッシュボードで取得できるAdjustイベントトークン	`event_token=f0ob4r`
`app_token`	ダッシュボードで取得できるAdjustアプリトークン	`app_token=4w565xzmb54d`
`s2s`	1に設定されたS2Sパラメーター	`s2s=1`

デバイスID

パラメーター	IDタイプ	形式
`android_id`	RawのAndroid ID	小文字、ハイフンなし
`android_id_lower_md5`	ハッシュ化されたAndroid ID	小文字、MD5
`android_id_lower_sha1`	ハッシュ化されたAndroid ID	小文字、SHA1
`android_id_upper_md5`	ハッシュ化されたAndroid ID	大文字、MD5
`android_id_upper_sha1`	ハッシュ化されたAndroid ID	大文字、SHA1
`idfv`	RawのIDFV	大文字、ハイフンあり
`imei`	Raw IMEI	ハイフンなし
`imei_lower_md5`	ハッシュ化されたIMEI	小文字、ハイフンなし
`meid`	Raw OAID	大文字、ハイフンなし
`win_naid`	RawのWindowsネットワークアダプターID	小文字、ハイフンあり
`win_hwid`	RawのWindowsストアハードウェアID	ハイフンなし

イベント送信に推奨されるその他のパラメーター

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

パラメーター	説明	例
`adid`	デバイスに関連付けられたAdjust ID。IDFAの情報がない場合、iOSでLATユーザーを識別するために使用できます。	`adid=18546f6171f67e29d1cb983322ad1329`
`ip_address`	デバイスのIPアドレス。イベントをサードパーティ（例：Google）と連携し、コールバックに位置関連情報（例：`city` 、 `postal_code`）を含めます。 `ip_address`パラメーターではIPv4アドレスのみを受け付けます。IPv6は現在サポートされていません。	`ip_address=192.0.0.1`
`created_at_unix` （推奨）または `created_at`	イベントが発生した日時。	`created_at_unix=1484085154` または `created_at=2017-01-02T15:04:05.000+0000`
`user_agent`	デバイスの`User-Agent` 。URLエンコードされている必要があります。	`user_agent=Mozilla%2F5.0%20%28iPhone%3B%20CPU%20iPhone%20OS%2016_6%20like%20Mac%20OS%20X%29%20AppleWebKit%2F605.1.15%20%28KHTML%2C%20like%20Gecko%29%20Version%2F16.5%20Mobile%2F15E148%20Safari%2F604.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収益イベントを記録するには、イベント送信に以下の収益パラメーターを追加します：

パラメーター	説明
revenue（収益）	完全な通貨単位での収益イベントの値 (149.99 = $149.99)。Adjustのサーバーは、このパラメーターの最小値を0.001としています。
currency	イベントに関連付けられた通貨コード。
environment	データを送信する環境：`environment=sandbox`または`environment=production` 。デフォルトの設定は`production`となっています。

例

1
curl "https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E&created_at=2017-01-02T15%3A04%3A05Z%2B0200&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&currency=EUR&revenue=123.4&environment=sandbox"

1
curl -X POST \
2
"https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E&created_at=2017-01-02T15%3A04%3A05Z%2B0200&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&currency=EUR&revenue=123.4&environment=sandbox"

1
curl -X POST \
2
-H "Content-Type: application/x-www-form-urlencoded" \
3
--data "s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=D2CADB5F-410F-4963-AC0C-2A78534BDF1E&created_at=2017-01-02T15%3A04%3A05Z%2B0200&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&partner_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D&currency=EUR&revenue=123.4&environment=sandbox" \
4
"https://s2s.adjust.com/event"