세션은 Adjust에서의 모든 어트리뷰션과 측정의 기반입니다. 세션은 사용자가 백그라운드에서 앱의 사용을 재개하거나 앱을 실행할 때 발생합니다. 앱 내의 개별 사용자 세션 기록을 위해 S2S 세션 API를 사용하시기 바랍니다.
시작에 앞서 {#before-you-begin}
인증
S2S 보안을 설정하여 S2S 세션의 보안을 보장하고, 스푸핑된 요청으로부터 보호할 수 있습니다. 이를 위해서는 수신되는 모든 요청에 Adjust 대시보드에서 생성된 인증 토큰이 포함되어야 합니다. 토큰이 포함되어 있지 않거나 올바르지 않은 토큰을 포함한 요청은 Adjust 서버에서 거부됩니다.
세션 기록 {#record-sessions}
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 광고 식별자. 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에 동의 데이터 제공(디지털 시장법 준수) {#provide-consent-data-to-google-digital-markets-act-compliance}
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을 통해 맞춤형 광고를 제공받는 데 동의했는지 여부를 알려줍니다. |