카탈로그에서 아이템을 그룹화하고 정렬하는 방법

그룹으로 아이템을 추가하여 멀티레벨 카탈로그를 생성할 수 있습니다. 그룹에는 동일하거나 다른 유형의 아이템을 포함할 수 있습니다.

  • 가상 아이템
  • 인게임 재화
  • 인게임 재화 패키지
  • 번들
  • 게임 키
그룹 내에서 특정 순서로 아이템을 정렬하여 매출을 늘리고 사용자에게 인기 아이템을 표시할 수 있습니다. 그룹별로 아이템을 요청하면 관리자 페이지에 정렬된 순서대로 아이템을 가져옵니다.

알림
관리자 페이지에서는 아이템 카탈로그의 아이템을 정렬할 수 없습니다.

주요 기능:

  • 여러 그룹의 같은 아이템을 추가합니다.
  • 더 작은 그룹을 더 큰 그룹에 추가하여 멀티레벨 카탈로그를 만듭니다.
  • 그룹 순서를 변경합니다.
  • 아이템 순서를 변경합니다.

그룹 설정 방법:

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

그룹 생성

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

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

  1. 다음 매개 변수를 지정합니다.
    • 외부 ID - 고유 그룹 코드.
    • 그룹 이름.
  2. 스토어에 그룹 표시 토글을 켜짐(On)으로 설정합니다.
  3. 그룹 만들기를 클릭합니다.

그룹 편집

그룹 편집 방법:

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

  1. 필요에 따라 설정을 변경합니다.
  1. 변경 사항 저장을 클릭합니다.
알림
스토어에서 그룹을 숨긴 경우(스토어에 그룹 표시 토글을 꺼짐(Off)으로 설정한 경우) 이러한 그룹은 다음과 같습니다.
  • 아이템 그룹 목록 가져오기 API를 호출해도 응답으로 반환되지 않습니다.
  • 아이템 목록을 가져오기 위해 클라이언트 메서드를 호출할 때 이 그룹에 포함된 아이템의 속성에 표시되지 않습니다.

그룹에 아이템 추가

필수 그룹에 가상 아이템을 추가하려면 새 아이템을 만들거나 기존 아이템을 편집할 때 그룹을 지정합니다.
알림
특정 그룹에 속하지 않은 아이템은 그룹 목록 끝에 있는 Ungrouped 그룹에 자동으로 추가됩니다. 이 그룹에 속하는 아이템에는 다음과 같은 제약이 있습니다.

아이템 정렬

아이템 정렬 방법(가상 아이템을 예시로 사용):
  1. 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 가상 아이템 섹션으로 이동합니다 .
  2. 그룹으로 이동합니다.
  3. 가상 아이템 번호 위로 마우스를 가져갑니다. 아이콘이 표시됩니다. 가상 아이템을 새 위치로 끌어다 놓습니다.

API 호출을 통한 설정

그룹에 아이템 추가

API 호출을 통해 기존 그룹에 아이템을 추가하려면 아이템이 속해야 하는 그룹의 external_id 매개 변수가 포함된 배열을 group 필드에 전달합니다.

요청 예시:

Copy
Full screen
Small screen
 1{
 2   "sku": "sword",
 3   "name": {
 4      "en": "Sword",
 5   },
 6   "is_enabled": true,
 7   "is_free": false,
 8   "order": 1,
 9   "description": {
10      "en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt.",
11   },
12   "prices": [
13      {
14         "amount": 100,
15         "currency": "USD",
16         "Is_enabled": true,
17         "is_default": true
18      }
19   ],
20   "vc_prices": [ ],
21   "is_show_in_store": true,
22   "groups": [
23   "chests", "bonus"
24],
25}

그룹 목록 가져오기

주의
API 호출을 통해서는 가상 아이템에 대해서만 지정된 그룹의 아이템 목록 및 모든 그룹의 목록을 가져올 수 있습니다. 다른 아이템 그룹과 함께 작업하려면 필터링을 사용하십시오.
모든 그룹 목록을 가져오려면 아이템 그룹 목록 가져오기 API 호출을 사용합니다. 지정된 그룹의 아이템 목록을 가져오려면 external_id 매개 변수를 지정된 그룹별로 아이템 목록 가져오기 API 호출에 전달합니다.

아이템 필터링

필수 그룹 아이템 필터링 방법:
  1. 다음 API 호출을 통해 아이템 목록을 가져옵니다.
  2. 필터링을 사용하여 external_id 매개 변수에서 지정된 필수 그룹의 groups 매개 변수를 가진 아이템을 찾습니다.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
마지막 업데이트: 2025년 7월 18일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!
피드백을 보내는 중 문제가 발생했습니다
잠시 후 다시 시도하거나 doc_feedback@xsolla.com으로 연락해 주세요.