번들

작동 방식

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

주요 기능:

• 번들에 추가되는 다양한 유형의 아이템:
  • 인게임 재화
  • 인게임 재화 패키지
  • 사전 선택된 플랫폼의 게임 키
  • 가상 아이템
  • 번들
• 무료 번들.
• 실제 통화 및 인게임 재화로 번들 가격 구성. 여러 실제 통화 또는 인게임 재화로 가격을 설정할 수 있습니다. 이 경우 기본 통화를 선택해야 합니다.
• 번들 상품에 대한 지역별 가격 설정.
• 구매할 수 있는 번들 개수 제한.
• 스토어에서 번들 표시 시간 제한 설정.
• 지역별 번들 이용 가능성 제한.

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

설정 방법

관리자 페이지를 이용한 설정

번들 생성 방법:

1. 관리자 페이지의 프로젝트에서 아이템 카탈로그 > 모든 아이템 섹션으로 이동합니다.
2. 추가를 클릭하고 드롭다운 목록에서 번들을 선택합니다.

3. 다음 매개 변수를 지정합니다:
   • 이미지(선택 사항).
   • SKU.
   • 번들이 속해야 하는 하나 또는 여러 개의 그룹.
   • 이름.
   • 설명(선택 사항).
4. 다음 방법 중 하나로 번들 속성을 구성합니다(선택 사항):
   • JSON 형식으로 특성과 그 값을 추가합니다.
   • 수동으로 특성과 값을 생성하고, 이를 특정 아이템과 연동합니다.
5. 다음을 클릭합니다.
6. 파트너 측 사용자 맞춤 설정이 활성화된 경우, 표준 번들과 동적 번들 유형 중에서 선택할 수 있습니다. 동적 번들을 사용하면 엑솔라에서 아이템 생성을 건너뛰고 대신 카탈로그 요청 시 서버에 의해 생성된 번들 내용을 반환할 수 있습니다. 파트너 측 사용자 맞춤 설정이 비활성화된 경우 번들 유형 선택기가 표시되지 않으며 표준 번들이 자동으로 생성됩니다.

7. 번들에 아이템 추가:
   1. 아이템 유형을 선택합니다.
   2. 번들에 포함할 하나 이상의 아이템 SKU를 지정합니다.
   3. 각 SKU에 대한 수량을 설정합니다.

8. 다음을 클릭합니다.
9. 유료 또는 무료 입력란에 번들 가격을 설정합니다:
   • 무료 번들을 생성하려면 무료 번들을 선택하세요.
   • 가격을 설정하려면 유료 번들을 선택하고 실제 통화 또는 인게임 재화로 가격을 지정하세요. 가격을 0으로 설정하여 번들을 생성할 수 없습니다. 필요한 경우 지역별 가격을 구성하세요.
10. 구매 가능한 번들 수를 제한하려면 사용자당 번들 구매 제한 토글을 켜고 원하는 수량을 입력하세요.

11. 제한이 재설정되는 빈도를 구성하는 방법:
    1. 드롭다운 목록에서 기간을 선택합니다:
       • 매일.
       • 매주.
       • 매월.
       • 사용자 정의 간격 - 번들 표시 시작일로부터 계산됩니다.
       • 정기 갱신 없음.
    2. 선택한 기간에 따라 재설정 일정을 설정하세요.

12. 다음을 클릭합니다.

13. 스토어에서 번들 표시 방식 구성:
    1. 상태 선택.
    2. 번들 표시 기간 설정(선택 사항): 시간대를 지정하고 기간의 시작 및 종료 시점을 설정합니다. 아이템 표시 종료일을 표시하지 않으려면 종료일 없음 상자를 체크 표시하십시오.

14. 다음을 클릭합니다.
15. 설정을 확인하고 저장을 클릭합니다.

API를 통한 설정

번들 그룹에서 관리자 하위 섹션의 호출을 사용하여 번들을 설정할 수 있습니다.

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

구매 가능한 번들 수를 제한하려면 다음 매개 변수와 함께 번들 생성 또는 번들 업데이트 API 호출을 사용하세요:

• limits — 구매 가능한 번들의 최대 수량을 지정합니다.
• limits.recurrent_schedule — 제한이 재설정되는 빈도를 정의합니다.

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

스토어에 번들 표시

번들은 구현 방식(웹사이트 빌더를 통하거나 API를 통해)에 따라 카탈로그에 표시됩니다.

웹사이트 빌더를 통해 표시

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

1. 번들 생성.
2. 관리자 페이지의 프로젝트에서, 스토어프론트 > 웹사이트 섹션으로 이동합니다.
3. 원하는 사이트의 창에서 웹사이트 빌더 열기를 클릭합니다.

4. 스토어 블록에서, 스토어 섹션으로 이동합니다.
5. 아이템 유형 입력란에서 번들을 선택합니다.

6. 아이템 그룹 입력란에서 해당 그룹을 선택합니다.
7. 아이템 카드 레이아웃 선택.

8. 필요한 경우 카드 레이아웃 설정에서 해당 토글을 켜서 카드 레이아웃을 사용자 정의합니다.

9. 필요한 모든 변경 사항을 적용하고 웹사이트 출시 준비를 완료한 경우:
   1. 웹사이트 빌더의 오른쪽 상단 모서리에서, 게시를 클릭합니다.
   2. 게시하려는 페이지 옆의 확인란을 선택합니다.
   3. 게시를 클릭합니다.

사이트가 게시되면 번들 섹션이 활성화됩니다. 번들이 표시되지 않는 경우 번들의 상태가 사용 가능으로 설정되어 있고 시간 기반 표시 제한이 활성화되지 않았는지 확인하십시오.

API를 통해 번들 정보 가져오기

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

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

웹훅 설정

items 배열을 통해 주문 결제 성공 및 주문 취소 웹훅에 포함할 아이템 데이터를 구성할 수 있습니다.

사용자에게 번들 부여하기

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

• PlayFab을 통합한 경우, 인게임 재화와 아이템은 사용자의 PlayFab 인벤토리에 자동으로 부여됩니다.
• 사용자 정의 배송 시스템을 사용하는 경우, 모든 가상 아이템과 인게임 재화는 사용자 측에서 부여됩니다. 백엔드에서 주문 데이터를 수신하려면 웹훅 핸들러를 설정하는 것이 좋습니다. 필요한 데이터는 주문 결제 성공 웹훅에 포함됩니다.
• 번들 콘텐츠 배송이 비활성화되지 않은 경우, 번들 구매 후 번들에 포함된 모든 아이템은 주문 결제 성공 웹훅의 items 배열에 개별 아이템으로 나열됩니다. 번들에 다른 번들이 포함된 경우, 해당 번들도 분리되어 개별 아이템으로 전달됩니다.

이에 대한 방법과 구매 데이터 조회 방법에 대한 자세한 내용은 주문 상태 추적 설정 섹션을 참조하십시오.