GShare

GShare는 게임 개발자가 인게임 구매를 하지 않은 사용자로부터 수익을 올릴 수 있도록 돕는 솔루션입니다. 사용자가 데스크톱 앱을 설치하면 해당 앱은 PC의 리소스를 활용하게 되며 사용자는 인게임 구매 지불에 사용할 수 있는 인게임 잔액을 보상으로 얻게 됩니다. 주요 기능:

  • Microsoft Windows 10 이상 지원
  • 브랜드 필요에 따른 앱 사용자 정의
  • 20개 언어로 UI 현지화. 기본 언어: 영어, 러시아어. 추가하려면 계정 관리자에게 문의해주세요
  • 더 나은 리소스 최적화를 위한 구성 옵션(CPU 및/또는 GPU)
  • 최소 보상 금액 설정
  • 사용자의 인게임 잔액으로 직접 지불

Note: GShare를 통합하려면 페이 스테이션스토어를 활성화된 게임머니 모듈과 연결해야 합니다.

통합 플로우

GShare 통합에는 두 가지 유형이 있습니다.

사용자 정의된 앱

게임의 필요에 따라 기본 GShare 앱을 사용자 정의하려면 이 통합 유형을 선택합니다. 이러한 GShare 빌드에 링크를 놓을 수 있습니다.

Note: 이 통합 유형은 한 번에 하나의 게임만 지원합니다. 사용자가 서로 다른 게임에서 작동하는 여러 GShare 빌드를 다운로드하여 설치하고 GShare를 실행할 게임을 선택하려면 기본 앱 통합 유형을 선택합니다. 이러한 유형을 사용하면 사용자는 기본 GShare 빌드만 다운로드하여 설치할 수 있으며 엑솔라 번호를 통해 인증하게 됩니다.

선행 조건

엑솔라 방문 페이지, 자체 방문 페이지 또는 사용자의 게임 계정에 링크를 배치하려면 먼저 다음 설정을 적용해야 합니다.

  1. 페이 스테이션 설정으로 이동하여 퍼블릭 사용자 ID를 통한 사용자 인증을 활성화합니다. 이는 게임 및 GShare 인증을 위한 고유한 사용자 식별자입니다(예: 사용자 이메일 또는 닉네임).
  2. 사용자 검색 웹훅을 설정합니다.

사용자 정의된 빌드 준비

계정 관리자에게 문의하거나 다음 정보를 포함하는 이메일을 am@xsolla.com으로 보냅니다.

  • 최소 보상 금액(게시자 계정의 게임머니 모듈 설정에서 지정한 게임머니 단위와 금액이 일치해야 함).
  • 사용자 정의된 앱 스타일의 UIStyle.json.
  • 변경하려는 UI 텍스트.
  • ICO 형식으로 된 앱 아이콘. 크기: 32x32 px 및 128x128 px.
  • SVG 형식으로 된 방문 화면 이미지.

기본 UIStyle.json 예시:

{
    "common": {
        "background_color": "#121217",
        "card_background_color": "#1b1b24",
        "prime_color": "#0096d1",
        "text_color": "#ffffff",
        "input_color": "#2e2e3a"
    }
}

필드 설명:

  • background_color — 앱 배경 색
  • card_background_color — 블록 및 대화 상자 배경 색
  • prime_color — 다양한 UI 요소 강조 색(예: 콜투액션 버튼)
  • text_color — 텍스트 색
  • input_color — 입력 필드 색

Info: 사용자 정의된 빌드를 준비하는 데에는 보통 3~5 영업일이 소요됩니다.

다음 정보를 계정 관리자에게 제공합니다.

  • 변경하려면 방문 페이지 텍스트. 기본 엑솔라 방문 페이지를 참조합니다.
  • 자체 도메인 이름에 해당하는 URL(옵션). 기본값으로 방문 페이지는 엑솔라 도메인으로 게시되며 <landing_name>.xsollasitebuilder.com 형식으로 URL이 표시됩니다. URL에 방문 페이지를 올바르게 표시하려면 DNS 설정에서 <landing_name>.xsollasitebuilder.com으로 CNAME 레코드를 추가합니다.

Info: 사용자 정의 빌드 준비는 엑솔라에서 수행하며 보통 3~5 영업일이 소요됩니다. 방문 페이지는 엑솔라 웹사이트 빌더를 통해 생성되고 게시됩니다.

방문 페이지에 다음 스크립트를 추가합니다.

<script>
function downloadGShare() {
let partnerId = 1;
let userId = 'some_user_id';
let link =  'https://api-generator.xsolla.com/gshare-dists?partner_id=' + partnerId + '&user_login=' + userId;
window.open(link, "_top");
}
</script>
<input value="Download GShare" onclick="downloadGShare()" type="button">

partner_id 매개변수의 GShare 데이터베이스에서 파트너 ID를 전달해야 합니다. partner_id 값을 가져오려면 계정 관리자에게 문의해주세요.

user_login 매개변수에 있는 사용자 ID(v1)을 전달할 수도 있습니다. 값을 전달하지 않기로 결정한 경우 사용자가 앱을 다운로드하려면 퍼블릭 사용자 ID를 입력해야 합니다.

결제 UI에 GShare 배너를 표시하고 사용자를 자체 방문 페이지로 리디렉션하려면 계정 관리자에게 문의하거나 am@xsolla.com으로 이메일을 보내 주세요. 사용자는 결제 상태 페이지에서 배너를 보게 됩니다.

사용자의 게임 계정에 다음 스크립트 추가:

<script>
function downloadGShare() {
let partnerId = 1;
let userId = 'some_user_id';
let link =  'https://api-generator.xsolla.com/gshare-dists?partner_id=' + partnerId + '&user_login=' + userId;
window.open(link, "_top");
}
</script>
<input value="Download GShare" onclick="downloadGShare()" type="button">

partner_id 매개변수의 GShare 데이터베이스에서 파트너 ID를 전달해야 합니다. partner_id 값을 가져오려면 계정 관리자에게 문의해주세요.

user_login 매개변수에 있는 사용자 ID(v1)을 전달할 수도 있습니다. 값을 전달하지 않기로 결정한 경우 사용자가 앱을 다운로드하려면 퍼블릭 사용자 ID를 입력해야 합니다.

기본 앱

기본 설정으로 기본 GShare 앱을 사용하려면 이 통합 유형을 선택합니다. 결제 UI에 있는 배너에만 이 GShare 빌드 링크를 배치할 수 있습니다.

배너가 결제 상태 페이지에 나타납니다. 배너를 클릭하면 기본 GShare 앱을 다운로드할 수 있는 링크가 있는 방문 페이지로 사용자를 리디렉션합니다. 사용자가 앱을 다운로드하면 고유 식별자인 엑솔라 번호를 받게 됩니다. 이는 다운로드시 생성되며, 특정 게임에서 특정 빌드를 선택할 수 있는 기능이 있는 다양한 빌드를 지원할 수 있게 됩니다. 사용자는 앱을 설치하고 실행한 후 빌드를 선택합니다. 예제를 참조해주세요.

결제 UI에 GShare 배너를 표시하려면 계정 관리자에게 문의하거나 am@xsolla.com으로 이메일을 보냅니다. 메시지 내용에 최소 보상 금액을 명시해야 합니다(게시자 계정의 게임머니 모듈 설정에서 지정한 게임머니 단위와 금액이 일치해야 함).

Note: 서로 다른 게임에 사용하는 여러 기본 빌드가 있는 경우 각 게임의 결제 UI에 각각에 해당하는 배너를 표시할 수 있습니다. 사용자는 모든 빌드를 다운로드하여 설치할 수 있으며 GShare를 실행할 게임을 선택할 수 있습니다.