adjust-icon

S2S(Server-to-server) 세션

세션은 Adjust에서의 모든 어트리뷰션과 측정의 기반입니다. 세션은 사용자가 백그라운드에서 앱의 사용을 재개하거나 앱을 실행할 때 발생합니다. 앱 내의 개별 사용자 세션 기록을 위해 S2S 세션 API를 사용하시기 바랍니다.

시작에 앞서

인증

S2S 보안을 설정하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다.

세션 기록

Adjust는 리소스를 저장하기 위해 세션을 그룹화합니다. Adjust 서버가 새로운 세션이 트리거된 것으로 간주하려면, 세션 간 최소 30분의 간격이 있어야 합니다.

엔드포인트
https://s2s.adjust.com/session

헤더

파라미터설명예시
Content-Type하드코드된 POST 페이로드의 유형.application/x-www-form-urlencoded
X-Adjust-Forwarded-For디바이스의 IP 주소180.220.253.39
AuthorizationBearer 토큰인 Adjust 인증 토큰.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
idfvRoku 벤더 ID, iOS에만 해당59E27F41-A86B-4560-B585-63161F871C4B
gps_adidGoogle Play 광고 ID. Goole Play Service 라이브러리가 추가된 경우에만 전송. Android에만 해당.6cf94580-46c2-490c-b882-2f6ae269b579
oaid공개 광고(익명) IDed799bac-2537-6122-377a-edebce5db5a5
imei국제 모바일 기기 식별코드(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사용자의 광고 추적 제한(LAT) 활성화 여부 표시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_version운영체제의 현재 버전.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 인코딩된 모델 IDMoto G (5) Plus, iPhone10,5
hardware_name디바이스 보드 설정N66AP
install_receipt앱 스토어의 암호화 서명된 설치 영수증, iOS만 해당Super long string representation of the receipt
ip_address디바이스의 IP 주소.
ip_address 파라미터는 IPv4 주소만 허용하며, IPv6은 현재 지원되지 않습니다.
ip_address=192.0.0.1

EU의 디지털 시장법(DMA)에 따라 Google Ads와 Google Marketing Platform은 API에 대한 Adjust의 어트리뷰션 요청을 수신하기 위해 명시적인 동의를 받아야 합니다.

Adjust는 S2S 세션 및 설치 요청에 대해 다음과 같은 Google DMA 파라미터를 지원합니다. Adjust는 요청 양식에 이러한 파라미터가 있을 것으로 예상합니다.

Google Ads를 사용하는 경우 ad_personalization 파라미터를 전송하고, Google Marketing Platform을 사용하는 경우 npa 파라미터를 전송해야 합니다.

Key설명
eea
  • 1: 사용자가 EEA 사용자이며, DMA가 적용됨
  • 0: 사용자가 EEA 사용자가 아니며, DMA가 적용되지 않음
사용자가 EEA(유럽경제지역) 거주자인지 여부와 이에 따라 DMA(디지털마케팅법)를 포함한 EU 규정이 해당 사용자와 전환에 적용되는지 여부를 Google에 알려줍니다.
ad_personalization
  • 1: 사용자가 동의함
  • 0: 사용자가 동의하지 않음
사용자가 앱을 설치한 후 Google Ads를 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다.
ad_user_data
  • 1: 사용자가 동의함
  • 0: 사용자가 동의하지 않음
사용자가 측정 목적의 개인 정보 공유에 동의했는지 여부를 Google에 알려줍니다.
해당 동의 정보는 광고주들이 Google Ads와 Google Marketing Platform UI에서 명시한 모든 Core Platform Services(CPS)에 적용됩니다.
npa
  • 1: 사용자가 동의함
  • 0: 사용자가 동의하지 않음
사용자가 앱을 설치한 후 Google Marketing Platform을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다.

예:

요청
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"]
}
}