세션은 Adjust에서의 모든 어트리뷰션과 측정의 기반입니다. 세션은 사용자가 백그라운드에서 앱의 사용을 재개하거나 앱을 실행할 때 발생합니다. 앱 내의 개별 사용자 세션 기록을 위해 S2S 세션 API를 사용하시기 바랍니다.
시작에 앞서
인증
S2S 보안을 설정하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다.
세션 기록
Adjust는 리소스를 저장하기 위해 세션을 그룹화합니다. Adjust 서버가 새로운 세션이 트리거된 것으로 간주하려면, 세션 간 최소 30분의 간격이 있어야 합니다.
헤더
파라미터 | 설명 | 예시 |
---|---|---|
Content-Type | 하드코드된 POST 페이로드의 유형. | application/x-www-form-urlencoded |
X-Adjust-Forwarded-For | 디바이스의 IP 주소 | 180.220.253.39 |
Authorization | Bearer 토큰인 Adjust 인증 토큰. | Bearer authentication_token |
페이로드
아래의 표에서 파라미터 전체 목록을 확인하시기 바랍니다.
파라미터 | 설명 | 예시 |
---|---|---|
s2s * | 서버간 파라미터: Adjust 서버가 서버 측 활동을 인식하도록 허용. 항상 1 이어야 함. | 1 |
app_token | 앱의 고유한 인증 토큰 | pezwd5bre2xb |
vida | Vizio 광고 ID, Vizio에만 해당 | dca2365e-0d78-47c6-aaac-9567846c6c9e |
rida | Roku 광고 ID, Roku만 해당 | |
tifa | Tizen OS 광고 ID, Samsung만 해당 | |
idfa | iOS 광고 ID, iOS에만 해당 | 29DDE430-CE81-4F00-A50C-689595AAD142 |
idfv | Roku 벤더 ID, iOS에만 해당 | 59E27F41-A86B-4560-B585-63161F871C4B |
gps_adid | Google Play 광고 ID. Goole Play Service 라이브러리가 추가된 경우에만 전송. Android에만 해당. | 6cf94580-46c2-490c-b882-2f6ae269b579 |
oaid | 공개 광고(익명) ID | ed799bac-2537-6122-377a-edebce5db5a5 |
imei | 국제 모바일 기기 식별코드(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 | 사용자의 광고 추적 제한(LAT) 활성화 여부 표시 | 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 | 운영체제의 현재 버전. | 11.0 |
cpu_type | CPU의 프로세서 패밀리 | 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_name | URL 인코딩된 모델 ID | Moto 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 |
Google에 동의 데이터 제공(디지털 시장법 준수)
EU의 디지털 시장법(DMA)에 따라 Google Ads와 Google Marketing Platform은 API에 대한 Adjust의 어트리뷰션 요청을 수신하기 위해 명시적인 동의를 받아야 합니다.
Adjust는 S2S 세션 및 설치 요청에 대해 다음과 같은 Google DMA 파라미터를 지원합니다. Adjust는 요청 양식에 이러한 파라미터가 있을 것으로 예상합니다.
Google Ads를 사용하는 경우 ad_personalization
파라미터를 전송하고, Google Marketing Platform을 사용하는 경우 npa
파라미터를 전송해야 합니다.
Key | 값 | 설명 |
---|---|---|
eea |
| 사용자가 EEA(유럽경제지역) 거주자인지 여부와 이에 따라 DMA(디지털마케팅법)를 포함한 EU 규정이 해당 사용자와 전환에 적용되는지 여부를 Google에 알려줍니다. |
ad_personalization |
| 사용자가 앱을 설치한 후 Google Ads를 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. |
ad_user_data |
| 사용자가 측정 목적의 개인 정보 공유에 동의했는지 여부를 Google에 알려줍니다. 해당 동의 정보는 광고주들이 Google Ads와 Google Marketing Platform UI에서 명시한 모든 Core Platform Services(CPS)에 적용됩니다. |
npa |
| 사용자가 앱을 설치한 후 Google Marketing Platform을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. |