PC 및 콘솔 서버 간(S2S) API 엔드포인트 참조

문서
PC 및 콘솔 게임 어트리뷰션은 엔터프라이즈 기능입니다. 이 기능에 대해 자세히 알아보려면 PC 및 콘솔 게임 어트리뷰션 FAQ를 참조하거나 고객 성공 매니저에게 문의하세요.

세션 알림 엔드포인트

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

세션 알림 엔드포인트를 사용하여 모든 게임 실행(첫 번째, 반복 세션)을 가능한 한 실시간으로 이 엔드포인트에 보고하세요. Singular 디바이스 ID로 식별된 설치에 대해 Singular가 수신한 첫 번째 게임 실행이 어트리뷰션에 사용됩니다.

세션 파라미터

파라미터 설명 제약 조건 예시
a "개발자 도구 -> SDK 연동 > SDK 키"에 있는 Singular 계정의 "SDK" 키입니다. 필수 YOUR_ORG_NAME_SH868SDJV
p 게임의 플랫폼은 지원되는 값을 따라야 합니다:
PC, Xbox, 플레이스테이션, 닌텐도, 메타퀘스트

필수

지원되는 값만

pc
i 게임 고유의 게임 식별자 값입니다. 동일한 게임이 여러 플랫폼에 배포되는 경우 동일한 값을 사용합니다.

필수

역방향 DNS 표기법

대소문자 구분

com.singular.game
sdid

Singular가 사용자의 고유한 설치 및 게임 활동을 식별하는 데 사용하는 고유 기기 ID입니다.

이 UUID는 게임/서버에서 생성해야 하며, 게임을 처음 실행(설치)하는 시점에 생성하는 것이 좋습니다.

UUID(버전 4) 49c2d3a6-326e-4ec5-a16b-0a47e34ed953
match_id

어트리뷰션에 사용할 수 있는 식별자로, 사용자가 게임을 처음 실행할 때 전송해야 합니다. 이 값은 Singular 웹 SDK 구현에 사용된 "match_id"와 일치해야 합니다.

식별자가 PII인 경우, 해시(SHA-256)되어야 합니다.

결정적 어트리뷰션의 경우 선택 사항

전송되는 경우, 설치 후 게임을 처음 실행할 때 전송되어야 합니다.

matchid_12345
os

운영 체제 / 게임 시스템

사용자 지정 값은 지원되지만 권장 값은 다음과 같습니다.

필수

지원되는 사용자 지정 값

플랫폼 = PC

  • windows
  • linux
  • macOS
  • steamOS

플랫폼 = XBox

  • Xbox_one
  • Xbox_360
  • Xbox_series_s
  • xbox_series_x

플랫폼 = 플레이스테이션

  • playstation_3
  • Playstation_4
  • playstation_5

플랫폼 = 닌텐도

  • nintendo_switch

플랫폼 = 메타 퀘스트

  • 메타퀘스트
  • 메타퀘스트_2
  • 메타퀘스트_프로
ve 운영 체제 버전 선택 사항 22H2
av 앱 버전 또는 게임 빌드 선택 사항 1.1.5.581823a
IP

게임 출시 이벤트 시점의 기기 IP

필수 172.58.29.235
use_ip HTTP 요청에서 IP 필드를 추출합니다. 이 값을 true로 설정하면 IP 매개변수를 제공하지 마세요.

선택 사항

부울

false
install_source

게임을 배포한 게임 스토어의 이름입니다.

사용자 지정 값도 지원되지만 권장값이 권장됩니다.

필수

steam

epicgamestore

microsoftstore

gog

humblestore

xbox

플레이스테이션

닌텐도

자체 배포

[커스텀]

ua 디바이스의 사용자 에이전트 선택 사항

Mozilla/5.0(Windows NT 10.0; Win64; x64)
AppleWebKit/537.36(KHTML, Gecko 등) Chrome/115.0.0.0 Safari/537.36

global_properties

사용자를 위해 정의하고 저장할 수 있는 키 값 쌍입니다. 정의된 값은 이후의 모든 호출에서 유지되어야 합니다. 값을 보내지 않으면 값을 설정 해제하는 것으로 간주됩니다.

선택 사항

글로벌 속성은 최대 5개까지 지원되며, 각각 200자 길이여야 합니다. URLEncoded JSON 개체여야 합니다.

%7B%22key1%22%3A%22value1%22%2C%
22key2%22%3A%22value2%22%7D

DATA_SHARING_OPTIONS

이 옵션 값을 전달하여 정보 공유에 대한 최종 사용자의 동의를 표시합니다. 설정하면 이 값은 유지되며 이후 사용자에 대한 모든 후속 /launch 및 /evt 요청에 전달되어야 합니다. PC 및 콘솔 사용자 개인정보 보호 참조

사용자가 정보 공유에 동의(옵트인)했음을 표시하려면 "limit_data_sharing":false를 전달합니다.

사용자가 거부한 경우 "limit_data_sharing":true를 전달합니다.

선택 사항

%7B%22limit_data_sharing%22%3Atrue%7D

install 설치 플래그. 앱을 설치한 후 첫 번째 세션인 경우 'true'. 그렇지 않으면 'false'. 재설치 추적 기능에 필요합니다.

선택 사항

부울

true
utime 게임 실행 시간(유닉스 시간 기준)입니다. 선택 사항 1483228800
umilisec 게임 실행 시간(밀리초, UNIX 시간)입니다. 선택 사항 1483228800000
custom_user_id

사용자 ID

선택 사항 123456789abcd

이벤트 알림 엔드포인트

GET https://s2s.singular.net/api/v1/evt

이벤트 알림 엔드포인트를 사용하여 원하는 모든 선택적 게임 내 이벤트를 가능한 한 실시간으로 이 엔드포인트에 보고하세요. 인게임 이벤트 전달은 적극 권장되며 분석, 보고, 최적화를 위해 다양한 파트너에게 전달하는 데 사용됩니다.

이벤트 파라미터

파라미터 설명 제약 조건 예제
a "개발자 도구 -> SDK 연동 > SDK 키"에 있는 Singular 계정의 "SDK" 키입니다. 필수 YOUR_ORG_NAME_SH868SDJV
p 게임의 플랫폼은 지원되는 값을 따라야 합니다:
PC, Xbox, 플레이스테이션, 닌텐도, 메타퀘스트

필수

지원되는 값만

pc
i 게임 고유의 게임 식별자 값입니다. 동일한 게임이 여러 플랫폼에 배포되는 경우 동일한 값을 사용합니다.

필수

역방향 DNS 표기법

대소문자 구분

com.singular.app
sdid

Singular가 사용자의 고유한 설치 및 게임 활동을 식별하는 데 사용하는 고유 기기 ID입니다.

이 UUID는 게임/서버에서 생성해야 하며, 게임을 처음 실행(설치)하는 시점에 생성하는 것이 좋습니다.

UUID 49c2d3a6-326e-4ec5-a16b-0a47e34ed953
n

게임 내 이벤트의 이름입니다.

Singular의 표준 이벤트 명명 규칙을 사용하는 것을 적극 권장합니다.

필수 sng_achievement_unlocked
e

이벤트에 대한 풍부한 정보를 제공하는 JSON 형식의 사용자 지정 이벤트 속성입니다.

Singular의 표준 이벤트 속성 명명 규칙을 사용할 것을 적극 권장합니다.

선택 사항

JSON

%7B%22sng_attr_content_id%22%3A5581%2C
sng_attr_content%22%3A%22XBox%22%2C%22
sng_attr_content_type%22%3A%22electronics%22%7D
is_revenue_event

구매 이벤트인지 여부입니다. 이벤트 이름이 "__iap__"이거나 0이 아닌 "amt"가 제공된 경우 생략할 수 있습니다.

구매 이벤트에 필수

true
amt

구매 이벤트인 경우통화 금액입니다. 이 값은 "cur" 매개변수와 함께 사용해야 합니다.

구매 이벤트에 필수

2.51
cur

구매 이벤트인 경우 ISO-4217 세 글자 통화 코드입니다. "amt" 매개변수와 함께 사용해야 합니다.

구매 이벤트에 필수

EUR
os

운영 체제/게임 시스템

사용자 지정 값은 지원되지만 권장 값은 다음과 같습니다.

필수

지원되는 사용자 지정 값

플랫폼 = PC

  • windows
  • linux
  • macOS
  • steamOS

플랫폼 = XBox

  • Xbox_one
  • Xbox_360
  • Xbox_series_s
  • xbox_series_x

플랫폼 = 플레이스테이션

  • playstation_3
  • Playstation_4
  • playstation_5

플랫폼 = 닌텐도

  • nintendo_switch

플랫폼 = 메타 퀘스트

  • 메타퀘스트
  • 메타퀘스트_2
  • 메타퀘스트_프로
ve 운영 체제 버전 선택 사항 22H2
av 앱 버전 또는 게임 빌드 선택 사항 1.1.5.581823a
ip

게임 내 이벤트 발생 시점의 디바이스 IP

필수 172.58.29.235
use_ip HTTP 요청에서 IP 필드를 추출합니다. 이 값을 true로 설정한 경우 IP 매개변수를 제공하지 마세요.

선택 사항

부울

false
install_source

게임을 배포한 게임 스토어의 이름입니다.

사용자 지정 값도 지원되지만 권장값이 권장됩니다.

필수

steam

epicgamestore

microsoftstore

gog

humblestore

xbox

플레이스테이션

닌텐도

자체 배포

[커스텀]

ua 디바이스의 사용자 에이전트 선택 사항

Mozilla/5.0(Windows NT 10.0; Win64; x64)
AppleWebKit/537.36(KHTML, Gecko 등) Chrome/115.0.0.0 Safari/537.36

global_properties

사용자를 위해 정의하고 저장할 수 있는 키 값 쌍입니다. 정의된 값은 이후의 모든 호출에서 유지되어야 합니다. 값을 보내지 않으면 값을 설정 해제하는 것으로 간주됩니다.

선택 사항

글로벌 속성은 최대 5개까지 지원되며, 각각 200자 길이여야 합니다. URLEncoded JSON 개체여야 합니다.

%7B%22key1%22%3A%22value1%22%2C%
22key2%22%3A%22value2%22%7D

DATA_SHARING_OPTIONS

이 옵션 값을 전달하여 정보 공유에 대한 최종 사용자의 동의를 표시합니다. 설정하면 이 값은 유지되며 이후 사용자에 대한 모든 /launch 및 /evt 요청에 전달되어야 합니다. PC 및 콘솔 사용자 개인정보 보호 참조

사용자가 정보 공유에 동의(옵트인)했음을 표시하려면 "limit_data_sharing":false를 전달합니다.

사용자가 거부한 경우 "limit_data_sharing":true를 전달합니다.

선택 사항

%7B%22limit_data_sharing%22%3Atrue%7D

utime 게임 내 이벤트 시간(UNIX 시간 기준)입니다. 선택 사항 1483228800
umilisec 게임 내 이벤트 시간(밀리초, UNIX 시간)입니다. 선택 사항 1483228800000
custom_user_id

사용자 ID

선택 사항 123456789abcd