상품 판매를 위한 사이트 구성 방법

자체 사이트를 사용하면 타사 플랫폼 수수료 없이 아이템을 판매하고 게임 수익화를 개선할 수 있습니다. 사이트 템플릿을 사용하면 가상 아이템, 인게임 재화 패키지, 번들, 게임 키를 판매할 수 있습니다. 스토어 블록을 통해 아이템을 판매하거나 구매 버튼을 사용하는 방법은 아래에 설명되어 있습니다.

사용자 절차:

사용자가 사이트로 이동합니다.
사용자가 구매 버튼을 클릭합니다.
인증 또는 이메일 입력을 위한 모달 창이 열립니다(아이템 유형에 따라 다름).
사용자가 열린 결제 인터페이스에서 구매를 완료합니다.

이 지침에는 기본 스토어 설정과 사이트에 연결하는 방법이 설명되어 있습니다. 특정 아이템 유형 판매에 대한 자세한 내용은 다음 섹션을 참조하십시오:

상품을 판매하도록 사이트를 구성하는 방법:

아이템 카탈로그를 생성합니다.
스토어 블록 또는 구매 버튼을 추가합니다.

카탈로그 생성

사이트에서 다음과 같은 아이템 유형을 판매할 수 있습니다:

인게임 재화 패키지
가상 아이템
게임 키
번들

카탈로그를 생성하려면 관리자 페이지, API 호출을 사용하거나 JSON 파일 또는 외부 플랫폼에서 카탈로그를 가져올 수 있습니다.

인게임 재화 생성

인게임 재화는 가상 현금으로 인게임 아이템 구매 및 판매에 사용됩니다. 목적에 따라 인게임 재화는 게임 경제 균형에 영향을 주거나 앱의 수익화와 관련되어 있습니다. 경화를 생성하실 수도 있습니다. 구매 플랫폼에 연결된 인게임 재화는 실질 화폐로만 구매할 수 있습니다.

사전 정의한 액수의 인게임 재화를 판매할 수 있습니다. 패키지용으로는 해당 패키지 안의 인게임 재화 액수와 같지 않은 특별한 가격을 정의할 수 있습니다.

인게임 재화 섹션을 참조하여 인게임 재화에 대해 자세히 알아보세요.

인게임 재화 설정 방법:

관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 인게임 재화 섹션으로 이동합니다.
새로운 인게임 재화를 클릭합니다.
지정:
- 이미지(선택 사항).
- SKU.
- 이름.
- 실제 화폐 및 인게임 재화 가격.
- 기본 통화.
- 특성(선택 사항).

가격은 실제 또는 인게임 재화 중 하나 이상의 통화로 설정해야 합니다. 인게임 재화 금액은 정수로만 지정할 수 있습니다. 실제 통화로 지역별 가격을 설정하는 방법에 대한 자세한 내용은 문서에서 확인할 수 있습니다.

인게임 재화를 프리미엄 화폐로 정의할 수 있습니다. 이 화폐는 구매가 이루어지는 플랫폼과 관련이 있으며 실제 돈으로만 판매할 수 있습니다. 플랫폼별로 프리미엄 통화를 별도로 저장하도록 설정하려면 프리미엄 통화 토글을 켜짐으로 전환하세요.

통화는 생성 시점에만 프리미엄 통화로 지정할 수 있습니다.

인게임 재화 패키지 설정

인게임 재화 패키지를 생성하기 전에 먼저 패키지에 포함할 통화를 생성해야 합니다.

인게임 재화 패키지 설정 방법:

관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 인게임 재화 > 패키지 섹션으로 이동합니다.
새 패키지를 클릭합니다.

지정:
- 패키지 이미지(선택 사항).
- 패키지 SKU.
- 패키지 이름.
- 짧은 패키지 설명.
- 패키지용 인게임 재화.
- 실제 화폐 및 인게임 재화 가격.
- 기본 통화.
- 특성(선택 사항).

패키지에 하나의 인게임 재화 유형만 추가할 수 있습니다. 하나 이상의 실질 또는 인게임 재화로 인게임 재화 패키지 가격을 지정해야 합니다. 게임 재화 금액은 정숫값으로만 지정될 수 있습니다. 지역별 가격을 실제 통화로 설정하는 방법에 대한 자세한 내용은 문서에서 확인할 수 있습니다.

한 명의 사용자가 인게임 재화 패키지 구매 가능 횟수를 제한하려면 한 사용자가 패키지를 구매할 수 있는 횟수 제한 토글을 켜짐으로 전환하고 제한 횟수를 지정합니다.
스토어에 표시할 패키지 시간 제한을 설정하려면 스토어에 아이템 표시 필드에서 기간을 선택하고 표준 시간대, 기간의 시작 및 종료를 지정합니다. 패키지 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
설정을 확인한 후 패키지 생성을 클릭합니다.

가상 아이템, 인게임 재화 또는 인게임 재화 패키지를 생성한 후에는 해당 아이템의 상태를 설정하여 사용 가능, 사용 불가능 또는 일부 사용 가능 여부를 결정할 수 있습니다.

가상 아이템 만들기

가상 아이템은 실질 또는 인게임 재화를 받고 판매할 수 있는 인게임 콘텐츠입니다.

존재하는 3가지 유형의 가상 아이템:

소모성. 대량으로 구매 가능하며 여러 개를 구매할 수 있습니다. 사용자가 소모하면 수량이 줄어듭니다.
비소모성. 한 번만 획득하거나 구매할 수 있는 아이템입니다. 사용자 인벤토리에 보관되며 클라이언트 측에서 소모되어도 인벤토리에서 제거되지 않습니다. 서버 메서드를 통해서만 회수할 수 있습니다.
사용기간 제한 아이템. 비소모성 아이템으로 제한된 기간만 사용할 수 있으며 만료되었을 때 인벤토리에서 사라지지 않습니다. 이 아이템을 활성화하려면 사용자가 다시 구매해야 합니다.

가상 아이템 섹션을 참조하여 가상 아이템에 대해 자세히 알아보세요.

가상 아이템을 설정하려면 가상 아이템 그룹을 구성해야 합니다. 그룹은 다단계 카탈로그를 보유할 수 있게 하고 스토어에 아이템 표시를 관리하게 해 줍니다.

가상 아이템 그룹 생성 방법:

관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 가상 아이템 섹션으로 이동합니다.
+를 클릭한 후 드롭다운 목록에서 그룹 생성을 선택합니다.

다음 매개 변수를 지정합니다:
- 그룹 코드.
- 그룹 이름.
카탈로그에 그룹을 표시하려면 스토어에 그룹 표시 토글을 켜짐으로 설정합니다.

그룹 생성을 클릭합니다.

지정 그룹이 없는 아이템은 그룹화되지 않은 그룹에 추가됩니다.

가상 아이템 설정 방법:

관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 가상 아이템 섹션으로 이동합니다.
+를 클릭한 후 드롭다운 목록에서 아이템 생성을 선택합니다.

지정:
- 이미지(선택 사항).
- SKU.
- 아이템이 속해 있는 하나 또는 여러 그룹.
- 이름.
- 설명(선택 사항).

아이템 설명은 255개 기호로 제한됩니다. 255개 이상의 기호로 설명을 추가해야 하는 경우 고객 성공 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 전송하십시오.

아이템 특성: 소모품, 비소모품 또는 시한성 아이템다.
실제 재화 또는 인게임 재화로 표시된 가격.

실질 또는 인게임 재화로 가격을 지정하지 않고 아이템을 만들 수 없습니다. 가격 값이 0인 아이템은 만들 수 없습니다. 실제 통화로 가격을 설정하는 방법에 대한 자세한 내용은 문서에서 확인할 수 있습니다.

아이템 구매 한도를 설정(선택 사항)합니다. 이렇게 하려면 한 사용자가 이 아이템을 구매할 수 있는 횟수 제한 토글을 켜짐으로 전환하고 사용자가 구매할 수 있는 아이템 수를 지정합니다.
스토어에 표시할 아이템 시간 제한을 설정하려면 스토어에 아이템 표시 필드에서 기간을 선택하고 표준 시간대, 기간의 시작 및 종료를 지정합니다. 패키지 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
설정을 확인한 후 아이템 생성을 클릭합니다.

번들 만들기

번들은 하나의 유닛으로 판매되는 여러 개의 아이템입니다. 번들에 추가할 수 있는 여러 아이템 유형:

인게임 재화.
인게임 재화 패키지.
사용기간 제한 아이템을 포함하는 가상 아이템.
번들.

번들에 대해 더 알아보시려면 번들 섹션을 참조하세요.

번들 설정 방법:

관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 번들 섹션으로 이동합니다.
+를 클릭한 후 드롭다운 목록에서 번들 생성을 선택합니다.

지정:
- 이미지(선택 사항).
- SKU.
- 이름.
- 설명(선택 사항).
- 콘텐츠.
번들 가격을 설정합니다. 가격을 지정하거나 무료 번들을 생성합니다:
1. 가격 정의 또는 무료 번들 생성:
주의
같은 번들 또는 물리적 상품을 번들에 추가할 수 없습니다. 빈 번들을 생성할 수 없습니다.
알림
실물 화폐 또는 인게임 재화로 가격을 지정하지 않아도 번들을 생성할 수 있습니다. 이러한 번들이 스토어에 표시되면 사용자가 무료로 사용할 수 있습니다. 현지 가격을 포함한 실제 통화로 가격을 설정하는 방법에 대한 자세한 정보는 문서에서 확인할 수 있습니다.
1. 번들을 위한 구매 한도(선택 사항)을 설정합니다. 이렇게 하려면 한 명의 사용자가 번들을 구매할 수 있는 횟수 제한 토글을 켜짐으로 설정하고 사용자가 구매할 수 있는 번들 수를 지정하십시오.
2. 다음을 클릭합니다.
3. 스토어에서 번들 표시 구성:
  - 상태를 사용 가능으로 변경합니다.
  - 스토어에 번들을 표시할 시간 제한을 설정합니다(선택 사항). 이렇게 하려면 기간을 선택하고 시간대, 기간의 시작과 종료를 지정합니다. 아이템 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
4. 다음을 클릭합니다.
5. 설정을 확인한 후 저장을 클릭합니다.

관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 섹션에서 구성하려는 해당 아이템 유형으로 이동합니다:
카탈로그 관리 드롭다운 목록에서, 아이템 가져오기(JSON)를 선택합니다.

작업 선택 :
- 새 항목 추가 - 새 SKU가 있는 항목만 추가됩니다.
- 새 항목 추가 및 기존 항목 업데이트 - 새 SKU가 있는 항목이 추가되고 기존 항목의 데이터가 업데이트됩니다.
- 새 항목 추가, 기존 항목 업데이트, 누락 항목 비활성화 - 파일에서 SKU가 있는 항목이 추가/업데이트됩니다. 카탈로그에는 항목이 있지만 파일에 해당 SKU가 없는 경우 관리자 페이지에서 항목 상태가 부분적으로 사용 가능으로 표시되며, 이 경우 항목을 별도로 구매할 수 없지만 번들 또는 보너스의 일부로 사용할 수 있습니다.

가져올 파일 작성하기:
- 다운로드 창에서 파일 템플릿을 다운로드하고 아래 예시에 따라 파일을 작성합니다.
- 항목을 내보내고 내보낸 파일을 템플릿으로 사용합니다.
- 자체 JSON 파일을 생성하여 아래 예시에 따라 작성합니다.

전체 JSON 파일의 예시:

Copy

Full screen

Small screen

  1{
  2    "virtual_currency": [
  3        {
  4            "sku": "Gem_test_import",
  5            "name": {
  6                "en": "Gem_test_import"
  7            },
  8            "type": "virtual_currency",
  9            "description": {
 10                "en": "my test imported currency"
 11            },
 12            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
 13            "description": {
 14                "en": "my test imported currency",
 15                "de": "meine importierte Testwährung"
 16            },
 17            "attributes": [],
 18            "is_free": false,
 19            "order": 1,
 20            "groups": [],
 21            "regional_prices": [],
 22            "prices": [
 23                {
 24                    "amount": 2,
 25                    "currency": "USD",
 26                    "is_default": true,
 27                    "is_enabled": true
 28                }
 29            ],
 30            "media_list": [],
 31            "vc_prices": [],
 32            "is_enabled": true,
 33            "is_show_in_store": true,
 34            "regions": [],
 35            "limits": {
 36                "per_user": null,
 37                "per_item": null,
 38                "recurrent_schedule": null
 39            },
 40            "periods": [],
 41            "inventory_options": {
 42                "consumable": true,
 43                "expiration_period": null
 44            },
 45            "is_hard": false
 46        }
 47    ],
 48    "virtual_items": [
 49        {
 50            "sku": "event_access_test_import",
 51            "name": {
 52                "en": "Special Event Access_test_import"
 53            },
 54            "type": "virtual_good",
 55            "description": {
 56                "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
 57            },
 58            "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
 59            "long_description": null,
 60            "attributes": [],
 61            "is_free": false,
 62            "order": 1,
 63            "groups": [
 64                "my_test_group"
 65            ],
 66            "regional_prices": [],
 67            "prices": [
 68                {
 69                    "amount": 35,
 70                    "currency": "USD",
 71                    "is_default": true,
 72                    "is_enabled": true
 73                }
 74            ],
 75            "media_list": [],
 76            "vc_prices": [],
 77            "is_enabled": true,
 78            "is_show_in_store": true,
 79            "regions": [],
 80            "limits": {
 81                "per_user": null,
 82                "per_item": null,
 83                "recurrent_schedule": null
 84            },
 85            "periods": [],
 86            "inventory_options": {
 87                "consumable": true,
 88                "expiration_period": null
 89            }
 90        }
 91    ],
 92    "virtual_currency_packages": [
 93        {
 94            "item_id": 441982,
 95            "sku": "small_gold_pack_test_import",
 96            "type": "bundle",
 97            "name": {
 98                "en": "Small gold pack"
 99            },
100            "bundle_type": "virtual_currency_package",
101            "description": {
102                "en": "Gold x100"
103            },
104            "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
105            "vc_prices": [],
106            "regional_prices": [],
107            "prices": [
108                {
109                    "amount": 5,
110                    "currency": "USD",
111                    "is_default": true,
112                    "is_enabled": true
113                }
114            ],
115            "is_enabled": true,
116            "is_show_in_store": true,
117            "regions": [],
118            "limits": {
119                "per_user": null,
120                "per_item": null,
121                "recurrent_schedule": null
122            },
123            "periods": [],
124            "attributes": [],
125            "long_description": null,
126            "media_list": [],
127            "order": 100000000,
128            "is_free": false,
129            "groups": [],
130            "content": [
131                {
132                    "sku": "Gem_test_import",
133                    "quantity": 100
134                }
135            ]
136        }
137    ],
138    "bundles": [
139        {
140            "item_id": 684024,
141            "sku": "start_pack_test_import_test_import",
142            "type": "bundle",
143            "name": {
144                "en": "Legendary Start Pack"
145            },
146            "bundle_type": "standard",
147            "description": {
148                "en": "Crystal x 1\nGem x 1"
149            },
150            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
151            "regional_prices": [],
152            "prices": [
153                {
154                    "amount": 20,
155                    "currency": "USD",
156                    "is_default": true,
157                    "is_enabled": true
158                }
159            ],
160            "virtual_prices": [],
161            "is_enabled": true,
162            "is_show_in_store": true,
163            "regions": [],
164            "limits": {
165                "per_user": null,
166                "per_item": null,
167                "recurrent_schedule": null
168            },
169            "periods": [],
170            "attributes": [],
171            "long_description": null,
172            "media_list": [],
173            "order": 5,
174            "is_free": false,
175            "groups": [
176                "my_test_group"
177            ],
178            "content": [
179                {
180                    "sku": "Gem_test_import",
181                    "quantity": 1
182                },
183                {
184                    "sku": "event_access_test_import",
185                    "quantity": 1
186                }
187            ]
188        }
189    ]
190}

가져오기 창의 해당 필드에 전체 파일을 업로드합니다.
가져오는 동안 오류가 발생하면 가져오기 창에 오류 목록과 수정 권장 사항이 표시됩니다. 파일을 필요에 따라 변경한 후 다시 업로드합니다.

업로드에 성공하면 지정된 SKU를 가진 항목이 생성, 업데이트 또는 비활성화됩니다.

JSON 파일을 통해 아이템 가져오기 API 호출을 사용하여 아이템을 가져올 수도 있습니다.

JSON 파일을 통해 아이템을 가져오는 방법에 대한 자세한 내용은 지침을 참조하세요.

외부 플랫폼(예: Google Play 또는 앱 스토어)에서도 카탈로그를 가져올 수 있습니다.

스토어 블록 또는 구매 버튼 생성

스토어 블록은 웹 사이트에서 아이템 카탈로그를 판매하는 데 사용됩니다. 이 블록에는 판매용으로 선택한 그룹의 모든 아이템이 표시됩니다. 구매 버튼은 개별 아이템을 판매하기 위한 도구입니다. 이 버튼은 빌더의 여러 블록에서 사용할 수 있습니다. 이 버튼을 사용하면 번들과 게임 키만 판매할 수 있습니다.