세션 알림 엔드포인트
| 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
플랫폼 = XBox
플랫폼 = 플레이스테이션
플랫폼 = 닌텐도
플랫폼 = 메타 퀘스트
|
| 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) |
| global_properties |
사용자를 위해 정의하고 저장할 수 있는 키 값 쌍입니다. 정의된 값은 이후의 모든 호출에서 유지되어야 합니다. 값을 보내지 않으면 값을 설정 해제하는 것으로 간주됩니다. |
선택 사항 글로벌 속성은 최대 5개까지 지원되며, 각각 200자 길이여야 합니다. URLEncoded JSON 개체여야 합니다. |
%7B%22key1%22%3A%22value1%22%2C% |
| 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
플랫폼 = XBox
플랫폼 = 플레이스테이션
플랫폼 = 닌텐도
플랫폼 = 메타 퀘스트
|
| 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) |
| global_properties |
사용자를 위해 정의하고 저장할 수 있는 키 값 쌍입니다. 정의된 값은 이후의 모든 호출에서 유지되어야 합니다. 값을 보내지 않으면 값을 설정 해제하는 것으로 간주됩니다. |
선택 사항 글로벌 속성은 최대 5개까지 지원되며, 각각 200자 길이여야 합니다. URLEncoded JSON 개체여야 합니다. |
%7B%22key1%22%3A%22value1%22%2C% |
| 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 |