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

아이템을 그룹별로 추가할 수 있습니다. 그룹은 동일하거나 다른 유형의 아이템을 포함할 수 있습니다:

  • 가상 아이템
  • 인게임 재화
  • 인게임 재화 패키지
  • 번들
  • 게임 키
그룹 내에서 특정 순서로 아이템을 정렬하여 판매를 늘리고 사용자에게 인기 있는 아이템을 제시할 수 있습니다. 그룹별로 아이템을 요청할 경우, 해당 아이템들은 관리자 페이지에서 정렬된 순서대로 제공됩니다.

참고
아이템 그룹 내에서만 아이템을 정렬할 수 있으며, 그룹화되지 않은 카탈로그를 정렬할 수 없습니다.

주요 기능:

  • 여러 그룹에 동일한 아이템 추가.
  • 그룹 순서 변경.
  • 아이템 순서 변경.

그룹 설정:

  1. 관리자 페이지를 통해 그룹을 생성편집아이템을 추가하고 그룹에 대한 정보 수집:

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

그룹 생성

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

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

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

그룹 편집

그룹을 편집하는 방법:

  1. 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 섹션으로 이동합니다.
  2. 그룹 표시를 클릭합니다.
  3. 필요한 그룹 옆에 있는 를 클릭하고 드롭다운 목록에서 편집을 선택합니다.

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

그룹에 아이템 추가

필수 그룹에 가상 아이템을 추가하려면 그룹을 지정하세요:

  • 새 아이템 생성 시
  • 관리자 페이지에서 기존 아이템 편집 시:
    • 아이템 기본 설정에서

    • 가상 아이템 목록 내 그룹 드롭다운 목록에서
참고
특정 그룹이 지정되지 않은 아이템은 그룹 목록의 맨 끝에 위치한 Ungrouped 그룹에 자동으로 추가됩니다. 이 그룹의 아이템에는 다음과 같은 제한 사항이 적용됩니다:

아이템 정렬

아이템 그룹 내에서 아이템 정렬 방법:

  1. 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 섹션으로 이동합니다.
  2. 그룹 표시를 클릭합니다.
  3. 그룹으로 이동합니다.
  4. 가상 아이템 번호 위로 마우스를 가져갑니다. 아이콘이 표시됩니다. 가상 아이템을 새 위치로 끌어다 놓습니다.

그룹 정렬

그룹 정렬 방법:

  1. 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 섹션으로 이동합니다.
  2. 그룹 표시를 클릭합니다.
  3. 그룹 이름 위로 마우스를 가져갑니다. 아이콘이 표시됩니다. 그룹을 새 위치로 드래그합니다.

API를 통한 설정

그룹에 아이템 추가

API 호출을 통해 기존 그룹에 아이템을 추가하려면 group 입력란에 아이템이 속해야 하는 그룹의 external_id 매개 변수를 포함하는 배열을 전달하십시오:

요청 예시:

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",
24    "bonus"
25  ]
26}

그룹 목록 가져오기

모든 그룹 목록을 가져오려면 아이템 그룹 목록 가져오기 API 호출을 사용합니다. 지정된 그룹의 아이템 목록을 가져오려면 external_id 매개 변수를 지정된 그룹별로 아이템 목록 가져오기 API 호출에 전달합니다.

아이템 필터링

필요한 그룹의 아이템을 필터링하는 방법:

  1. 다음 API 호출을 통해 아이템 목록을 가져옵니다:
  2. groups매개 변수에 지정된 필요한 그룹의 external_id 매개 변수를 사용하여 필터링을 통해 해당 아이템을 찾습니다.

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
마지막 업데이트: 2026년 2월 13일

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

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