세션 알림 엔드포인트
| GET | https://s2s.singular.net/api/v1/launch |
세션 알림 엔드포인트를 사용하면 모든 게임 실행(첫 번째, 반복 세션)을 준실시간으로 이 엔드포인트에 보고할 수 있습니다. 게임실행시 싱귤러에 싱귤러 디바이스 ID와 함께 수신된 첫 번째 세션이 인스톨 어트리뷰션에 사용됩니다.
세션 파라미터
| 파라미터 | 설명 | 제약 조건 | 예시 |
|---|---|---|---|
| a | "개발자 도구 -> SDK 통합 -> SDK 키"에서 단일 계정의 "SDK" 키를 확인하세요. | 필수 | your_org_name_sh868sdjv |
| p | 게임 플랫폼은 아래 목록에 지원되는 값을 적용해야 합니다: pc, xbox, playstation, nintendo, metaquest |
필수 지원되는 값만 적용가능 |
pc |
| i | 고유한 게임 식별자 값입니다. 동일한 게임을 여러 플랫폼에 배포하는 경우 동일한 값을 사용하세요. |
필수 역방향 DNS 표기법 대소문자 구분 |
com.singular.game |
| sdid |
사용자의 고유한 설치 및 게임 활동을 식별하는 데 사용되는 단일 기기 ID입니다. 이 UUID는 게임을 처음 실행(설치)할 때 게임/서버에서 생성해야 하며, 앱 설치 기간 내내 유지되어야 합니다. |
UUID (Version 4) | 49c2d3a6-326e-4ec5-a16b-0a47e34ed953 |
| match_id |
어트리뷰션에 사용할 수 있는 고유 식별자입니다. 이 식별자는 사용자가 게임을 처음 실행할 때 전송되어야 합니다. 이 값은 싱귤러 웹 SDK 구현에 사용된 "match_id"와 일치해야 합니다.
|
결정적 어트리뷰션의 경우 선택 사항 전송하는 경우, 설치 후 게임을 처음 실행할 때 전송해야 합니다. |
matchid_12345 |
| os |
운영 체제/게임 시스템 사용자 지정 값이 지원되지만 권장되는 값은 다음과 같습니다. |
필수 사용자 지정 값 지원 |
Platform = PC
Platform = XBox
Platform = Playstation
Platform = Nintendo
Platform = Meta Quest
|
| 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 playstation nintendo selfdistributed [custom]
|
| ua | 디바이스의 사용자 에이전트 | 선택 사항 |
Mozilla/5.0 (Windows NT 10.0; Win64; x64) |
| global_properties |
사용자를 위해 정의하고 저장할 수 있는 키-값 쌍입니다. 한번 정의된 값은 이후의 모든 호출에서 유지되어야 합니다. 값을 전송하지 않으면 값이 설정 해제된 것으로 간주됩니다. |
선택 사항 글로벌 속성은 최대 5개까지 지원되며, 각 속성은 200자 길이여야 합니다. URL로 인코딩된 JSON 객체여야 합니다. |
%7B%22key1%22%3A%22value1%22%2C% |
| install | 설치 플래그. 앱을 설치한 후 첫 번째 세션인 경우 'true'를 반환합니다. 그렇지 않으면 'false'를 반환합니다. 재설치 추적 기능에 필요합니다. |
선택 사항 부울 |
true |
| utime | 게임 실행 시간(유닉스 시간 기준)입니다. | 선택 사항 | 1483228800 |
| umilisec | 게임 실행 시간(밀리초, 유닉스 시간 기준)입니다. | 선택 사항 | 1483228800000 |
| custom_user_id |
사용자 ID |
선택 사항 | 123456789abcd |
이벤트 알림 엔드포인트
| GET | https://s2s.singular.net/api/v1/evt |
이벤트 알림 엔드포인트를 사용하여 원하는 모든 선택적 인게임 이벤트를 가능한 한 실시간으로 이 엔드포인트에 보고합니다. 인게임 이벤트 전달은 적극 권장되며 분석, 보고, 최적화를 위해 다양한 파트너에게 전달하는 데 사용됩니다.
이벤트 파라미터
| 파라미터 | 설명 | 제약 조건 | 예시 |
|---|---|---|---|
| a | "개발자 도구 -> SDK 통합 -> SDK 키"에서 단일 계정의 "SDK" 키를 확인하세요. | 필수 | your_org_name_sh868sdjv |
| p | 게임 플랫폼은 지원되는 값을 따라야 합니다: pc, xbox, playstation, nintendo, metaquest |
필수 지원되는 값만 |
pc |
| i | 고유한 게임 식별자 값입니다. 동일한 게임을 여러 플랫폼에 배포하는 경우 동일한 값을 사용하세요. |
필수 역방향 DNS 표기법 대소문자 구분 |
com.singular.app |
| sdid |
사용자의 고유한 설치 및 게임 활동을 식별하는 데 사용되는 단일 기기 ID입니다. 이 UUID는 게임을 처음 실행(설치)할 때 게임/서버에서 생성해야 하며, 앱 설치 기간 내내 유지되어야 합니다. |
UUID | 49c2d3a6-326e-4ec5-a16b-0a47e34ed953 |
| n |
게임 내 이벤트의 이름입니다. |
필수 | sng_achievement_unlocked |
| e |
이벤트에 대한 풍부한 정보를 JSON 형식으로 제공하는 사용자 지정 이벤트 속성입니다. |
선택 사항 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 |
운영 체제/게임 시스템 사용자 지정 값이 지원되지만 권장되는 값은 다음과 같습니다. |
필수 사용자 지정 값 지원 |
Platform = PC
Platform = XBox
Platform = Playstation
Platform = Nintendo
Platform = Meta Quest
|
| ve | 운영 체제 버전 | 선택 사항 | 22H2 |
| av | 애플리케이션 버전 또는 게임 버전 | 선택 사항 | 1.1.5.581823a |
| ip |
게임 내 이벤트가 발생한 시점의 디바이스 IP 주소입니다. |
선택 사항 | 172.58.29.235 |
| use_ip | HTTP 요청에서 IP 필드를 추출합니다. 이 옵션을 true로 설정하는 경우 "ip" 매개변수를 제공하지 마세요.v |
선택 사항 부울 |
false |
| install_source |
게임을 배포한 게임 스토어의 이름입니다. 사용자 지정 값이 지원되지만 권장되는 값은 다음과 같습니다. |
필수 |
steam epicgamestore microsoftstore gog humblestore xbox playstation nintendo selfdistributed [custom]
|
| ua | 디바이스의 사용자 에이전트 | 선택 사항 |
Mozilla/5.0 (Windows NT 10.0; Win64; x64) |
| global_properties |
사용자를 위해 정의하고 저장할 수 있는 키-값 쌍입니다. 한번 정의된 값은 이후의 모든 호출에서 유지되어야 합니다. 값을 전송하지 않으면 값이 설정 해제된 것으로 간주됩니다. |
선택 사항 글로벌 속성은 최대 5개까지 지원되며, 각 속성은 200자 길이여야 합니다. URL로 인코딩된 JSON 객체여야 합니다. |
%7B%22key1%22%3A%22value1%22%2C% |
| utime | 게임 실행 시간(유닉스 시간 기준)입니다. | 선택 사항 | 1483228800 |
| umilisec | 게임 실행 시간(밀리초, 유닉스 시간 기준)입니다. | 선택 사항 | 1483228800000 |
| custom_user_id |
사용자 ID |
선택 사항 | 123456789abcd |