adjust-icon

S2S(Server-to-server) 세션

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

시작에 앞서 {#before-you-begin}

인증

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

세션 기록 {#record-sessions}

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 광고 식별자. 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을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다.

예 {#example}

요청
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=roku-os&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"]
}
}