번들

작동 방식

번들은 하나의 단위로 판매되는 여러 아이템으로 구성된 세트입니다.

주요 기능:

• 번들에 서로 다른 유형의 아이템 추가:
  • 가상 머니
  • 가상 머니 패키지
  • 사전 선택된 플랫폼용 게임 키
  • 가상 아이템
  • 번들
• 무료 번들.
• 실제 통화와 가상 머니로 번들 가격 책정을 구성. 여러 실제 통화 또는 가상 머니로 가격을 설정할 수 있습니다. 이 경우 기본 통화를 선택하세요.
• 번들에 대한 지역별 가격 책정 설정.
• 구매 가능한 번들 수 제한.
• 스토어에서 번들 표시 시간 제한 설정.
• 지역별로 번들 제공 제한.

제한 사항:

• 동일한 번들을 번들에 추가할 수 없습니다.
• 비어 있는 번들을 생성할 수 없습니다.
• 번들에 키가 포함되어 있고 사용 가능한 키가 모두 소진되면, 해당 번들의 판매가 일시 중지됩니다.
• 번들의 지역 제한 설정은 API 호출로만 할 수 있습니다.

설정 방법

번들 생성 방법:

2. Create manually를 클릭하고 드롭다운 목록에서 Bundle을 선택하세요.

3. General settings 섹션에서 다음을 지정하세요.
   • SKU
   • 아이템이 속할 그룹 1개 이상(선택 사항)
   • 이름
   • 짧은 설명
   • 상세 설명 — 추가하려면 해당 토글을 켜세요(선택 사항)

4. Media 섹션에서 하나 이상의 이미지 또는 동영상을 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 Main으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. Main으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.

5. Bundle items 섹션에서 번들에 추가할 SKU를 선택하세요. 최소 1개 아이템이 필요합니다.

6. Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
   • 가격을 설정하려면 Paid item을 선택하고 Pricing in real currency 및/또는 Pricing in virtual currency 토글을 켠 다음 가격을 지정하세요. 필요하면 지역별 가격 책정을 설정하세요.
   • 무료 아이템을 생성하려면 Free item을 선택하세요.

7. 구매 가능한 아이템 수를 제한하려면 다음을 수행하세요.
   1. Limits 섹션에서 토글을 켜고 수량을 지정하세요.
   2. 한도 초기화 주기를 설정하세요. 드롭다운 목록에서 기간을 선택하세요.
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval. 간격은 스토어에서 아이템의 디스플레이 시작일을 기준으로 계산됩니다.
      • No regular refresh.
   3. 선택한 기간에 맞는 매개변수를 지정해 초기화 일정을 설정하세요.

8. 아이템의 디스플레이 시간 제한을 설정하려면(선택 사항) 다음을 수행하세요.

   1. Add specific display period 섹션에서 토글을 켜세요.
   2. 시간대와 기간의 시작과 종료를 지정하세요.

   아이템의 디스플레이 종료 시점을 지정하지 않으려면 No end date 토글을 켜세요.

9. 다음 중 하나의 방법으로 특성을 설정하세요(선택 사항).
   1. 특성과 해당 값을 JSON 형식으로 추가하세요.
   2. 특성과 해당 값을 수동으로 생성하고 아이템에 연결하세요.

10. 유료 아이템을 무작위 리워드 메커닉(예: 전리품 상자 또는 가챠)에서 사용할 예정이라면 Mark as paid randomized reward 토글을 켜세요.

11. Create를 클릭하세요.

12. 열린 창에서 아이템 상태를 선택하고 Continue를 클릭하세요.

생성된 아이템은 All items 섹션에 표시됩니다.

API로 설정

번들을 설정하려면 Bundles 그룹의 Admin 하위 섹션에 있는 API 호출을 사용하세요.

선택한 플랫폼용 게임 키를 번들에 추가하려면, 필요한 플랫폼의 SKU로 구성된 content 배열을 Create bundle 또는 Update bundle 호출에 전달하세요.

1"content": [
2  {
3     "sku": "brilliant_game_sku_steam",
4     "quantity": 1
5  }
6]

구매 가능한 번들 수를 제한하려면, 다음 매개변수와 함께 Create bundle 또는 Update bundle API 호출을 사용하세요:

• limits - 구매 가능한 번들의 최대 수를 지정합니다.
• limits.recurrent_schedule - 제한이 얼마나 자주 초기화되는지 정의합니다.

또한 스토어에서 번들의 표시 시간 제한과 지역 제한을 설정할 수 있습니다.

스토어에 번들 표시

번들은 구현 방식에 따라 카탈로그에 표시됩니다(웹사이트 빌더 또는 API).

웹사이트 빌더로 표시

웹사이트에 번들을 표시하는 방법:

1. 번들을 생성하세요.
2. 게시자 계정의 프로젝트에서 Storefronts > Websites 섹션으로 이동하세요.
3. 원하는 사이트의 패널에서 Open Site Builder를 클릭하세요.

1. 번들을 생성하세요.

2. 모바일 게임용 계정의 프로젝트에서 Web Shop 섹션으로 이동하세요.

3. 원하는 사이트의 패널을 클릭하세요.

4. 사이트에 여러 페이지가 있다면, 필요한 페이지를 선택하세요:

   1. 에디터 상단에서 현재 페이지 제목을 클릭하세요.
   2. 드롭다운 목록에서 원하는 페이지를 선택하세요.

5. Store 블록에서 Store 섹션으로 이동하세요.

6. Item type 입력란에서 Bundles를 선택하세요.

7. Item group 입력란에서 그룹을 선택하세요.
8. 아이템 카드 레이아웃을 선택하세요.

9. 필요한 경우, 카드 레이아웃 설정에서 해당 토글을 켜서 카드 레이아웃을 사용자 지정하세요.

10. 필요한 변경을 모두 적용하고 웹사이트 출시를 준비했다면:

    1. 사이트 에디터 오른쪽 상단에서 Publish를 클릭하세요.
    2. 게시하려는 페이지 옆의 체크박스를 선택하세요.
    3. Publish를 클릭하세요.

사이트를 게시하면 번들 섹션이 표시됩니다. 번들이 보이지 않는다면, 상태가 Available로 설정되어 있고 시간 기반 표시 제한이 활성화되지 않았는지 확인하세요.

API로 번들 정보 가져오기

API를 사용하여 카탈로그를 구성한 경우, 번들 데이터는 카탈로그 하위 섹션에서 사용할 수 있는 호출을 통해 반환됩니다:

• 번들 목록 가져오기
• 지정한 그룹의 번들 목록 가져오기
• 지정한 번들 가져오기

웹훅 설정

Successful payment for order 및 Order cancellation 웹훅에 포함할 아이템 데이터를 items 배열로 구성할 수 있습니다.

사용자에게 번들 지급

아이템 유형 및 통합 설정에 따라 번들은 다음과 같은 방법 중 하나로 사용자에게 부여됩니다:

• PlayFab을 통합했다면, 가상 머니와 아이템이 사용자 PlayFab 인벤토리에 자동으로 지급됩니다.
• 커스텀 전달 시스템을 사용한다면, 모든 가상 아이템과 가상 머니를 귀사 측에서 지급하세요. 주문 데이터를 백엔드로 받기 위해 웹훅 핸들러를 설정하는 것을 권장합니다. 필요한 데이터는 Successful payment for order 웹훅에 포함되어 있습니다.
• 번들 콘텐츠 전달을 비활성화하지 않았다면, 번들을 구매한 뒤 번들에 포함된 모든 아이템이 Successful payment for order 웹훅의 items 배열에 개별 아이템으로 나열됩니다. 번들 안에 또 다른 번들이 있으면, 해당 번들도 풀어서 개별 아이템으로 전달됩니다.

자세한 내용과 기타 구매 데이터 조회 방법은 주문 상태 추적 설정 섹션을 참고하세요.