adjust-icon

サーバー間(S2S)セッション

セッションは、Adjustの全てのアトリビューションと計測の基となるものです。ユーザーがバックグラウンドからアプリの利用を再開した時、またはアプリを起動した時にセッションがトリガーされます。サーバー間(S2S)セッションAPIを使用して、アプリ内の各ユーザーセッションを記録してください。

事前準備

認証

サーバー間(S2S)セキュリティを設定して、S2Sセッションの計測を不正から守ります。そのためには、受信するリクエストごとに、Adjustダッシュボードで生成されたトークンが付与されている必要があります。トークンが付与されていないリクエスト、または不正なトークンが付与されたリクエストは、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
AuthorizationAdjust認証トークンをBearerトークンとして取得する。Bearer authentication_token

ペイロード

パラメーターの一覧は、以下の表をご参照ください。

パラメーター説明
s2s*サーバー間パラメーター:Adjustサーバーがサーバー側のアクティビティの認識を有効化。 常に1である必要があります。1
app_tokenアプリ固有の認証トークン。pezwd5bre2xb
vidaVizio広告ID、Vizioのみdca2365e-0d78-47c6-aaac-9567846c6c9e
ridaRokuの広告ID、Rokuのみ
tifaTizen OS 広告ID、Samsungのみ
idfaiOS広告ID、iOSのみ29DDE430-CE81-4F00-A50C-689595AAD142
idfviOSベンダーID、iOSのみ59E27F41-A86B-4560-B585-63161F871C4B
gps_adidGoogle Play広告ID、Google Play 開発者サービスライブラリが追加された場合にのみ送信される。Androidのみ6cf94580-46c2-490c-b882-2f6ae269b579
oaidOpen Advertising(匿名)IDed799bac-2537-6122-377a-edebce5db5a5
imei国際移動体装置識別番号490154203237518
android_idAndroid ID、 gps_adidがない場合にのみ送信される。Androidのみe11a8c233efb29f3
persistent_ios_uuidios_uuidと同様ですが、Keychainに保存されるため、再インストールされたアプリは同じ値を持ちます。iOSのみ3b35fcfb-6115-4cff-830f-e32a248c487d
app_versionこのパラメーターはiOSのビルド番号、Androidの実際のアプリバージョンを表します。1.0
app_version_shortiOSの実際のアプリバージョン番号を表します。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
environmentsandbox テストまたはproductionライブトラフィック。sandbox
country現地の国名コード。de
language現地の言語コード。en
os_nameios または androidios
os_versionOSの現在のバージョン。11.0
cpu_typeCPUのプロセッサーファミリー。arm64-v8a
created_atタイムゾーンを含むパッケージが作成された時点のローカルデバイスのタイムスタンプ。2024-03-23T09:46:47.288Z-0400
sent_atタイムゾーンを含むパッケージが送信された時点のローカルデバイスのタイムスタンプ。2024-03-23T09:47:47.288Z-0400
device_typeデバイスのモデル。Phone (android), iphone
device_nameURLエンコードされたモデルID。Moto G (5) Plus, iPhone10,5
hardware_nameデバイスボードの構成。N66AP
install_receiptApp Store、暗号化により署名されたインストールの受領証、iOSのみ。Super long string representation of the receipt
ip_addressデバイスのIPアドレス。
ip_addressパラメーターではIPv4アドレスのみを受け付けます。IPv6は現在サポートされていません。
ip_address=192.0.0.1

EUのデジタル市場法(DMA)に準拠するため、Google 広告およびGoogle マーケティング プラットフォームは、AdjustからAPIへのアトリビューションリクエストを受信することに明示的な同意を必要とします。

Adjustは、S2Sセッションとインストールリクエスト向けに、以下のGoogle DMAをサポートしています。Adjustは、パラメーターがリクエストフォームにあることを要件とします。

Google 広告を使用している場合はad_personalizationパラメーターを、Google マーケティング プラットフォームを使用している場合はnpaパラメーターを送信する必要があります。

鍵(Key)説明
eea
  • 1ユーザーはEEA内に在住であり、DMAが適用される
  • 0ユーザーはEEA内にいないためDMAは適用されない
Googleに、ユーザーの所在地がEEAであるかどうか、つまり、DMAを含む欧州の規制がこのユーザーとコンバージョンに適用されるかどうかを通知します。
ad_personalization
  • 1: ユーザー同意
  • 0: ユーザーが同意しなかった
アプリのインストール後、Google 広告でパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。
ad_user_data
  • 1: ユーザー同意
  • 0: ユーザーが同意しなかった
Googleに、ユーザーが個人データが計測目的で共有されることに同意したかどうかを通知します。
この同意は、Google 広告およびGoogle マーケティング プラットフォームのUIで指定した全てのコアプラットフォームサービスCPSの広告主に適用されます。
npa
  • 1: ユーザー同意
  • 0: ユーザーが同意しなかった
アプリのインストール後に、Google マーケティング プラットフォームを介してパーソナライズされた広告を配信することにユーザーが同意したかどうかを通知します。

リクエスト
curl -X "POST" \
-H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' \
-H 'User-Agent: Adjust Streaming Job (akka-http)' \
-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" \
"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"]
}
}