Singular는 분석 및 어트리뷰션을 위해 모든 PC 및 콘솔 게임 전환 데이터를 Singular에 보고하는 데 사용할 수 있는 REST API를 제공합니다.

이 가이드는 Singular와 PC 및 콘솔 S2S 연동을 구축하고 다양한 옵션 기능을 구현하는 방법을 설명합니다.

연동 개념

이 섹션에서는 완벽한 PC 및 콘솔 S2S 연동 기능을 구현하는 데 중요한 주요 개념을 자세히 설명합니다.

S2S API 엔드포인트, 해당 매개변수 및 샘플 호출의 전체 목록은 PC & 콘솔 S2S 엔드포인트 참조를 참조하세요.

사용자 개인정보 보호

사용자 개인정보를 보호하기 위해, Singular는 게임 개발자가 최종 사용자가 추적에 옵트인 또는 옵트아웃할 수 있는 옵션을 제공할 것을 권장합니다. 사용자 데이터 처리에 대한 비즈니스 요구 사항에 따라 다음과 같이 할 수 있습니다:

• 옵트아웃 시 게임 이벤트 데이터를 Singular에 전송하지 않음
• 게임 이벤트 데이터를 Singular로 전송하되, 사용자의 옵트인 및 옵트아웃 동의 선택 사항을 포함합니다. 이러한 경우, data_sharing_options 파라미터의 "데이터 공유 제한" 값을 통해 이 동의 플래그를 구현하고 전달하세요.
  
  

인증

Singular의 PC 및 콘솔 S2S API에 대한 모든 요청에는 "a=" 매개변수로 전송할 SDK 키가 필요합니다. Singular 대시보드의"개발자 도구 -> SDK 연동 -> SDK 키"에서 Singular SDK 키를 찾을 수 있습니다.

지원 플랫폼, 게임 시스템 및 스토어

Singular의 "플랫폼"은 사용자가 게임을 플레이하는 "플랫폼"으로 정의되며, 모든 S2S API 요청에"p=" 파라미터를 전달해야 합니다. 지원되는 "플랫폼" 값의 비공개 목록은 아래와 같습니다:

• pc
• xbox
• playstation
• nintendo
• metaquest

"플랫폼" 외에도 "운영/게임 시스템" 및 "스토어"는 각각"os=" 및"install_source=" 매개변수에 전달해야 합니다. 사용자 지정 값도 지원되지만 플랫폼별로 다음 값을 권장합니다:

플랫폼 (p=)	운영체제/게임 시스템 (os=)	스토어 (install_source=)
pc	windows 리눅스 macos steamos	steam 에픽게임스토어 마이크로 소프트 스토어 gog humblestore 자체 배포
xbox	xbox_one xbox_360 xbox_series_s xbox_series_x	xbox
플레이스테이션	playstation_3 playstation_4 playstation_5	플레이스테이션
nintendo	닌텐도_스위치	nintendo
메타퀘스트	메타퀘스트 메타퀘스트_2 메타퀘스트_프로	메타퀘스트

게임 식별자

Singular가 게임 이벤트를 게임과 연결하려면 모든 요청에 게임 식별자를"i=" 파라미터로 전달해야 합니다.

• 모든 값을 지원할 수 있지만, Singular는 역 DNS 표기법(예: com.singular.game)으로 값을 전달할 것을 권장합니다.
• 게임이 여러 플랫폼에서 제공되는 경우, 지원되는 플랫폼에서 동일한 게임에 대해 동일한 게임 식별자를 사용해야 합니다(예: p=pc&i=com.singular.game, p=xbox&i=com.singular.game, p=playstation&i=com.singular.game).
• Singular가 웹사이트 랜딩 페이지를 통해 유도된 웹 캠페인에 게임 전환을 제대로 어트리뷰션하려면, Singular 웹 연동의 '제품 ID'가 게임 식별자 값과도 일치해야 합니다.

고유한 게임 인스톨 식별

Singular가 동일한 게임 설치에 대해 여러 게임 세션에 걸쳐 게임 이벤트를 연결하려면 모든 요청에"sdid=" 매개변수에 설치/기기 식별자를 전달해야 합니다.

• 권장 UUID(버전 4) 형식
• 이 값은 게임을 처음 실행(설치)하는 시점에 게임/서버에서 생성되어야 하며, 게임 설치 기간 동안 지속되어야 합니다.

매치 ID(선택 사항)

게임의 웹 캠페인이 사용자를 웹 랜딩 페이지로 유도하고 웹사이트 -> PC/콘솔 게임 어트리뷰션에 "match ID"를 활용할 수 있는 경우,"match_id=" 파라미터에 "match ID"를 선택적으로 전달하여 어트리뷰션 정확도를 향상시킬 수 있습니다. PC 및 콘솔 어트리뷰션에 대한 자세한 내용은 해당 주제에 대한 FAQ를 참조하세요.

• 인스톨 어트리뷰션이 "매치 ID"를 사용하려면 사용자가 게임을 처음 실행할 때 전달해야 합니다.
• "매치 ID"는 Singular 웹 SDK 구현에서동일한 값의 사용자와 일치해야 합니다.

게임 출시 보고

PC 및 콘솔 연동에서는 모든 게임 세션을 Singular에 보고하는 것이 필수이며, 게임이 실행될 때마다 게임 세션이 전송될 것으로 예상합니다.

게임 세션에 대해 Singular에 알리려면 세션 알림 엔드포인트를 호출하세요.

세션 알림을 통해 Singular는 여러 가지 작업을 수행할 수 있습니다:

• 고유 인스톨 후 첫 번째 게임 세션인 경우( 고유 게임 인스톨 식별하기 참조), Singular는 새로운 인스톨을 인식하고 인스톨 어트리뷰션 프로세스를 트리거합니다.
• (곧 출시 예정) 게임 세션이 리인게이지먼트 세션에 해당하는 경우, Singular는 리인게이지먼트 어트리뷰션 프로세스를 트리거합니다( 리인게이지먼트 FAQ에서 자세히 알아보기).
• 그렇지 않으면 Singular는 이를 게임 세션으로 표시하여 사용자 활동 및 리텐션을 추적하는 데 사용합니다.

게임 내 이벤트 신고하기

이벤트

Singular는 마케팅 캠페인의 성과를 분석하기 위해 게임 내 이벤트에 대한 데이터를 수집할 수 있습니다. 이벤트에는 로그인 및 등록부터 게임 내 레벨업까지 모든 사용자 상호 작용이 포함될 수 있습니다.

Singular와 S2S 연동을 구현하기 전에 조직에서 추적하려는 이벤트 목록이 있어야 합니다( 게임 내 이벤트 정의하기 참조).

게임에서 이벤트가 발생하면 Singular에 알리려면 이벤트 알림 엔드포인트를 호출하세요. 호출에 포함하는 이벤트 이름은 Singular 보고서, 내보내기 및 포스트백에서 이벤트가 식별되는 방식입니다.

구매

Singular는 게임을 통해 얻은 구매에 대한 데이터를 수집하여 캠페인의 성과와 ROI를 분석하는 데 도움을 줄 수 있습니다. Singular는 보고서, 로그 내보내기, 포스트백에서 데이터를 사용할 수 있도록 합니다.

구매 이벤트를 추적하려면 모든 이벤트에 사용하는 것과 동일한 이벤트 알림 엔드포인트를 사용하되, 다음 정보를 추가하세요:

• is_revenue_event=true: 이벤트를 구매 이벤트로 표시합니다. 이벤트 이름이"__iap__"이거나 금액이 0보다 큰 경우 이 매개 변수를 건너뛸 수 있습니다.
• 구매 금액 (예:"amt=1.99").
• 통화 (ISO 4217 통화 코드 사용(예:"cur=USD")).