サーバー間(S2S)セッション セッションは、Adjustの全てのアトリビューションと計測の基となるものです。ユーザーがバックグラウンドからアプリの利用を再開した時、またはアプリを起動した時にセッションがトリガーされます。サーバー間(S2S)セッションAPIを使用してアプリ内の各ユーザーセッションを計測してください。
この機能をご利用いただくには、まずはじめにAdjustが機能を有効化する必要があります。担当のアカウントマネージャーまたはsupport@adjust.comにお問い合わせください。
サーバー間(S2S)セキュリティを設定 して、サーバー間 (S2S) セッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjust管理画面で生成されたトークンが付与されている必要があります。トークンが付与されていないリクエストや、不正なトークンが付与されているリクエストは、サーバーによって拒否されます。
Adjustはセッションをグループ化することでリソースを節約します。つまり、Adjustサーバーが新しいセッションをトリガーされたものとして受け取る前に、1つのセッション後に最低30分間の間隔がなければなりません。
https://s2s.adjust.com/session
要件
Content-Type
ハードコーディングされたPOSTペイロードのフォーマット application/x-www-form-urlencoded X-Adjust-Forwarded-For
デバイスのIPアドレス 180.220.253.39 Authorization
Adjust APIをコールするときは、認証方式をBearerとして設定して、Adjust認証トークンの値を送信します。 Bearer authentication_token
ペイロードに唯一必須のパラメータはs2s
です。パラメーターの一覧は、以下の表をご参照ください。
s2s
サーバー間(S2S)パラメーター:Adjustサーバーがサーバー側のアクティビティを認識することを許可します。 常に1として送信される必要があります。 1 app_token
アプリ固有の認証トークン pezwd5bre2xb VIDA
Vizio広告ID、Vizioのみ dca2365e-0d78-47c6-aaac-9567846c6c9e rida
Rokuの広告ID、Rokuのみ tifa
Tizen OS 広告識別子、Samsungのみ IDFA
iOS広告ID、iOSのみ 29DDE430-CE81-4F00-A50C-689595AAD142 idfv
iOSベンダーID、iOSのみ 59E27F41-A86B-4560-B585-63161F871C4B gps_adid
Google Play広告識別子、Google Play 開発者サービスライブラリが追加された場合にのみ送信されます。Androidのみ 6cf94580-46c2-490c-b882-2f6ae269b579 oaid
その他の広告(匿名)ID ed799bac-2537-6122-377a-edebce5db5a5 IMEI
国際移動体装置識別番号 490154203237518 android_id
Android ID、gps_adidがない場合にのみ送信されます。Androidのみ e11a8c233efb29f3 persistent_ios_uuid
ios_uuidと同様ですが、Keychainに保存されるため、再インストールされたアプリは同じ値を持ちます。iOSのみ 3b35fcfb-6115-4cff-830f-e32a248c487d app_version
このパラメーターはiOSのビルド番号、Androidの実際のアプリバージョンを表します。 1.0 app_version_short
リリース はiOSの実際のアプリバージョン番号を表します。iOSのみ1.0 session_count
現在のセッションを含む計測されたセッションの数 1 subsession_count
計測されたサブセッションの数。初めて計測されたセッション(インストール)はこのパラメーターを含みません。その後の全てのセッションは前回のセッションのサブセッションの数を含みます。 1 session_length
セッションの長さ(秒単位)。初めて計測されたセッション(インストール)はこのパラメーターを含みません。その後の全てのセッションは前回のセッションの長さを含みます。 123 time_spent
前回のセッション中のアプリ内でのアクティブな経過時間 123 tracking_enabled
ユーザーが追跡型広告制限を有効化しているかどうかを示します 1 bundle_id
バンドルID、iOSのみ com.adjust.example package_name
パッケージ名、Androidのみ com.adjust.example environment
“sandbox”(テスト用)または“production”(ライブトラフィック用) sandbox country
現地の国名コード de language
現地の言語コード en os_name
“ios”または“android”、単なる文字列 iOS os_version
OSの現在のバージョン 11.0 cpu_type
CPUのプロセッサーファミリー arm64-v8a created_at
タイムゾーンを含むパッケージが作成された時点のローカルデバイスのタイムスタンプ 2018-03-23T09:46:47.288Z-0400 sent_at
タイムゾーンを含むパッケージが送信された時点のローカルデバイスのタイムスタンプ 2018-03-23T09:47:47.288Z-0400" device_type
デバイスのモデル Phone (android), iphone device_name
モデルID 、要エンコードMoto G (5) Plus, iPhone10,5 hardware_name
デバイスボードの構成 N66AP install_receipt
暗号化され署名されたApp Storeからのインストール受領証 、iOSのみ受領証を表す非常に長い文字列 ip_address
デバイスのIPアドレス。 ip_address
パラメーターは、IPv4アドレスのみを受け入れます。現在、IPv6はサポートされていません。 ip_address=192.0.0.1
リクエストの例
curl -X 'POST' -d 'app_token=a1234b2x3a4o&app_version=Roku%2FDVP-10.5+%2810.5.0.0010%29&created_at_unix=1543915806015&environment=production&os_name=android&rida=099aa0bc-d123-4567-8999-a1b7c50767b1&s2s=1' -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' -H 'User-Agent: Adjust Streaming Job (akka-http)' 'https://s2s.adjust.com/session'
{
"Host": "s2s.adjust.com",
"Path": "/session",
"Method": "POST",
"ReceivedAt": "2022-01-01T17:00:01.030986068Z",
"Header": {
"Connection": [
"close"
],
"User-Agent": [
"Adjust Streaming Job (akka-http)"
],
"Authorization": [
"Bearer ADD_YOUR_AUTH_TOKEN_HERE"
],
"Content-Length": [
"0"
],
"X-Adjust-Forwarded-For": [
"71.142.112.183",
"34.221.136.124"
],
"X-Adjust-Forwarded-Proto": [
"https"
]
},
"Form": {
"s2s": [
"1"
],
"rida": [
"099aa0bc-d123-4567-8999-a1b7c50767b1"
],
"os_name": [
"android"
],
"app_token": [
"a1234b2x3a4o"
],
"app_version": [
"Roku/DVP-10.5 (10.5.0.0010)"
],
"environment": [
"production"
],
"created_at_unix": [
"1543915806015"
]
}
}