번들
작동 방식
번들은 하나의 단위로 판매되는 여러 아이템으로 구성된 세트입니다.
주요 기능:
- 번들에 다양한 유형의 아이템 추가:
- 인게임 재화(플랫폼 종속성 화폐 포함)
- 인게임 재화 패키지
- 사전 선택된 플랫폼용 게임 키
- 시간 제한 아이템을 포함한 가상 아이템
- 번들
- 실제 및 인게임 재화로 번들 가격 구성. 여러 가지 실제 또는 인게임 재화로 가격을 설정할 수 있습니다. 이 경우 기본 통화를 선택해야 합니다.
- 무료 번들.
- 구매 가능한 번들 수 제한.
- 스토어에서 번들 표시 시간 제한.
- 인게임 재화, 가상 아이템, 시간 제한 아이템 및 번들의 경우 PlayFab를 통해(PlayFab 통합 기능이 활성화된 경우) 그리고
- 게임 키의 경우 이메일을 통해 그리고
- 주문 결제 성공 웹훅의 데이터를 사용하는 자체 전달 시스템을 통해 사용자에게 전달됩니다. 이러한 방법은
- PlayFab 통합 기능을 사용하지 않은 경우
- 모든 유형의 아이템에 적용됩니다. 자체 서버에서 사용자에게 아이템 전달 방법을 관리하는 것이 좋습니다.
- 구매 시 번들 콘텐츠 포함이 비활성화되지 않은 경우, 번들에 포함된 모든 아이템은 개별 아이템 목록으로 items 배열에 전달됩니다. 번들에 다른 번들이 포함되어 있을 경우 해당 콘텐츠도 개별 아이템으로 전달됩니다.
예를 들어, 트랜잭션 취소로 인해 번들이 환불되면 주문 취소 웹훅이 전송됩니다. 웹훅 데이터를 사용하여 사용자 계정에서 구매한 아이템을 차감합니다.
제한:
- 번들에 동일한 번들을 추가할 수 없습니다.
- 비어 있는 번들을 생성할 수 없습니다.
- 판매할 키가 소모되고 이러한 키가 번들에 포함된 이후에는 번들 판매가 일시 중지됩니다.
구매할 수 있는 번들 개수 제한
번들 구매를 제한할 수 있습니다. 예를 들어 다음과 같이 제한:
- 사용자당 번들 개수
- 한 번 구매했을 때만 적용되는 웰컴 번들
사용자가 지정된 한도까지 구매할 경우 번들이 카탈로그에 표시되지 않습니다. 번들에 구매 한도가 있는 인게임 재화 패키지나 아이템이 포함되고 사용자가 이미 허용된 양을 구매한 경우, 번들이 카탈로그에 표시되지 않습니다.
최대 구매 가능 번들 개수와 사용자가 구매 가능한 잔여 개수를 표시할 수 있습니다.
관리자 페이지에서 번들을 생성할 때 구매 제한을 설정하려면 한 사용자의 이 번들 구매 가능 횟수 제한 토글을 켜짐으로 전환하고 번들을 구매할 수 있는 횟수를 지정합니다.
번들에 대한 정보를 얻으려면 번들 방법 그룹에서 카탈로그 구독 방법을 사용할 수 있습니다.
응답으로 번들 관련 정보에 추가해서 다음 정보를 받게 됩니다.
- 한 사용자가 구매할 수 있는 최대 번들 개수
- 사용자가 구입할 수 있는 번들 잔여 개수
제한을 설정하거나 업데이트하는 방법에 대한 자세한 내용은 사용자 제한 설정 지침에서 확인할 수 있습니다.
- json
1{
2 "items": [
3 {
4 "sku": "kg_1",
5 "name": "kg_10.00_bundle",
6 "type": "bundle",
7 "description": "pricePoint_44056_1",
8 "image_url": null,
9 "long_description": null,
10 "attributes": {
11 "external_id": "genre",
12 "name": "Genre",
13 "values": [
14 {
15 "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
16 "value": "Casual"
17 },
18 {
19 "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
20 "value": "Strategy"
21 },
22 {
23 "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
24 "value": "Mobile"
25 }
26 ]
27 },
28 "is_free": false,
29 "order": 999,
30 "groups": [],
31 "price": {
32 "amount": 9.99,
33 "currency": "USD",
34 "amount_without_discount": 9.99
35 },
36 "total_content_price": {
37 "amount": 10.99,
38 "currency": "USD",
39 "amount_without_discount": 10.99
40 },
41 "media_list": [],
42 "virtual_prices": [],
43 "can_be_bought": true,
44 "bundle_type": "standard",
45 "limits": {
46 "$ref": "./Catalog_item_limits.yaml"
47 },
48 "content": [
49 {
50 "sku": "big_rocket",
51 "name": "Big Rocket",
52 "description": "Big Rocket - short description.",
53 "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
54 "type": "virtual_currency",
55 "quantity": 100,
56 "virtual_item_type": "non_consumable",
57 "attributes": {
58 "external_id": "size",
59 "name": "Size",
60 "values": [
61 {
62 "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
63 "value": "Large"
64 }
65 ]
66 },
67 "is_free": false,
68 "groups": [],
69 "price": {
70 "amount": 10.99,
71 "currency": "USD",
72 "amount_without_discount": 10.99
73 },
74 "virtual_prices": [],
75 "limits": {
76 "per_user": {
77 "total": 5,
78 "available": 5
79 },
80 "per_item": null
81 },
82 }
83 }
84 ]
85 }
86 ]
87}
엑솔라는 한도가 초과되지 않도록 하고, 사용자가 설정된 한도보다 더 많은 번들을 구매하지 못하도록 합니다.
결제 인터페이스를 열고 해당 번들에 대해 지불하면 이 번들과 관련된 모든 미지급 주문이 무효화됩니다.
예: 사용자는 번들을 구매할 때까지 여러 브라우저 탭에서 구매 제한이 있는 번들에 대한 결제 양식을 열 수 있습니다. 그러면 동일한 아이템에 대해 여러 주문이 자동으로 생성됩니다. 한 탭에서 아이템을 구입하면 엑솔라가 동일한 아이템에 대한 모든 미결제 주문을 무효화합니다.
스토어에서 번들 표시 기간 제한
스토어에서 아이템 표시 기간을 다음과 같이 설정할 수있습니다.- 휴일 세일 기간과 같이 특정 시점에 카탈로그의 관련성 유지
- 카탈로그에 표시하지 않고 미리 번들을 생성
- 아이템 옆에 타이머를 표시하여 사용자가 번들을 구매하도록 동기를 부여
관리자 페이지를 통해 스토어에 번들을 표시하는 기간 제한을 설정하려면 기간을 선택하고 해당 기간의 시간대, 시작일과 종료일을 지정합니다. 번들 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
API를 통해 스토어의 번들 표시 시간 제한을 설정하려면 번들 생성 또는 번들 업데이트 API 호출에 다음 매개 변수를 전달합니다:
periods[0].date_from는 아이템 표시 기간의 시작 날짜와 시간을YYYY-MM-DDThh:mm:ss±TMZ형식으로 표시합니다.TMZ는hh:mm형식의 시간대 구분자입니다.periods[0].date_until는 아이템 표시 기간의 시작 날짜와 시간을YYYY-MM-DDThh:mm:ss±TMZ형식으로 표시합니다.TMZ는hh:mmGMT 형식의 시간대 구분자입니다. 아이템 표시 기간의 종료 날짜를 표시하지 않으려면null를 전달합니다.
스토어에 번들을 표시하는 기간을 여러 개 설정할 수 있습니다. 이를 위해 번들 생성 또는 번들 업데이트 메서드에서 모든 기간의 시작 날짜와 종료 날짜가 포함된 객체 배열을 전달합니다.
예:
- json
1"periods": [
2 {
3 "date_from": "2022-06-10T14:00:00+03:00",
4 "date_until": "2022-06-30T14:00:00+03:00"
5 },
6 {
7 "date_from": "2022-07-10T14:00:00+03:00",
8 "date_until": "2022-07-30T14:00:00+03:00"
9 },
10 {
11 "date_from": "2022-08-10T14:00:00+03:00",
12 "date_until": "2022-08-30T14:00:00+03:00"
13 }
14]
사용자
판매 증가 및 신규 플레이어를 유치를 위해 아이템 세트를 번들 안의 모든 아이템의 초기 전체 가격보다 더 낮은 가격으로 판매하고 .
획득 방법
통합 절차
번들 설정
다음 방법 중 하나로 번들 설정:관리자 페이지을 이용한 설정
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 번들 섹션으로 이동합니다.
- +를 클릭하고 드롭다운 목록에서 번들 생성을 선택합니다.
- 추가:
- 이미지(선택 사항).
- SKU.
- 번들이 속해야 하는 하나 또는 여러 개의 그룹.
- 이름.
- 설명(선택 사항).
- 콘텐츠.
- 번들 가격 설정:
- 가격을 지정하거나 무료 번들을 생성합니다:
- 무료 번들을 생성하려면 유료 또는 무료 필드에서, 무료 번들을 선택합니다.
- 유료 또는 무료 필드에서 가격을 설정하려면 유료 번들을 선택하고 실제 또는 인게임 재화로 가격을 지정합니다. 필요할 경우, 지역별 가격을 구성합니다.
- 번들을 위한 구매 한도(선택 사항)을 설정합니다. 이렇게 하려면 한 명의 사용자가 번들을 구매할 수 있는 횟수 제한 토글을 켜짐으로 설정하고 사용자가 구매할 수 있는 번들 수를 지정하십시오.
- 다음을 클릭합니다.
- 스토어에서 번들 표시 구성:
- 상태를 사용 가능으로 변경합니다.
- 스토어에 번들을 표시할 시간 제한을 설정합니다(선택 사항). 이렇게 하려면 기간을 선택하고 시간대, 기간의 시작과 종료를 지정합니다. 아이템 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
- 다음을 클릭합니다.
- 설정을 확인한 후 저장을 클릭합니다.
API 메소드를 통한 설정
번들 메서드 그룹에서 관리자 하위 섹션의 메서드를 사용하여 번들을 설정할 수 있습니다.번들에 게임 키 추가
선택된 플랫폼에 대한 게임 키를 번들에 추가하려면 필수 플랫폼의 SKU를 포함하는
- json
1"content": [{
2 “sku”: “brilliant_game_sku_steam”,
3 “quantity”: 1
4 }
5]
지역 제한 설정
번들에 대한 지역 제한을 설정하려면 지원되는
- API 메서드를 사용하고
- 개인 프로젝트 관리자에게 이를 요청하고
- cms@xsolla.com에 이메일을 전송하여 수행할 수 있습니다.
- json
1"regions": [{
2 “id”: 123
3 }, {
4 “id”: 456
5 }
6]
지역별 가격 설정
번들에 대한 지역별 가격을 설정하려면 지역에 대한 설정을 포함하는 의 배열을 번들 생성 또는 번들 업데이트 메서드에 전달합니다.
- json
1"prices": [
2 {
3 "amount": 100,
4 "currency": "USD",
5 "is_enabled": true,
6 "is_default": true
7 },
8 {
9 "amount": 200,
10 "currency": "CZK",
11 "country_iso": "CZ",
12 "is_enabled": false,
13 "is_default": false
14 }
15 ]
카탈로그의 번들 가져오기
번들 메서드 그룹에서 카탈로그 하위 섹션의 메서드를 사용하여 번들 카탈로그를 가져올 수 있습니다.웹훅에서 아이템 정보 구성
items 배열을 통해 주문 결제 성공 및 주문 취소 웹훅에 포함할 아이템 데이터를 구성할 수 있습니다.
추가 매개 변수 포함 활성화
다음을 표시하는 추가 매개 변수의 포함 기능을 활성화하세요.
- 아이템이 무료인지 여부(
is_free) - 아이템이 보너스인지 여부(
is_bonus) - 아이템이 번들의 일부인지 여부(
is_bundle_content)
이러한 매개 변수를 수신하려면 웹훅 설정에 대한 정보 업데이트 API 호출을 사용하여 웹훅을 버전 2로 전환해야 합니다. 버전 1(기본값)에서는 이러한 매개 변수를 사용할 수 없습니다.
추가 매개 변수가 있는 아이템 배열의 예시:
- json
1
2"items": [
3 {
4 "sku": "com.xsolla.item_new_1",
5 "type": "bundle",
6 "is_pre_order": false,
7 "is_free": false,
8 "is_bonus": false,
9 "Is_bundle_content": false,
10 "quantity": 1,
11 "amount": "1000",
12 "promotions": []
13 },
14 {
15 "sku": "com.xsolla.gold_1",
16 "type": "virtual_currency",
17 "is_pre_order": false,
18 "is_free": false,
19 "is_bonus": false,
20 "is_bundle_content": true,
21 "quantity": 1500,
22 "amount": "[null]",
23 "promotions": []
24 }
25 ],
번들 콘텐츠 포함 비활성화
기본적으로 웹훅에는 번들의 모든 아이템이 개별 아이템 목록으로 포함됩니다. 콘텐츠를 나열하지 않고 번들 자체만 포함하도록 웹훅을 구성할 수 있습니다.
이 경우 번들에 포함된 아이템은 items 배열에 포함되지 않습니다. 위에 표시된 배열에서 번들의 일부인 SKU com.xsolla.gold_1가 있는 아이템은 제외됩니다.
번들 콘텐츠가 비활성화된 경우의 아이템 배열 예시:
- json
1
2"items": [
3 {
4 "sku": "com.xsolla.item_new_1",
5 "type": "bundle",
6 "is_pre_order": false,
7 "is_free": false,
8 "is_bonus": false,
9 "Is_bundle_content": false,
10 "quantity": 1,
11 "amount": "1000",
12 "promotions": []
13 }
14 ],
번들 콘텐츠 포함 기능을 비활성화하려면 고객 성공 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
