상품 판매를 위한 사이트 구성 방법
자체 사이트를 사용하면 타사 플랫폼 수수료 없이 아이템을 판매하고 게임 수익화를 개선할 수 있습니다. 사이트 템플릿을 사용하면 가상 아이템, 인게임 재화 패키지, 번들, 게임 키를 판매할 수 있습니다. 스토어 블록을 통해 아이템을 판매하거나 구매 버튼을 사용하는 방법은 아래에 설명되어 있습니다.
사용자 절차:
- 사용자가 사이트로 이동합니다.
- 사용자가 구매 버튼을 클릭합니다.
- 인증 또는 이메일 입력을 위한 모달 창이 열립니다(아이템 유형에 따라 다름).
- 사용자가 열린 결제 인터페이스에서 구매를 완료합니다.
상품을 판매하도록 사이트를 구성하는 방법:
- 아이템 카탈로그를 생성합니다.
- 스토어 블록 또는 구매 버튼을 추가합니다.
카탈로그 생성
사이트에서 다음과 같은 아이템 유형을 판매할 수 있습니다:
- 인게임 재화 패키지
- 가상 아이템
- 게임 키
- 번들
카탈로그를 생성하려면 관리자 페이지, API 호출을 사용하거나 JSON 파일 또는 외부 플랫폼에서 카탈로그를 가져올 수 있습니다.
인게임 재화 생성
인게임 재화는 가상 현금으로 인게임 아이템 구매 및 판매에 사용됩니다. 목적에 따라 인게임 재화는 게임 경제 균형에 영향을 주거나 앱의 수익화와 관련되어 있습니다. 경화를 생성하실 수도 있습니다. 구매 플랫폼에 연결된 인게임 재화는 실질 화폐로만 구매할 수 있습니다.
사전 정의한 액수의 인게임 재화를 판매할 수 있습니다. 패키지용으로는 해당 패키지 안의 인게임 재화 액수와 같지 않은 특별한 가격을 정의할 수 있습니다.
인게임 재화 섹션을 참조하여 인게임 재화에 대해 자세히 알아보세요.
인게임 재화 설정 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 인게임 재화 섹션으로 이동합니다.
- 새로운 인게임 재화를 클릭합니다.
- 지정:
- 이미지(선택 사항).
- SKU.
- 이름.
- 실제 화폐 및 인게임 재화 가격.
- 기본 통화.
- 특성(선택 사항).
- 인게임 재화를 프리미엄 화폐로 정의할 수 있습니다. 이 화폐는 구매가 이루어지는 플랫폼과 관련이 있으며 실제 돈으로만 판매할 수 있습니다. 플랫폼별로 프리미엄 통화를 별도로 저장하도록 설정하려면 프리미엄 통화 토글을 켜짐으로 전환하세요.
인게임 재화 패키지 설정
인게임 재화 패키지 설정 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 인게임 재화 > 패키지 섹션으로 이동합니다.
- 새 패키지를 클릭합니다.
- 지정:
- 패키지 이미지(선택 사항).
- 패키지 SKU.
- 패키지 이름.
- 짧은 패키지 설명.
- 패키지용 인게임 재화.
- 실제 화폐 및 인게임 재화 가격.
- 기본 통화.
- 특성(선택 사항).
- 한 명의 사용자가 인게임 재화 패키지 구매 가능 횟수를 제한하려면 한 사용자가 패키지를 구매할 수 있는 횟수 제한 토글을 켜짐으로 전환하고 제한 횟수를 지정합니다.
- 스토어에 표시할 패키지 시간 제한을 설정하려면 스토어에 아이템 표시 필드에서 기간을 선택하고 표준 시간대, 기간의 시작 및 종료를 지정합니다. 패키지 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
- 설정을 확인한 후 패키지 생성을 클릭합니다.
가상 아이템 만들기
가상 아이템은 실질 또는 인게임 재화를 받고 판매할 수 있는 인게임 콘텐츠입니다.
존재하는 3가지 유형의 가상 아이템:
- 소모성. 대량으로 구매 가능하며 여러 개를 구매할 수 있습니다. 사용자가 소모하면 수량이 줄어듭니다.
- 비소모성. 한 번만 획득하거나 구매할 수 있는 아이템입니다. 사용자 인벤토리에 보관되며 클라이언트 측에서 소모되어도 인벤토리에서 제거되지 않습니다. 서버 메서드를 통해서만 회수할 수 있습니다.
- 사용기간 제한 아이템. 비소모성 아이템으로 제한된 기간만 사용할 수 있으며 만료되었을 때 인벤토리에서 사라지지 않습니다. 이 아이템을 활성화하려면 사용자가 다시 구매해야 합니다.
가상 아이템 섹션을 참조하여 가상 아이템에 대해 자세히 알아보세요.
가상 아이템을 설정하려면 가상 아이템 그룹을 구성해야 합니다. 그룹은 다단계 카탈로그를 보유할 수 있게 하고 스토어에 아이템 표시를 관리하게 해 줍니다.
가상 아이템 그룹 생성 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 가상 아이템 섹션으로 이동합니다.
- +를 클릭한 후 드롭다운 목록에서 그룹 생성을 선택합니다.
- 다음 매개 변수를 지정합니다:
- 그룹 코드.
- 그룹 이름.
- 카탈로그에 그룹을 표시하려면 스토어에 그룹 표시 토글을 켜짐으로 설정합니다.
- 그룹 생성을 클릭합니다.
가상 아이템 설정 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 가상 아이템 섹션으로 이동합니다.
- +를 클릭한 후 드롭다운 목록에서 아이템 생성을 선택합니다.
- 지정:
- 이미지(선택 사항).
- SKU.
- 아이템이 속해 있는 하나 또는 여러 그룹.
- 이름.
- 설명(선택 사항).
- 아이템 특성: 소모품, 비소모품 또는 시한성 아이템다.
- 실제 재화 또는 인게임 재화로 표시된 가격.
- 아이템 구매 한도를 설정(선택 사항)합니다. 이렇게 하려면 한 사용자가 이 아이템을 구매할 수 있는 횟수 제한 토글을 켜짐으로 전환하고 사용자가 구매할 수 있는 아이템 수를 지정합니다.
- 스토어에 표시할 아이템 시간 제한을 설정하려면 스토어에 아이템 표시 필드에서 기간을 선택하고 표준 시간대, 기간의 시작 및 종료를 지정합니다. 패키지 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
- 설정을 확인한 후 아이템 생성을 클릭합니다.
번들 만들기
번들은 하나의 유닛으로 판매되는 여러 개의 아이템입니다. 번들에 추가할 수 있는 여러 아이템 유형:
- 인게임 재화.
- 인게임 재화 패키지.
- 사용기간 제한 아이템을 포함하는 가상 아이템.
- 번들.
번들에 대해 더 알아보시려면 번들 섹션을 참조하세요.
번들 설정 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 번들 섹션으로 이동합니다.
- +를 클릭한 후 드롭다운 목록에서 번들 생성을 선택합니다.
- 지정:
- 이미지(선택 사항).
- SKU.
- 이름.
- 설명(선택 사항).
- 콘텐츠.
- 번들 가격을 설정합니다. 가격을 지정하거나 무료 번들을 생성합니다:
- 가격 정의 또는 무료 번들 생성:
- 무료 번들을 생성하려면 유료 또는 무료 필드에서 무료 번들을 선택하십시오.
- 가격을 설정하고 유료 또는 무료 필드에서 유료 번들을 선택한 후 실제 또는 인게임 재화로 가격을 지정합니다. 필요할 경우, 지역별 가격을 구성합니다.
- 번들을 위한 구매 한도(선택 사항)을 설정합니다. 이렇게 하려면 한 명의 사용자가 번들을 구매할 수 있는 횟수 제한 토글을 켜짐으로 설정하고 사용자가 구매할 수 있는 번들 수를 지정하십시오.
- 다음을 클릭합니다.
- 스토어에서 번들 표시 구성:
- 상태를 사용 가능으로 변경합니다.
- 스토어에 번들을 표시할 시간 제한을 설정합니다(선택 사항). 이렇게 하려면 기간을 선택하고 시간대, 기간의 시작과 종료를 지정합니다. 아이템 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
- 다음을 클릭합니다.
- 설정을 확인한 후 저장을 클릭합니다.
Shop Builder API 호출로 카탈로그 생성 및 업데이트를 자동화할 수 있습니다. 자동화를 도입하면 시간을 적게 들여도 카탈로그를 최신 상태로 유지할 수 있습니다. 카탈로그 자동화를 사용하면 아이템과 프로모션을 생성 및 업데이트하고, 외부 시스템에서 데이터를 가져올 수 있습니다.
기본 인증은 아이템과 프로모션을 생성하고 업데이트하는 API 호출에 사용됩니다. Authorization:Basic <your_authorization_basic_key>
를 전달합니다. 여기에서 <your_authorization_basic_key>
는 Base64 표준으로 인코딩된 판매자 ID:API 키 쌍입니다. 이러한 매개 변수를 찾으려면 관리자 페이지으로 이동합니다.
- 판매자 ID 표시 위치:
- 회사 설정 > 회사 섹션.
- 관리자 페이지의 브라우저 주소 표시줄에 있는 URL. 해당 URL은
https://publisher.xsolla.com/<merchant_id>/
형식으로 되어 있습니다.
- API 키는 생성할 때 한 번만 관리자 페이지에 표시되며 따로 저장하고 관리해야 합니다. 다음 섹션에서 새 키를 생성할 수 있습니다.
API를 통해 아이템 생성 방법:
- 시스템에서 아이템 데이터를 내보냅니다.
- 내보낸 데이터의 형식을 필요한 아이템 유형의 API 호출의 데이터 형식과 일치하도록 변환합니다.
- 내보내기의 각 아이템에 필요한 API 메서드를 호출하는 스크립트를 생성합니다.
아이템 그룹을 사용하려면 관리자 페이지에서 아이템 그룹을 미리 생성하세요.
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 섹션에서 구성하려는 해당 아이템 유형으로 이동합니다:
- 카탈로그 관리 드롭다운 목록에서, 아이템 가져오기(JSON)를 선택합니다.
- 작업 선택 :
- 새 항목 추가 - 새 SKU가 있는 항목만 추가됩니다.
- 새 항목 추가 및 기존 항목 업데이트 - 새 SKU가 있는 항목이 추가되고 기존 항목의 데이터가 업데이트됩니다.
- 새 항목 추가, 기존 항목 업데이트, 누락 항목 비활성화 - 파일에서 SKU가 있는 항목이 추가/업데이트됩니다. 카탈로그에는 항목이 있지만 파일에 해당 SKU가 없는 경우 관리자 페이지에서 항목 상태가 부분적으로 사용 가능으로 표시되며, 이 경우 항목을 별도로 구매할 수 없지만 번들 또는 보너스의 일부로 사용할 수 있습니다.
- 가져올 파일 작성하기:
- 다운로드 창에서 파일 템플릿을 다운로드하고 아래 예시에 따라 파일을 작성합니다.
- 항목을 내보내고 내보낸 파일을 템플릿으로 사용합니다.
- 자체 JSON 파일을 생성하여 아래 예시에 따라 작성합니다.
전체 JSON 파일의 예시:
- json
1{
2 "virtual_currency": [
3 {
4 "item_id": 952122,
5 "sku": "11cog1005",
6 "name": {
7 "en": "Gearlings"
8 },
9 "type": "virtual_currency",
10 "description": null,
11 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/c9fac97d44242e73c4b74e9b5c7b3ae0.webp",
12 "long_description": null,
13 "attributes": [],
14 "is_free": true,
15 "order": 1,
16 "groups": [],
17 "regional_prices": [],
18 "prices": [],
19 "media_list": [],
20 "vc_prices": [],
21 "is_enabled": true,
22 "is_show_in_store": true,
23 "regions": [],
24 "limits": {
25 "per_user": null,
26 "per_item": null,
27 "recurrent_schedule": null
28 },
29 "periods": [],
30 "inventory_options": {
31 "consumable": true,
32 "expiration_period": null
33 },
34 "is_hard": false
35 },
36 {
37 "item_id": 952108,
38 "sku": "11cog1003",
39 "name": {
40 "en": "Brass Bits"
41 },
42 "type": "virtual_currency",
43 "description": null,
44 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/26232b5a9e550818f094f769b388a4a2.webp",
45 "long_description": null,
46 "attributes": [],
47 "is_free": true,
48 "order": 1,
49 "groups": [],
50 "regional_prices": [],
51 "prices": [],
52 "media_list": [],
53 "vc_prices": [],
54 "is_enabled": true,
55 "is_show_in_store": true,
56 "regions": [],
57 "limits": {
58 "per_user": null,
59 "per_item": null,
60 "recurrent_schedule": null
61 },
62 "periods": [],
63 "inventory_options": {
64 "consumable": true,
65 "expiration_period": null
66 },
67 "is_hard": false
68 },
69 {
70 "item_id": 952103,
71 "sku": "11cog1002",
72 "name": {
73 "en": "Steam Tokens"
74 },
75 "type": "virtual_currency",
76 "description": null,
77 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/2985a68253dd10c0d1edbed1d11d1c00.webp",
78 "long_description": null,
79 "attributes": [],
80 "is_free": true,
81 "order": 1,
82 "groups": [],
83 "regional_prices": [],
84 "prices": [],
85 "media_list": [],
86 "vc_prices": [],
87 "is_enabled": true,
88 "is_show_in_store": true,
89 "regions": [],
90 "limits": {
91 "per_user": null,
92 "per_item": null,
93 "recurrent_schedule": null
94 },
95 "periods": [],
96 "inventory_options": {
97 "consumable": true,
98 "expiration_period": null
99 },
100 "is_hard": false
101 },
102 {
103 "item_id": 952092,
104 "sku": "11cog1001",
105 "name": {
106 "en": "Cogcoins"
107 },
108 "type": "virtual_currency",
109 "description": null,
110 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/5af6212dba648b7a9192311a786baf5a.webp",
111 "long_description": null,
112 "attributes": [],
113 "is_free": true,
114 "order": 1,
115 "groups": [],
116 "regional_prices": [],
117 "prices": [],
118 "media_list": [],
119 "vc_prices": [],
120 "is_enabled": true,
121 "is_show_in_store": true,
122 "regions": [],
123 "limits": {
124 "per_user": null,
125 "per_item": null,
126 "recurrent_schedule": null
127 },
128 "periods": [],
129 "inventory_options": {
130 "consumable": true,
131 "expiration_period": null
132 },
133 "is_hard": false
134 },
135 {
136 "item_id": 952118,
137 "sku": "11cog1004",
138 "name": {
139 "en": "Clockwork Crowns"
140 },
141 "type": "virtual_currency",
142 "description": null,
143 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/ca9b753f23a129f8caa52f85a3d9b287.png",
144 "long_description": null,
145 "attributes": [],
146 "is_free": true,
147 "order": 1,
148 "groups": [],
149 "regional_prices": [],
150 "prices": [],
151 "media_list": [],
152 "vc_prices": [],
153 "is_enabled": true,
154 "is_show_in_store": true,
155 "regions": [],
156 "limits": {
157 "per_user": null,
158 "per_item": null,
159 "recurrent_schedule": null
160 },
161 "periods": [],
162 "inventory_options": {
163 "consumable": true,
164 "expiration_period": null
165 },
166 "is_hard": false
167 }
168 ],
169 "virtual_items": [
170 {
171 "item_id": 952158,
172 "sku": "23svvs1007",
173 "name": {
174 "en": "Hypnotic Lantern \"Hypnomouse\""
175 },
176 "type": "virtual_good",
177 "description": {
178 "en": "A lantern with mesmerizing lenses that temporarily stuns enemies."
179 },
180 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/eedc2397bcf5d52745bd07e9c18eb02c.webp",
181 "long_description": null,
182 "attributes": [],
183 "is_free": false,
184 "order": 1,
185 "groups": [
186 "214njksv001"
187 ],
188 "regional_prices": [],
189 "prices": [],
190 "media_list": [],
191 "vc_prices": [
192 {
193 "sku": "11cog1001",
194 "is_default": true,
195 "amount": 20
196 }
197 ],
198 "is_enabled": true,
199 "is_show_in_store": true,
200 "regions": [],
201 "limits": {
202 "per_user": null,
203 "per_item": null,
204 "recurrent_schedule": null
205 },
206 "periods": [],
207 "inventory_options": {
208 "consumable": true,
209 "expiration_period": null
210 }
211 },
212 {
213 "item_id": 952160,
214 "sku": "23svvs1005",
215 "name": {
216 "en": "Noise Generator \"Echo\""
217 },
218 "type": "virtual_good",
219 "description": {
220 "en": "A small device that emits a loud sound, distracting enemies."
221 },
222 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/98a6f1856e530ef86a3ecf32abc4fac7.webp",
223 "long_description": null,
224 "attributes": [],
225 "is_free": false,
226 "order": 1,
227 "groups": [
228 "214njksv001"
229 ],
230 "regional_prices": [],
231 "prices": [],
232 "media_list": [],
233 "vc_prices": [
234 {
235 "sku": "11cog1001",
236 "is_default": true,
237 "amount": 15
238 }
239 ],
240 "is_enabled": true,
241 "is_show_in_store": true,
242 "regions": [],
243 "limits": {
244 "per_user": null,
245 "per_item": null,
246 "recurrent_schedule": null
247 },
248 "periods": [],
249 "inventory_options": {
250 "consumable": true,
251 "expiration_period": null
252 }
253 },
254 {
255 "item_id": 952161,
256 "sku": "23svvs1004",
257 "name": {
258 "en": "\"Infra-Gear\" Goggles"
259 },
260 "type": "virtual_good",
261 "description": {
262 "en": "Special steampunk glasses revealing invisible lasers and hidden mechanisms."
263 },
264 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/d2039a7e0cb290b0dfe3e3baedbdaa88.webp",
265 "long_description": null,
266 "attributes": [],
267 "is_free": false,
268 "order": 1,
269 "groups": [
270 "214njksv001"
271 ],
272 "regional_prices": [],
273 "prices": [],
274 "media_list": [],
275 "vc_prices": [
276 {
277 "sku": "11cog1001",
278 "is_default": true,
279 "amount": 10
280 }
281 ],
282 "is_enabled": true,
283 "is_show_in_store": true,
284 "regions": [],
285 "limits": {
286 "per_user": null,
287 "per_item": null,
288 "recurrent_schedule": null
289 },
290 "periods": [],
291 "inventory_options": {
292 "consumable": true,
293 "expiration_period": null
294 }
295 },
296 {
297 "item_id": 952163,
298 "sku": "23svvs1002",
299 "name": {
300 "en": "Steam Hook \"Harpooner\""
301 },
302 "type": "virtual_good",
303 "description": {
304 "en": "A miniature steam-powered grappling hook that pulls the user toward distant platforms."
305 },
306 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/2192f4936fbf048f4d3ae88e68f7d0b8.webp",
307 "long_description": null,
308 "attributes": [],
309 "is_free": false,
310 "order": 1,
311 "groups": [
312 "214njksv001"
313 ],
314 "regional_prices": [],
315 "prices": [],
316 "media_list": [],
317 "vc_prices": [
318 {
319 "sku": "11cog1001",
320 "is_default": true,
321 "amount": 5
322 }
323 ],
324 "is_enabled": true,
325 "is_show_in_store": true,
326 "regions": [],
327 "limits": {
328 "per_user": null,
329 "per_item": null,
330 "recurrent_schedule": null
331 },
332 "periods": [],
333 "inventory_options": {
334 "consumable": true,
335 "expiration_period": null
336 }
337 },
338 {
339 "item_id": 952157,
340 "sku": "23svvs1008",
341 "name": {
342 "en": "\"Shadow Leaf\" Cloak"
343 },
344 "type": "virtual_good",
345 "description": {
346 "en": "A lightweight metallic fabric that makes the mouse harder to spot in darkness."
347 },
348 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/31936e094096d3250d69ccbdbbee139b.webp",
349 "long_description": null,
350 "attributes": [],
351 "is_free": false,
352 "order": 1,
353 "groups": [
354 "214njksv002"
355 ],
356 "regional_prices": [],
357 "prices": [],
358 "media_list": [],
359 "vc_prices": [
360 {
361 "sku": "11cog1002",
362 "is_default": true,
363 "amount": 25
364 }
365 ],
366 "is_enabled": true,
367 "is_show_in_store": true,
368 "regions": [],
369 "limits": {
370 "per_user": null,
371 "per_item": null,
372 "recurrent_schedule": null
373 },
374 "periods": [],
375 "inventory_options": {
376 "consumable": true,
377 "expiration_period": null
378 }
379 },
380 {
381 "item_id": 952156,
382 "sku": "23svvs1009",
383 "name": {
384 "en": "Gear Shield \"Brassguard\""
385 },
386 "type": "virtual_good",
387 "description": {
388 "en": "A rotating shield made of interlocked gears, deflecting attacks."
389 },
390 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/527058d1b9cdb73613c9e8db978e216a.webp",
391 "long_description": null,
392 "attributes": [],
393 "is_free": false,
394 "order": 1,
395 "groups": [
396 "214njksv002"
397 ],
398 "regional_prices": [],
399 "prices": [],
400 "media_list": [],
401 "vc_prices": [
402 {
403 "sku": "11cog1002",
404 "is_default": true,
405 "amount": 25
406 }
407 ],
408 "is_enabled": true,
409 "is_show_in_store": true,
410 "regions": [],
411 "limits": {
412 "per_user": null,
413 "per_item": null,
414 "recurrent_schedule": null
415 },
416 "periods": [],
417 "inventory_options": {
418 "consumable": true,
419 "expiration_period": null
420 }
421 },
422 {
423 "item_id": 952152,
424 "sku": "23svvs1013",
425 "name": {
426 "en": "Steam Teleporter \"Jumper\""
427 },
428 "type": "virtual_good",
429 "description": {
430 "en": "A small device that allows short-range teleportation, bypassing obstacles."
431 },
432 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/a329e818f53be7ff0ff45a71c9e8925e.webp",
433 "long_description": null,
434 "attributes": [],
435 "is_free": false,
436 "order": 1,
437 "groups": [
438 "214njksv003"
439 ],
440 "regional_prices": [],
441 "prices": [],
442 "media_list": [],
443 "vc_prices": [
444 {
445 "sku": "11cog1003",
446 "is_default": true,
447 "amount": 40
448 }
449 ],
450 "is_enabled": true,
451 "is_show_in_store": true,
452 "regions": [],
453 "limits": {
454 "per_user": null,
455 "per_item": null,
456 "recurrent_schedule": null
457 },
458 "periods": [],
459 "inventory_options": {
460 "consumable": true,
461 "expiration_period": null
462 }
463 },
464 {
465 "item_id": 952150,
466 "sku": "23svvs1015",
467 "name": {
468 "en": "Remote-Controlled Beetle \"Bug-Bot\""
469 },
470 "type": "virtual_good",
471 "description": {
472 "en": "A tiny mechanical insect capable of crawling into tight spaces and activating switches."
473 },
474 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/c469d00554d49968886eee8ebf7211fa.webp",
475 "long_description": null,
476 "attributes": [],
477 "is_free": false,
478 "order": 1,
479 "groups": [
480 "214njksv003"
481 ],
482 "regional_prices": [],
483 "prices": [],
484 "media_list": [],
485 "vc_prices": [
486 {
487 "sku": "11cog1003",
488 "is_default": true,
489 "amount": 45
490 }
491 ],
492 "is_enabled": true,
493 "is_show_in_store": true,
494 "regions": [],
495 "limits": {
496 "per_user": null,
497 "per_item": null,
498 "recurrent_schedule": null
499 },
500 "periods": [],
501 "inventory_options": {
502 "consumable": true,
503 "expiration_period": null
504 }
505 },
506 {
507 "item_id": 952149,
508 "sku": "23svvs1016",
509 "name": {
510 "en": "Key of the Mechmaster"
511 },
512 "type": "virtual_good",
513 "description": {
514 "en": "A legendary artifact that grants control over the most intricate mechanisms."
515 },
516 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/640e580b7be16210cf9262987bc51a1d.webp",
517 "long_description": null,
518 "attributes": [],
519 "is_free": false,
520 "order": 1,
521 "groups": [
522 "214njksv004"
523 ],
524 "regional_prices": [],
525 "prices": [],
526 "media_list": [],
527 "vc_prices": [
528 {
529 "sku": "11cog1004",
530 "is_default": true,
531 "amount": 45
532 }
533 ],
534 "is_enabled": true,
535 "is_show_in_store": true,
536 "regions": [],
537 "limits": {
538 "per_user": null,
539 "per_item": null,
540 "recurrent_schedule": null
541 },
542 "periods": [],
543 "inventory_options": {
544 "consumable": true,
545 "expiration_period": null
546 }
547 },
548 {
549 "item_id": 952148,
550 "sku": "23svvs1017",
551 "name": {
552 "en": "Heart of the Clockwork King"
553 },
554 "type": "virtual_good",
555 "description": {
556 "en": "A rare component capable of reactivating broken automatons."
557 },
558 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/d279721a03809d530ad26bd87feae9d7.webp",
559 "long_description": null,
560 "attributes": [],
561 "is_free": false,
562 "order": 1,
563 "groups": [
564 "214njksv004"
565 ],
566 "regional_prices": [],
567 "prices": [],
568 "media_list": [],
569 "vc_prices": [
570 {
571 "sku": "11cog1004",
572 "is_default": true,
573 "amount": 50
574 }
575 ],
576 "is_enabled": true,
577 "is_show_in_store": true,
578 "regions": [],
579 "limits": {
580 "per_user": null,
581 "per_item": null,
582 "recurrent_schedule": null
583 },
584 "periods": [],
585 "inventory_options": {
586 "consumable": true,
587 "expiration_period": null
588 }
589 },
590 {
591 "item_id": 952147,
592 "sku": "23svvs1018",
593 "name": {
594 "en": "Anti-Gravity Generator"
595 },
596 "type": "virtual_good",
597 "description": {
598 "en": "A mysterious steampunk device that temporarily allows levitation."
599 },
600 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/b81801ad7b7e870d8834e24eb388721c.webp",
601 "long_description": null,
602 "attributes": [],
603 "is_free": false,
604 "order": 1,
605 "groups": [
606 "214njksv004"
607 ],
608 "regional_prices": [],
609 "prices": [],
610 "media_list": [],
611 "vc_prices": [
612 {
613 "sku": "11cog1004",
614 "is_default": true,
615 "amount": 55
616 }
617 ],
618 "is_enabled": true,
619 "is_show_in_store": true,
620 "regions": [],
621 "limits": {
622 "per_user": null,
623 "per_item": null,
624 "recurrent_schedule": null
625 },
626 "periods": [],
627 "inventory_options": {
628 "consumable": true,
629 "expiration_period": null
630 }
631 },
632 {
633 "item_id": 952146,
634 "sku": "23svvs1019",
635 "name": {
636 "en": "Alchemical Reactor \"Philosopher\u2019s Steam\""
637 },
638 "type": "virtual_good",
639 "description": {
640 "en": "An artifact capable of temporarily transmuting mechanisms into gold."
641 },
642 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/529c0d2107d2861f64bb94a94787020a.webp",
643 "long_description": null,
644 "attributes": [],
645 "is_free": false,
646 "order": 1,
647 "groups": [
648 "214njksv004"
649 ],
650 "regional_prices": [],
651 "prices": [],
652 "media_list": [],
653 "vc_prices": [
654 {
655 "sku": "11cog1004",
656 "is_default": true,
657 "amount": 60
658 }
659 ],
660 "is_enabled": true,
661 "is_show_in_store": true,
662 "regions": [],
663 "limits": {
664 "per_user": null,
665 "per_item": null,
666 "recurrent_schedule": null
667 },
668 "periods": [],
669 "inventory_options": {
670 "consumable": true,
671 "expiration_period": null
672 }
673 },
674 {
675 "item_id": 975277,
676 "sku": "demopaid_2",
677 "name": {
678 "en": "Power-Up Puzzle Booster"
679 },
680 "type": "virtual_good",
681 "description": {
682 "en": "Boost your puzzle-solving skills with the Power-Up Puzzle Booster! Gain extra moves and power-ups to conquer challenging levels."
683 },
684 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/529456d9bfddb50b29fa85d1d6ec787d.png",
685 "long_description": null,
686 "attributes": [],
687 "is_free": false,
688 "order": 0,
689 "groups": [
690 "demo-vi-1"
691 ],
692 "regional_prices": [],
693 "prices": [
694 {
695 "amount": 4.99,
696 "currency": "USD",
697 "is_default": true,
698 "is_enabled": true
699 }
700 ],
701 "media_list": [],
702 "vc_prices": [],
703 "is_enabled": true,
704 "is_show_in_store": true,
705 "regions": [],
706 "limits": {
707 "per_user": null,
708 "per_item": null,
709 "recurrent_schedule": null
710 },
711 "periods": [],
712 "inventory_options": {
713 "consumable": true,
714 "expiration_period": null
715 }
716 },
717 {
718 "item_id": 975278,
719 "sku": "demopaid_3",
720 "name": {
721 "en": "Golden Key to Secrets"
722 },
723 "type": "virtual_good",
724 "description": {
725 "en": "Unlock hidden treasures in your home with the Golden Key! Discover exclusive design options and rare collectibles."
726 },
727 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/762acdbcd55056d444221061e172fadc.png",
728 "long_description": null,
729 "attributes": [],
730 "is_free": false,
731 "order": 0,
732 "groups": [
733 "demo-vi-1"
734 ],
735 "regional_prices": [],
736 "prices": [
737 {
738 "amount": 9.99,
739 "currency": "USD",
740 "is_default": true,
741 "is_enabled": true
742 }
743 ],
744 "media_list": [],
745 "vc_prices": [],
746 "is_enabled": true,
747 "is_show_in_store": true,
748 "regions": [],
749 "limits": {
750 "per_user": null,
751 "per_item": null,
752 "recurrent_schedule": null
753 },
754 "periods": [],
755 "inventory_options": {
756 "consumable": true,
757 "expiration_period": null
758 }
759 },
760 {
761 "item_id": 975281,
762 "sku": "demofree_2",
763 "name": {
764 "en": "Weekly Puzzle Challenge"
765 },
766 "type": "virtual_good",
767 "description": {
768 "en": "Join the Weekly Puzzle Challenge! Complete the puzzle to earn special rewards and boost your gameplay."
769 },
770 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/cc3c05847f3c2afa8a190e8ce79fca05.png",
771 "long_description": null,
772 "attributes": [],
773 "is_free": true,
774 "order": 0,
775 "groups": [
776 "demo-free-vi-1"
777 ],
778 "regional_prices": [],
779 "prices": [],
780 "media_list": [],
781 "vc_prices": [],
782 "is_enabled": true,
783 "is_show_in_store": true,
784 "regions": [],
785 "limits": {
786 "per_user": 1,
787 "per_item": null,
788 "recurrent_schedule": {
789 "per_user": {
790 "interval_type": "weekly",
791 "day_of_week": 1,
792 "day_of_month": null,
793 "time": "00:00:00+00:00"
794 }
795 }
796 },
797 "periods": [],
798 "inventory_options": {
799 "consumable": true,
800 "expiration_period": null
801 }
802 },
803 {
804 "item_id": 975280,
805 "sku": "demofree_1",
806 "name": {
807 "en": "Daily Design Boost"
808 },
809 "type": "virtual_good",
810 "description": {
811 "en": "Claim your Daily Design Boost! Receive a surprise item to help you in your home renovation journey."
812 },
813 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/8598fec375d90826d8afdc2cb27cefbc.png",
814 "long_description": null,
815 "attributes": [],
816 "is_free": true,
817 "order": 0,
818 "groups": [
819 "demo-free-vi-1"
820 ],
821 "regional_prices": [],
822 "prices": [],
823 "media_list": [],
824 "vc_prices": [],
825 "is_enabled": true,
826 "is_show_in_store": true,
827 "regions": [],
828 "limits": {
829 "per_user": 1,
830 "per_item": null,
831 "recurrent_schedule": {
832 "per_user": {
833 "interval_type": "daily",
834 "day_of_week": null,
835 "day_of_month": null,
836 "time": "00:00:00+00:00"
837 }
838 }
839 },
840 "periods": [],
841 "inventory_options": {
842 "consumable": true,
843 "expiration_period": null
844 }
845 }
846 ],
847 "virtual_currency_packages": [
848 {
849 "item_id": 952185,
850 "sku": "11cog1011",
851 "type": "bundle",
852 "name": {
853 "en": "Small Cogcoin Pack"
854 },
855 "bundle_type": "virtual_currency_package",
856 "description": {
857 "en": "A handful of Cogcoins, enough to grab some basic tools or a minor upgrade. A perfect start for any daring mouse."
858 },
859 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/832a9ee7fc64cc017ebc9c116abe9404.webp",
860 "vc_prices": [],
861 "regional_prices": [],
862 "prices": [
863 {
864 "amount": 5,
865 "currency": "USD",
866 "is_default": true,
867 "is_enabled": true
868 }
869 ],
870 "is_enabled": true,
871 "is_show_in_store": true,
872 "regions": [],
873 "limits": {
874 "per_user": null,
875 "per_item": null,
876 "recurrent_schedule": null
877 },
878 "periods": [],
879 "attributes": [],
880 "long_description": null,
881 "media_list": [],
882 "order": 1,
883 "is_free": false,
884 "groups": [],
885 "content": [
886 {
887 "sku": "11cog1001",
888 "quantity": 10
889 }
890 ]
891 },
892 {
893 "item_id": 952186,
894 "sku": "11cog1012",
895 "type": "bundle",
896 "name": {
897 "en": "Medium Cogcoin Pack"
898 },
899 "bundle_type": "virtual_currency_package",
900 "description": {
901 "en": "A solid stash of Cogcoins, ideal for purchasing advanced gadgets and small contraptions."
902 },
903 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/2deef82e20f3f234817544fc5f603b84.webp",
904 "vc_prices": [],
905 "regional_prices": [],
906 "prices": [
907 {
908 "amount": 13,
909 "currency": "USD",
910 "is_default": true,
911 "is_enabled": true
912 }
913 ],
914 "is_enabled": true,
915 "is_show_in_store": true,
916 "regions": [],
917 "limits": {
918 "per_user": null,
919 "per_item": null,
920 "recurrent_schedule": null
921 },
922 "periods": [],
923 "attributes": [],
924 "long_description": null,
925 "media_list": [],
926 "order": 1,
927 "is_free": false,
928 "groups": [],
929 "content": [
930 {
931 "sku": "11cog1001",
932 "quantity": 50
933 }
934 ]
935 },
936 {
937 "item_id": 952187,
938 "sku": "11cog1013",
939 "type": "bundle",
940 "name": {
941 "en": "Large Cogcoin Pack"
942 },
943 "bundle_type": "virtual_currency_package",
944 "description": {
945 "en": "A well-stocked reserve of Cogcoins, enough to afford top-tier equipment and rare steampunk devices."
946 },
947 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9ce48d3243db8222f70ecbd3899abc72.webp",
948 "vc_prices": [],
949 "regional_prices": [],
950 "prices": [
951 {
952 "amount": 27,
953 "currency": "USD",
954 "is_default": true,
955 "is_enabled": true
956 }
957 ],
958 "is_enabled": true,
959 "is_show_in_store": true,
960 "regions": [],
961 "limits": {
962 "per_user": null,
963 "per_item": null,
964 "recurrent_schedule": null
965 },
966 "periods": [],
967 "attributes": [],
968 "long_description": null,
969 "media_list": [],
970 "order": 1,
971 "is_free": false,
972 "groups": [],
973 "content": [
974 {
975 "sku": "11cog1001",
976 "quantity": 100
977 }
978 ]
979 }
980 ],
981 "bundles": [
982 {
983 "item_id": 953085,
984 "sku": "bndl1404v01",
985 "type": "bundle",
986 "name": {
987 "en": "Tinkerer's Starter Kit"
988 },
989 "bundle_type": "standard",
990 "description": {
991 "en": "A perfect bundle for new players looking to get started with essential tools and currency. Whether you're disarming traps or crafting clever contraptions, this bundle will set you on the right track."
992 },
993 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/af1b43f928b0854951b0bb0971b619ac.webp",
994 "regional_prices": [],
995 "prices": [
996 {
997 "amount": 25,
998 "currency": "USD",
999 "is_default": true,
1000 "is_enabled": true
1001 }
1002 ],
1003 "virtual_prices": [],
1004 "is_enabled": true,
1005 "is_show_in_store": true,
1006 "regions": [],
1007 "limits": {
1008 "per_user": null,
1009 "per_item": null,
1010 "recurrent_schedule": null
1011 },
1012 "periods": [],
1013 "attributes": [],
1014 "long_description": null,
1015 "media_list": [],
1016 "order": 1,
1017 "is_free": false,
1018 "groups": [],
1019 "content": [
1020 {
1021 "sku": "23svvs1012",
1022 "quantity": 1
1023 },
1024 {
1025 "sku": "23svvs1001",
1026 "quantity": 1
1027 },
1028 {
1029 "sku": "11cog1051",
1030 "quantity": 1
1031 },
1032 {
1033 "sku": "11cog1031",
1034 "quantity": 1
1035 }
1036 ]
1037 },
1038 {
1039 "item_id": 953086,
1040 "sku": "bndl1404v02",
1041 "type": "bundle",
1042 "name": {
1043 "en": "Steam-Powered Explorer Pack"
1044 },
1045 "bundle_type": "standard",
1046 "description": {
1047 "en": "Perfect for adventurers seeking speed, stealth, and some extra Steam Tokens to power their way through obstacles."
1048 },
1049 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/68cdd1197607a225e6891aaffebcc2a1.webp",
1050 "regional_prices": [],
1051 "prices": [
1052 {
1053 "amount": 27,
1054 "currency": "USD",
1055 "is_default": true,
1056 "is_enabled": true
1057 }
1058 ],
1059 "virtual_prices": [],
1060 "is_enabled": true,
1061 "is_show_in_store": true,
1062 "regions": [],
1063 "limits": {
1064 "per_user": null,
1065 "per_item": null,
1066 "recurrent_schedule": null
1067 },
1068 "periods": [],
1069 "attributes": [],
1070 "long_description": null,
1071 "media_list": [],
1072 "order": 2,
1073 "is_free": false,
1074 "groups": [],
1075 "content": [
1076 {
1077 "sku": "23svvs1006",
1078 "quantity": 1
1079 },
1080 {
1081 "sku": "23svvs1008",
1082 "quantity": 1
1083 },
1084 {
1085 "sku": "11cog1021",
1086 "quantity": 1
1087 },
1088 {
1089 "sku": "11cog1032",
1090 "quantity": 1
1091 }
1092 ]
1093 },
1094 {
1095 "item_id": 953087,
1096 "sku": "bndl1404v03",
1097 "type": "bundle",
1098 "name": {
1099 "en": "Clockwork Warrior\u2019s Arsenal"
1100 },
1101 "bundle_type": "standard",
1102 "description": {
1103 "en": "Equipped with powerful defenses and mechanical mastery, this bundle is ideal for mice who prefer to fight their way through dangers."
1104 },
1105 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/ead1ac351c5a4351e6e7a2bdd832f693.webp",
1106 "regional_prices": [],
1107 "prices": [
1108 {
1109 "amount": 31,
1110 "currency": "USD",
1111 "is_default": true,
1112 "is_enabled": true
1113 }
1114 ],
1115 "virtual_prices": [],
1116 "is_enabled": true,
1117 "is_show_in_store": true,
1118 "regions": [],
1119 "limits": {
1120 "per_user": null,
1121 "per_item": null,
1122 "recurrent_schedule": null
1123 },
1124 "periods": [],
1125 "attributes": [],
1126 "long_description": null,
1127 "media_list": [],
1128 "order": 3,
1129 "is_free": false,
1130 "groups": [],
1131 "content": [
1132 {
1133 "sku": "23svvs1009",
1134 "quantity": 1
1135 },
1136 {
1137 "sku": "23svvs1010",
1138 "quantity": 1
1139 },
1140 {
1141 "sku": "11cog1041",
1142 "quantity": 1
1143 },
1144 {
1145 "sku": "11cog1012",
1146 "quantity": 1
1147 }
1148 ]
1149 },
1150 {
1151 "item_id": 953089,
1152 "sku": "bndl1404v04",
1153 "type": "bundle",
1154 "name": {
1155 "en": "Master Engineer\u2019s Blueprint Bundle"
1156 },
1157 "bundle_type": "standard",
1158 "description": {
1159 "en": "A bundle made for master engineers looking to shape the world around them using the most advanced technology and resources."
1160 },
1161 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/e2e2036079229214274d2e3e488c7863.webp",
1162 "regional_prices": [],
1163 "prices": [
1164 {
1165 "amount": 35,
1166 "currency": "USD",
1167 "is_default": true,
1168 "is_enabled": true
1169 }
1170 ],
1171 "virtual_prices": [],
1172 "is_enabled": true,
1173 "is_show_in_store": true,
1174 "regions": [],
1175 "limits": {
1176 "per_user": null,
1177 "per_item": null,
1178 "recurrent_schedule": null
1179 },
1180 "periods": [],
1181 "attributes": [],
1182 "long_description": null,
1183 "media_list": [],
1184 "order": 4,
1185 "is_free": false,
1186 "groups": [],
1187 "content": [
1188 {
1189 "sku": "23svvs1015",
1190 "quantity": 1
1191 },
1192 {
1193 "sku": "23svvs1013",
1194 "quantity": 1
1195 },
1196 {
1197 "sku": "11cog1053",
1198 "quantity": 1
1199 },
1200 {
1201 "sku": "11cog1043",
1202 "quantity": 1
1203 }
1204 ]
1205 },
1206 {
1207 "item_id": 953092,
1208 "sku": "bndl1404v05",
1209 "type": "bundle",
1210 "name": {
1211 "en": "Relics of the Clockwork King"
1212 },
1213 "bundle_type": "standard",
1214 "description": {
1215 "en": "A treasure trove of rare artifacts and powerful resources, reserved for the most daring explorers of the mechanical realm."
1216 },
1217 "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/60c8af7c07a62e30d9e82778f5a12283.webp",
1218 "regional_prices": [],
1219 "prices": [
1220 {
1221 "amount": 39,
1222 "currency": "USD",
1223 "is_default": true,
1224 "is_enabled": true
1225 }
1226 ],
1227 "virtual_prices": [],
1228 "is_enabled": true,
1229 "is_show_in_store": true,
1230 "regions": [],
1231 "limits": {
1232 "per_user": null,
1233 "per_item": null,
1234 "recurrent_schedule": null
1235 },
1236 "periods": [],
1237 "attributes": [],
1238 "long_description": null,
1239 "media_list": [],
1240 "order": 5,
1241 "is_free": false,
1242 "groups": [],
1243 "content": [
1244 {
1245 "sku": "23svvs1016",
1246 "quantity": 1
1247 },
1248 {
1249 "sku": "23svvs1019",
1250 "quantity": 1
1251 },
1252 {
1253 "sku": "11cog1033",
1254 "quantity": 1
1255 },
1256 {
1257 "sku": "11cog1023",
1258 "quantity": 1
1259 }
1260 ]
1261 }
1262 ]
1263}
- 가져오기 창의 해당 필드에 전체 파일을 업로드합니다.
- 가져오는 동안 오류가 발생하면 가져오기 창에 오류 목록과 수정 권장 사항이 표시됩니다. 파일을 필요에 따라 변경한 후 다시 업로드합니다.
업로드에 성공하면 지정된 SKU를 가진 항목이 생성, 업데이트 또는 비활성화됩니다.
JSON 파일을 통해 아이템 가져오기 API 호출을 사용하여 아이템을 가져올 수도 있습니다.
스토어 블록 또는 구매 버튼 생성
스토어 블록은 웹 사이트에서 아이템 카탈로그를 판매하는 데 사용됩니다. 이 블록에는 판매용으로 선택한 그룹의 모든 아이템이 표시됩니다. 구매 버튼은 개별 아이템을 판매하기 위한 도구입니다. 이 버튼은 빌더의 여러 블록에서 사용할 수 있습니다. 이 버튼을 사용하면 번들과 게임 키만 판매할 수 있습니다.
Web Shop 또는 단일 게임 페이지 템플릿을 사용하여 사이트를 생성하는 경우, 블록이 사이트에 자동으로 추가됩니다.
다른 템플릿을 사용하여 사이트를 생성하고 사이트에 스토어 블록을 추가하려는 경우:
- 관리자 페이지에서 프로젝트를 열고 스토어프런트 > 웹 사이트 섹션으로 이동합니다.
- 웹 사이트 빌더 열기를 클릭합니다.
- 사이트 템플릿에서 블록 추가를 클릭합니다.
- 목록에서 스토어 블록을 선택합니다.
- 드롭다운 목록에서 사이트에서 판매할 아이템의 유형과 그룹을 선택합니다.
- 다양한 유형의 아이템을 판매하려면 상점 섹션을 추가합니다. 이렇게 하려면 스토어 블록 메뉴에서, 스토어 섹션 추가를 클릭합니다.
- 사이트의 다른 부분에서 아이템을 판매하려면 스토어 블록을 추가합니다.
- 카드 그리드
- 헤더
- 콜 투 액션
- 게임 에디션
- 프로모션 슬라이더
단일 게임 페이지 템플릿에서 해당 버튼은 리드 블록에도 있습니다.
버튼 사용자 지정 방법:
- 지정된 블록 중 하나로 이동합니다.
- 웹 사이트 빌더의 오른쪽 부분에서 해당 버튼으로 이동합니다.
- 작업 드롭다운 목록에서, 아이템 구매를 선택합니다.
- 아이템 드롭다운 목록에서, 아이템을 선택합니다.
유용한 링크
마지막 업데이트: 2025년 9월 19일오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.