SESSION 엔드포인트 API 레퍼런스

SDK 구현의 대안으로 서버 간(server-to-server) 연동을 사용하여 Singular의 REST API를 통해 사용자 세션을 추적하고 앱 설치, 리인게이지먼트, 리텐션 지표에 대한 어트리뷰션을 활성화하세요.

개요

서버 간(Server-to-Server) 사용 사례

SESSION 엔드포인트는 사용자가 앱을 열 때 Singular에 알려 설치 및 리인게이지먼트 어트리뷰션과 리텐션 지표를 구동합니다. Server-to-Server가 처음이신가요? S2S 기본 가이드 에서 핵심 개념과 공통 설정을 확인하세요.

지원 기능:

설치 어트리뷰션: 마케팅 캠페인에 대한 퍼스트 터치 어트리뷰션
리인게이지먼트 어트리뷰션: 복귀 사용자를 위한 멀티 터치 어트리뷰션
리텐션 지표: 세션 기반 인게이지먼트 추적

세션 관리

SESSION 엔드포인트는 앱 오픈 이벤트를 Singular에 알려 어트리뷰션 및 추적을 위한 사용자 세션을 초기화합니다.

세션을 전송해야 하는 시점

세션 트리거

다음과 같은 앱 라이프사이클 이벤트에 대해 SESSION 요청을 전송하세요:

신규 설치: 설치 후 최초 앱 실행
종료 상태에서의 실행: 완전히 닫힌 상태에서 앱이 열리는 경우
백그라운드에서 포그라운드로 전환: 타임아웃 기간(권장: 60초) 이후 앱이 포그라운드로 복귀하는 경우

세션 타임아웃 로직

짧은 앱 백그라운드 전환 동안 과도한 SESSION 요청이 발생하지 않도록 세션 타임아웃을 구현하세요.

권장 구현:

타임아웃 시간: 60초(1분)
포그라운드 < 타임아웃: 타임아웃 기간 이내에 앱이 포그라운드로 복귀하면 SESSION을 전송하지 마세요
포그라운드 > 타임아웃: 타임아웃 기간을 초과하여 앱이 백그라운드에 머물렀다면 SESSION을 전송하세요
앱 라이프사이클 추적: 앱 라이프사이클 이벤트와 타이머를 사용하여 세션 상태를 관리하세요

딥링크 지원: 딥링크, Universal Link, App Link를 통해 앱이 열리는 경우 openuri 파라미터가 채워져 있다면 타임아웃 상태와 관계없이 항상 SESSION을 전송하세요.

어트리뷰션 처리

세션 기반 어트리뷰션

Singular는 SESSION 요청을 처리하여 어트리뷰션 유형을 판별하고 적절한 워크플로우를 트리거합니다.

세션 유형	Singular 처리	어트리뷰션 결과
첫 세션(신규 설치)	설치 어트리뷰션 프로세스 트리거	설치를 마케팅 캠페인에 어트리뷰션
리인게이지먼트 조건 충족	리인게이지먼트 어트리뷰션 프로세스 트리거	사용자 복귀를 캠페인 또는 딥링크에 어트리뷰션
일반 세션	리텐션 추적을 위해 세션 기록	사용자 활동 및 인게이지먼트 지표에 반영

자세히 알아보기: 리인게이지먼트 어트리뷰션 FAQ

이벤트 순서 요구사항

세션과 이벤트의 타이밍은 어트리뷰션 정확도와 데이터 품질에 직접적인 영향을 미칩니다.

필수 순서 규칙:

이벤트에 앞선 세션: 해당 세션의 이벤트가 전송되기 전에 단일 SESSION이 먼저 수신되어야 합니다
실시간 이벤트 전송: 인앱 이벤트는 해당 세션 이후 실시간으로 전송되어야 합니다
순차 처리: 잘못된 세션 순서는 데이터 불일치와 어트리뷰션 오류를 초래합니다

API 엔드포인트 명세

SESSION 엔드포인트는 파라미터를 application/x-www-form-urlencoded 형식으로 전송하는 POST 요청을 받습니다.

엔드포인트

Base URL 및 Method

POST https://s2s.singular.net/api/v1/launch

필수 헤더:

Content-Type: application/x-www-form-urlencoded

요청 형식:

POST /api/v1/launch HTTP/1.1
Host: s2s.singular.net
Content-Type: application/x-www-form-urlencoded

param1=value1&param2=value2

필수 파라미터

모든 SESSION 요청에는 올바른 값과 형식을 갖춘 다음 필수 파라미터가 포함되어야 합니다.

API 인증

SDK Key

파라미터	세부 정보
`a`	유형: String API 인증을 위한 Singular SDK Key입니다. 가져오는 위치: Singular UI → 메인 메뉴 → Developer Tools . 중요: Reporting API Key를 사용하지 마세요. 요청이 거부됩니다. 예시: `sdkKey_afdadsf7asf56`

디바이스 식별자

플랫폼별 식별자

파라미터	세부 정보
`idfa`	플랫폼: iOS 유형: UUIDv4 Identifier for Advertisers (IDFA) 는 광고 추적과 캠페인 어트리뷰션을 가능하게 합니다. ATT 요구사항: iOS 14.5 이상에서는 App Tracking Transparency 프레임워크를 통한 사용자 옵트인이 필요합니다. 예시: `DFC5A647-9043-4699-B2A5-76F03A97064B` IDFA를 사용할 수 없는 경우(사용자가 ATT 프롬프트를 거부한 경우) 파라미터를 생략하세요. NULL이나 빈 문자열을 절대 전달하지 마세요. IDFA 가져오기
`idfv`	플랫폼: iOS 유형: UUIDv4 Identifier for Vendors (IDFV) 는 동일 벤더의 모든 앱에서 일관되게 유지됩니다. 항상 필수: ATT 상태나 IDFA 사용 가능 여부와 관계없이 반드시 포함해야 합니다. 예시: `21DB6612-09B3-4ECC-84AC-B353B0AF1334` IDFV 가져오기
`aifa`	플랫폼: Android 유형: UUIDv4 (Google Play) Google Advertising ID (GAID) 는 Android에서 사용자가 재설정할 수 있는 광고 추적을 가능하게 합니다. 예시: `8ecd7512-2864-440c-93f3-a3cabe62525b` Google Play 디바이스에서 필수입니다. Google Play가 아닌 디바이스에서는 생략하세요. 사용할 수 없는 경우 생략하세요—NULL이나 빈 문자열을 절대 전달하지 마세요. AIFA 가져오기
`asid`	플랫폼: Android 유형: UUIDv4 (Google Play) Android App Set ID 는 동일 개발자를 위한 프라이버시를 고려한 앱 간 추적을 제공합니다. 항상 필수: Google Play 디바이스에서는 GAID 사용 가능 여부와 관계없이 반드시 포함해야 합니다. 예시: `edee92a2-7b2f-45f4-a509-840f170fc6d9` Google Play가 아닌 디바이스에서는 생략하세요. ASID 가져오기
`amid`	플랫폼: Android 유형: UUIDv4 (Amazon) Amazon Advertising ID 는 Google Play 서비스가 없는 Amazon 디바이스용입니다. 예시: `df07c7dc-cea7-4a89-b328-810ff5acb15d` Amazon Fire 디바이스에서 필수입니다. 사용할 수 없는 경우 생략하세요. AMID 가져오기
`oaid`	플랫폼: Android 유형: UUIDv4 (중국 OEM) Google Play 서비스가 없는 중국산 디바이스(Huawei, Xiaomi, OPPO 등)를 위한 Open Advertising Identifier (OAID)입니다. 예시: `01234567-89abc-defe-dcba-987654321012` Google Play가 없는 중국 OEM 디바이스에서 필수입니다. 사용할 수 없는 경우 생략하세요. OAID 가져오기
`andi`	플랫폼: Android 유형: String (Google Play 미지원) Android ID는 디바이스가 생성한 64비트 식별자입니다. 사용 제한: Google Play 디바이스에서는 금지됩니다—대신 AIFA와 ASID를 사용하세요. 다른 식별자를 사용할 수 없고 앱이 Google Play를 통해 배포되지 않는 경우에만 전송하세요. ANDI 가져오기 예시: `fc8d449516de0dfb`
`sdid`	플랫폼: iOS, Android, PC, Xbox, PlayStation, Nintendo, MetaQuest, CTV 유형: UUIDv4 Singular Device ID는 고유한 앱 설치를 나타내는, 클라이언트가 생성한 익명화된 UUIDv4입니다. 주요 식별자: PC 및 콘솔 애플리케이션에 유일하게 유효한 디바이스 식별자입니다. 예시: `40009df0-d618-4d81-9da1-cbb3337b8dec`

디바이스 파라미터

디바이스 정보

파라미터	세부 정보
`p`	유형: String 애플리케이션의 플랫폼입니다. 허용 값(대소문자 구분): 예시: `Android` Android iOS PC Xbox Playstation Nintendo MetaQuest CTV
`ip`	유형: String 예시: `172.58.29.235` 디바이스의 공용 IPv4 주소입니다. IPv6도 지원되지만, 광고 네트워크와의 어트리뷰션 호환성을 위해 IPv4를 권장합니다.
`ve`	유형: String 예시: `9.2` 세션 시점의 디바이스 OS 버전입니다.
`ma`	플랫폼: iOS, Android 유형: String 디바이스 제조사(제조사 이름)입니다. `mo` (모델)와 함께 사용해야 합니다. 디바이스 제조사 가져오기 예시: `Samsung` , `LG` , `Apple`
`mo`	플랫폼: iOS, Android 유형: String 디바이스 모델입니다. `ma` (제조사)와 함께 사용해야 합니다. 디바이스 모델 가져오기 예시: `iPhone 4S` , `Galaxy SIII`
`lc`	플랫폼: iOS, Android 유형: String IETF 로케일 태그—밑줄로 구분된 두 글자 언어 코드와 국가 코드입니다. 디바이스 로케일 가져오기 예시: `en_US`
`bd`	플랫폼: iOS, Android 유형: String URL 인코딩된 디바이스 빌드 식별자입니다. 디바이스 빌드 가져오기 예시: `Build%2F13D15`

애플리케이션 파라미터

앱 정보

파라미터 세부 정보

i

유형: String
앱 식별자(대소문자 구분)입니다.
예시: com.singular.app

Android: 패키지 이름(예: com.singular.app )
iOS: Bundle ID(예: com.singular.app )
PC/콘솔: 지정된 식별자

app_v

유형: String
예시: 1.2.3

애플리케이션 버전입니다.

att_authorization_status

플랫폼: iOS
유형: Integer
App Tracking Transparency (ATT) 상태 코드(iOS 14.5 이상)입니다.
상태 값:

0 - 미결정(프롬프트 미표시)
1 - 제한됨(디바이스 수준 추적 비활성화)
2 - 거부됨(사용자가 권한 거부)
3 - 승인됨(사용자가 권한 부여)

항상 필수: ATT가 구현되지 않은 경우에도 0 (미결정)을 전달하세요.

예시: 3

파라미터 세부 정보

install

유형: Boolean
세션이 설치 또는 재설치 후 첫 세션인지 여부를 나타냅니다.
필요한 경우: 재설치 추적 기능
예시: true

true - 신규 설치/재설치 후 첫 세션
false - 이후 세션(앱이 이미 설치됨)

install_time

플랫폼: iOS, Android
유형: Integer
OS가 보고한, 앱이 디바이스에 물리적으로 설치된 시점의 Unix 타임스탬프(초)입니다.
예시: 1510040127

이것은 디바이스 설치 시간이며 Singular의 어트리뷰션 설치 시간이 아닙니다. 어트리뷰션은 첫 세션( install=true )의 세션 타임스탬프( utime )를 사용합니다.

iOS와 Android에서 이 값을 얻는 방법은 디바이스 데이터 조회 가이드 를 참조하세요.

update_time

플랫폼: iOS, Android
유형: Integer
OS가 보고한, 앱이 디바이스에서 마지막으로 업데이트된 시점의 Unix 타임스탬프(초)입니다.
예시: 1510040127

iOS와 Android에서 이 값을 얻는 방법은 디바이스 데이터 조회 가이드 를 참조하세요.

부정행위 방지 파라미터

설치 소스 검증

파라미터 세부 정보

install_source

플랫폼: Android, PC
유형: String
설치 소스 패키지 이름 또는 스토어 식별자입니다.
Android: 설치 소스 패키지 이름
Android 예시: com.android.vending (Google Play Store)
PC 지원 스토어:

steam
epic
microsoftstore
humblestore
gog
selfdistributed

install_receipt

플랫폼: iOS
유형: String
부정행위 검증을 위한 Base64 인코딩된 iOS 설치 영수증입니다.
예시(일부 생략): MIJF9wYJKoZIhvcNAQcCoIJF6DCCReQCAQExCzAJBgUrDgMCGgUAMII1m...

딥링크 파라미터

딥링크 지원

파라미터 세부 정보

openuri

플랫폼: iOS, Android
유형: String
앱을 연 URL 인코딩된 딥링크, Universal Link 또는 App Link입니다.
원본 URL: myapp://home/page?queryparam1=value1&queryparam2=value2
인코딩된 예시: myapp%3A%2F%2Fhome%2Fpage%3Fqueryparam1%3Dvalue1%26queryparam2%3Dvalue2

ddl_enabled

플랫폼: iOS, Android
유형: Boolean
앱이 응답에서 디퍼드 딥링크 URL을 기대하는지 여부를 나타냅니다.
예시 응답:

true - 응답에서 디퍼드 딥링크를 기대함
false - 디퍼드 딥링크를 기대하지 않음

{
  "deferred_deeplink": "myapp://deferred-deeplink",
  "status": "ok",
  "deferred_passthrough": "passthroughvalue"
}

singular_link_resolve_required

플랫폼: iOS, Android
유형: Boolean
Singular 단축 링크를 원본 링크로 확인(resolve)하도록 요청합니다. Singular 단축 링크를 포함한 openuri 와 함께 사용해야 합니다.
예시 응답:

true - 확장된 원본 링크 반환
false - 링크를 확인하지 않음

{
  "status":"ok",
  "resolved_singular_link":"https://myapp.sng.link/A59c0/nha7?_dl=myapp%3A%2F%2Fdeeplink&_ddl=myapp%3A%2F%2Fdeferred-deeplink&_p=passthroughvalue"
}

고급 어트리뷰션 파라미터

플랫폼 어트리뷰션 향상

파라미터 세부 정보

install_ref Native PC (Google Play Games)

플랫폼: Android (Google Play)
유형: JSON
JSON URL 인코딩된 Google Install Referrer 정보입니다. Android 및 Google Play Games PC 설치에 가장 정확한 어트리뷰션을 제공합니다.
Android JSON 구조:
Native PC JSON 구조:
필요한 경우:
추가 정보:

URL 인코딩된 예시: %7B%22installBeginTimestampSeconds%22%3A%221568939453%22...

{
   "installBeginTimestampSeconds":"1568939453",
   "referrer":"utm_source=google-play&utm_medium=organic",
   "clickTimestampSeconds":"0",
   "referrer_source":"service",
   "current_device_time":"1568944524"
}

{
   "install_time_epoch_seconds":"1568939453",
   "install_referrer":"utm_source=google-play&utm_medium=organic"
}

Facebook 사용자 수준 내보내기
Data Destination 공유
포스트백 정확도

meta_ref

플랫폼: Android (Google Play)
유형: JSON

2025년 6월 18일부터: Meta Advanced Mobile Measurement (AMM) 이 Meta Install Referrer 구현의 필요성을 없앱니다. AMM이 활성화된 경우 권장하지 않습니다.

세분화된 사용자 수준 어트리뷰션 데이터를 위한 JSON URL 인코딩된 Meta Install Referrer입니다.
JSON 구조:
자세히 알아보기: Meta Referrer FAQ

{
  "install_referrer": {
    "utm_source":"apps.facebook.com",
    "utm_campaign": "fb4a",
    "utm_content": {
      "source":{
        "data":"c7e6b890bf18a059c2185650bdb1af3dced7...",
        "nonce":"24859720343e2381daee9f39ae61"
        },
      "app":533744218636280,
      "t":1731181327
      },
    "is_ct":1,
    "actual_timestamp":1731181444
  }
}

attribution_token

플랫폼: iOS
유형: String
AdServices 프레임워크(iOS 14.3 이상)의 Apple Search Ads 어트리뷰션 토큰입니다.
가져오는 방법: 설치/재설치 후 첫 앱 실행 시 attributionToken() 사용.
예시(일부 생략): KztLg%2FIkNsWDMuBMOU%2BySnkPU5myJb4OFmeaMUE%2BTqQJP...

선택 파라미터

선택 파라미터는 추적 기능을 강화하고 고급 기능을 지원합니다.

타임스탬프 파라미터

파라미터	세부 정보
`utime`	유형: Integer 세션의 10자리 Unix 타임스탬프입니다. 예시: `1483228800`
`umilisec`	유형: Integer 밀리초를 포함한 13자리 Unix 타임스탬프입니다. 예시: `1483228800000`

네트워크 & 위치 파라미터

파라미터	세부 정보
`use_ip`	유형: Boolean Singular가 `ip` 파라미터 대신 HTTP 요청에서 IP 주소를 추출하도록 지시합니다. 제한사항: Singular의 IP 기반 지오로케이션을 방지합니다. `country` 파라미터를 통해 두 글자 국가 코드를 제공하세요. `ip` 파라미터와 상호 배타적입니다—둘 다 사용하지 마세요. 데이터 거부를 방지하려면 `ip` 또는 `use_ip` 중 하나를 반드시 제공해야 합니다. 예시: `true`
`country`	유형: String ISO 3166-1 alpha-2 두 글자 국가 코드입니다. 필수 조건: IP 주소를 사용할 수 없거나 `use_ip=true` 인 경우. 예시: `US`
`ua`	유형: String URL 인코딩된 User Agent 문자열입니다. 원본: `Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15...` 예시: `Mozilla%2F5.0%20(iPhone%3B%20CPU%20iPhone%20OS%2014_0...`
`c`	플랫폼: iOS, Android 유형: String 네트워크 연결 유형입니다. 허용 값: `wifi` , `carrier` 예시: `wifi`
`cn`	플랫폼: iOS, Android 유형: String 예시: `Comcast` 인터넷 제공업체의 통신사 이름입니다.

커스텀 속성

파라미터 세부 정보

global_properties

유형: JSON
커스텀 키-값 쌍을 포함한 URL 인코딩된 JSON 객체입니다.
제한:
JSON: {"key1":"value1","key2":"value2"}
URL 인코딩: %7B%22key1%22%3A%22value1%22%2C%22key2%22%3A%22value2%22%7D

최대 5개의 키-값 쌍
키와 값당 최대 200자

앱 삭제 추적 지원

파라미터 세부 정보

apns_token

플랫폼: iOS
유형: String
16진수 인코딩된 Apple Push Notification Service (APNs) 디바이스 토큰입니다.
예시: b0adf7c9730763f88e1a048e28c68a9f806ed032fb522debff5bfba010a9b052

iOS 앱 삭제 추적에 필수
반드시 16진수 인코딩된 문자열이어야 함
APNs 토큰 가져오기

fcm

플랫폼: Android
유형: String
Firebase Cloud Messaging 디바이스 토큰입니다.
예시: bk3RNwTe3H0CI2k_HHwgIpoDKCIZvvD...MExUdFQ3P1

Android 앱 삭제 추적에 필수
FCM 토큰 가져오기

데이터 프라이버시 파라미터

파라미터 세부 정보

data_sharing_options

유형: JSON
데이터 공유에 대한 최종 사용자 동의를 나타내는 JSON URL 인코딩 값입니다. 이후 모든 SESSION 및 EVENT 요청에서 유지되고 전달되어야 합니다.
사용자 동의(옵트인):
사용자 거부(옵트아웃):
예시: %7B%22limit_data_sharing%22%3Atrue%7D

{"limit_data_sharing":false}

{"limit_data_sharing":true}

dnt

플랫폼: iOS, Android
유형: Integer
Do Not Track 상태입니다.
예시: 0

1 - Do Not Track 활성화
0 - Do Not Track 비활성화

dntoff

플랫폼: iOS, Android
유형: Integer
Do Not Track이 OFF인지 여부를 나타냅니다.
예시: 1

0 - Do Not Track 활성화(OFF=false)
1 - Do Not Track 비활성화(OFF=true)

크로스 디바이스 지원

파라미터 세부 정보

custom_user_id

유형: String
크로스 디바이스 추적을 위한 내부 사용자 ID입니다.

PII 금지: 개인 식별 정보를 전달하지 마세요. 원본 이메일 주소, 전화번호, 이름 대신 해시 처리되거나 익명화된 내부 식별자를 사용하세요.

예시: 123456789abcd

SKAdNetwork 지원

파라미터	세부 정보
`skan_conversion_value`	플랫폼: iOS 유형: Integer 세션 시점의 최신 SKAdNetwork 전환 값입니다. 자세히 알아보기: SKAdNetwork 구현 예시: `7`
`skan_first_call_timestamp`	플랫폼: iOS 유형: Integer SKAdNetwork API에 대한 첫 호출의 Unix 타임스탬프입니다. 예시: `1483228800`
`skan_last_call_timestamp`	플랫폼: iOS 유형: Integer 세션 시점에 SKAdNetwork API에 대한 가장 최근 호출의 Unix 타임스탬프입니다. 예시: `1483228800`

Google Ads ICM 지원 (Beta)

파라미터	세부 정보
`odm_info`	플랫폼: iOS 유형: String Google Ads Integrated Conversion Measurement (Beta)에 필수입니다. Google Ads ICM 문서
`odm_error`	플랫폼: iOS 유형: String Google Ads Integrated Conversion Measurement (Beta)에 필수입니다. Google Ads ICM 문서

요청 예시

샘플 코드는 여러 프로그래밍 언어에 걸친 SESSION 엔드포인트 연동을 보여줍니다.

예시 관련 주의: 코드 샘플에 모든 필수 파라미터가 포함되지 않을 수 있습니다. 프로덕션 구현 전에 전체 파라미터 목록을 검증하세요. 개발/테스트에는 고유한 i (앱 식별자)를 사용하세요.

Python 예시

import requests

url = 'https://s2s.singular.net/api/v1/launch'
headers = {'Content-Type': 'application/x-www-form-urlencoded'}
data = {
    'a': 'sdk_key_here',
    'p': 'Android',
    'i': 'com.singular.app',
    'ip': '10.1.2.3',
    've': '9.2',
    'ma': 'samsung',
    'mo': 'SM-G935F',
    'lc': 'en_US',
    'aifa': '8ecd7512-2864-440c-93f3-a3cabe62525b',
    'asid': 'edee92a2-7b2f-45f4-a509-840f170fc6d9',
    'install': 'true',
    'n': 'MyCoolAppName',
    'bd': 'Build/13D15',
    'app_v': '1.2.3',
    'openuri': 'myapp://home/page?queryparam1=value1',
    'ddl_enabled': 'true',
    'install_source': 'com.android.vending',
    'install_time': 1510040127,
    'update_time': 1510090877
}

response = requests.post(url, data=data, headers=headers)
print(response.json())

cURL 예시

curl -X POST "https://s2s.singular.net/api/v1/launch" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "a=sdk_key_here" \
  --data-urlencode "p=Android" \
  --data-urlencode "i=com.singular.app" \
  --data-urlencode "ip=10.1.2.3" \
  --data-urlencode "ve=9.2" \
  --data-urlencode "ma=samsung" \
  --data-urlencode "mo=SM-G935F" \
  --data-urlencode "lc=en_US" \
  --data-urlencode "aifa=8ecd7512-2864-440c-93f3-a3cabe62525b" \
  --data-urlencode "asid=edee92a2-7b2f-45f4-a509-840f170fc6d9" \
  --data-urlencode "install=true" \
  --data-urlencode "n=MyCoolAppName" \
  --data-urlencode "bd=Build/13D15" \
  --data-urlencode "app_v=1.2.3" \
  --data-urlencode "openuri=myapp://home/page?queryparam1=value1" \
  --data-urlencode "ddl_enabled=true" \
  --data-urlencode "install_source=com.android.vending" \
  --data-urlencode "install_time=1510040127" \
  --data-urlencode "update_time=1510090877"

HTTP 예시

POST /api/v1/launch HTTP/1.1
Host: s2s.singular.net
Content-Type: application/x-www-form-urlencoded
Accept: application/json

a=sdk_key_here&p=Android&i=com.singular.app&ip=10.1.2.3&ve=9.2&ma=samsung&mo=SM-G935F&lc=en_US&aifa=8ecd7512-2864-440c-93f3-a3cabe62525b&asid=edee92a2-7b2f-45f4-a509-840f170fc6d9&install=true&n=MyCoolAppName&bd=Build%2F13D15&app_v=1.2.3&openuri=myapp%3A%2F%2Fhome%2Fpage%3Fqueryparam1%3Dvalue1&ddl_enabled=true&install_source=com.android.vending&install_time=1510040127&update_time=1510090877

Java 예시

// Endpoint
String endpoint = "https://s2s.singular.net/api/v1/launch";

// Parameters
Map<String, String> params = new HashMap<>();
params.put("a", "sdk_key_here");
params.put("p", "Android");
params.put("i", "com.singular.app");
params.put("ip", "10.1.2.3");
params.put("ve", "9.2");
params.put("ma", "samsung");
params.put("mo", "SM-G935F");
params.put("lc", "en_US");
params.put("aifa", "8ecd7512-2864-440c-93f3-a3cabe62525b");
params.put("asid", "edee92a2-7b2f-45f4-a509-840f170fc6d9");
params.put("install", "true");
params.put("n", "MyCoolAppName");
params.put("bd", "Build/13D15");
params.put("app_v", "1.2.3");
params.put("openuri", "myapp://home/page?queryparam1=value1");
params.put("ddl_enabled", "true");
params.put("install_source", "com.android.vending");
params.put("install_time", "1510040127");
params.put("update_time", "1510090877");

// Build form-urlencoded body
StringBuilder form = new StringBuilder();
for (Map.Entry<String, String> entry : params.entrySet()) {
    if (form.length() > 0) form.append('&');
    form.append(URLEncoder.encode(entry.getKey(), StandardCharsets.UTF_8))
        .append('=')
        .append(URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8));
}
byte[] body = form.toString().getBytes(StandardCharsets.UTF_8);

// Create connection
URL url = new URL(endpoint);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setDoOutput(true);
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
conn.setRequestProperty("Accept", "application/json");

// Write body
try (OutputStream os = conn.getOutputStream()) {
    os.write(body);
}

// Get response
int responseCode = conn.getResponseCode();
BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();

System.out.println("HTTP Status Code: " + responseCode);
System.out.println("Response: " + response.toString());
conn.disconnect();

응답 코드 & 오류

SESSION 엔드포인트는 요청 성공 또는 실패를 나타내는 HTTP 상태 코드와 JSON 응답을 반환합니다.

전체 오류 문서: S2S 응답 코드 & 오류 처리

테스트 & 검증

실시간 데이터 검증을 위해 Singular SDK Console을 사용하여 프로덕션 배포 전에 S2S 연동을 확인하세요.

테스트 절차

엔드투엔드 검증

테스트 디바이스 등록: 디바이스 광고 ID를 확보하여 Singular SDK Console 에 추가하세요
Console 로깅 활성화: 테스트 데이터를 캡처하기 위해 SDK Console에 디바이스 식별자를 추가하세요
개발용 App ID 사용: 테스트 데이터를 프로덕션 데이터와 분리하기 위해 앱 식별자를 개발 버전(예: com.singular.app.dev )으로 재정의하세요
앱 실행: 종료 상태에서 앱을 열어 세션을 트리거하세요
클라이언트 데이터 검증: 앱이 필요한 모든 Singular 데이터 포인트를 서버로 전송하는지 확인하세요
서버 요청 확인: 서버가 모든 필수 파라미터와 함께 https://s2s.singular.net/api/v1/launch 로 SESSION 요청을 전송하는지 확인하세요
SDK Console 확인: 몇 초 이내에 SESSION 이벤트가 SDK Console에 나타나야 합니다
테스트 반복: 모든 앱 진입 및 포그라운드 작동 시 SESSION이 트리거되는지 검증하세요

SDK Console 세션 이벤트

중요 검증: EVENT 요청보다 먼저 앱 오픈/포그라운드 시 SESSION 이벤트가 발생하는지 확인하세요. 잘못된 순서는 어트리뷰션 오류를 유발합니다.

성공 지표: SESSION이 SDK Console에 나타나면 엔드투엔드 연동 테스트를 성공적으로 완료한 것입니다!

추가 리소스

테스트 문서

종합 테스트 가이드: S2S 연동 테스트 가이드

서버 간(Server-to-Server) - SESSION 엔드포인트 API 레퍼런스

SESSION 엔드포인트 API 레퍼런스

개요

서버 간(Server-to-Server) 사용 사례

세션 관리

세션을 전송해야 하는 시점

세션 트리거

세션 타임아웃 로직

어트리뷰션 처리

세션 기반 어트리뷰션

이벤트 순서 요구사항

API 엔드포인트 명세

엔드포인트

Base URL 및 Method

필수 파라미터

API 인증

SDK Key

디바이스 식별자

플랫폼별 식별자

디바이스 파라미터

디바이스 정보

애플리케이션 파라미터

앱 정보

부정행위 방지 파라미터

설치 소스 검증

딥링크 파라미터

딥링크 지원

고급 어트리뷰션 파라미터

플랫폼 어트리뷰션 향상

선택 파라미터

타임스탬프 파라미터

네트워크 & 위치 파라미터

커스텀 속성

앱 삭제 추적 지원

데이터 프라이버시 파라미터

크로스 디바이스 지원

SKAdNetwork 지원

Google Ads ICM 지원 (Beta)

요청 예시

Python 예시

cURL 예시

HTTP 예시

Java 예시

응답 코드 & 오류

테스트 & 검증

테스트 절차

엔드투엔드 검증

추가 리소스

테스트 문서