가상 아이템
작동 방식
가상 아이템은 사용자가 실제 통화 또는 인게임 재화로 구매하거나 보너스로 받을 수 있는 인게임 아이템입니다. 가상 아이템은 물리적 형태를 갖지 않으며 게임 내에서만 사용됩니다. 가상 아이템의 예에는 스킨, 물약, 무기, 열쇠 및 게임 플레이 또는 캐릭터 외형에 영향을 주는 기타 요소가 포함됩니다.
주요 기능:
- 유연한 가격 설정:
- 실제 통화 및/또는 인게임 재화로 단일 아이템의 가격 설정.
- 무료 아이템 생성.
- 사용자의 국가 및 통화 자동 감지.
- 가용성 구성:
- 특정 지역에서의 아이템 판매 제한.
- 구매 가능한 아이템 수 제한.
- 스토어 내 아이템의 표시 시간 제한.
- 구매가 불가능한 아이템 설정. 아이템은 카탈로그에서 숨겨질 수도 있지만 번들 일부나 다른 아이템의 보너스로 제공될 수 있습니다.
참고
설정 방법
관리자 페이지를 통한 설정
참고
가상 아이템을 설정하기 전에, 아이템을 분류하고 스토어에 표시하는 방식을 관리하려면 그룹을 생성하는 것이 좋습니다.
- 관리자 페이지의 프로젝트에서 아이템 카탈로그 > 모든 아이템 섹션으로 이동합니다.
- 추가를 클릭하고 드롭다운 메뉴에서 가상 아이템을 선택합니다.
- 다음 매개 변수 지정:
- 이미지(선택 사항).
- SKU.
- 아이템이 속해 있는 하나 또는 여러 그룹.
- 이름.
- 설명(선택 사항).
- 스토어에 가상 아이템을 표시하는 방식을 구성하려면 적절한 상태를 선택하세요.
- 유료 또는 무료 입력란에서 가격을 설정하거나 무료 아이템을 생성하세요:
- 무료 아이템을 생성하려면 무료 아이템을 선택하세요.
- 가격을 설정하려면 유료 아이템을 선택하고 실제 통화로 가격을 지정하세요. 필요할 경우하세요.
참고
아이템은 여러 실제 통화 및 인게임 재화로 되어 있는 가격을 가질 수 있습니다. 이 경우 각 유형에 대해 실제 통화나 인게임 재화 중 하나로 기본 통화를 지정해야 합니다.
- 구매 가능한 아이템 수를 제한하려면 아이템 구매 횟수 제한 토글을 켜고 원하는 수량을 입력하세요.
- 제한이 재설정되는 빈도를 설정하는 방법:
- 드롭다운 목록에서 기간을 선택하세요:
- 매일.
- 매주.
- 매월.
- 사용자 정의 간격 – 아이템의 표시 시작 날짜부터 계산됩니다.
- 정기적 새로고침 없음.
- 드롭다운 목록에서 기간을 선택하세요:
- 선택한 기간에 따라 재설정 일정을 설정합니다.
- 아이템 표시 시간 제한 설정(선택 사항):
- 스토어에서 아이템 표시 입력란에서 제한 시간을 선택합니다.
- 시간대와 기간의 시작 및 종료 시점을 지정합니다.
- 아이템 표시 기간의 종료 시점을 표시하지 않으려면 종료일 없음 상자를 선택하십시오.
- 다음 방법 중 하나로 속성을 구성합니다:
- 설정을 확인하고 아이템 생성을 클릭합니다.
API를 통한 설정
가상 아이템을 설정하려면 가상 아이템 및 인게임 재화 그룹에서 관리자 하위 섹션의 호출을 사용합니다.
알림
관리자 하위 섹션의 호출은 프런트 엔드에 스토어 카탈로그를 구축하도록 만들어진 것이 아닙니다. 해당 메서드를 방문 페이지, 웹 스토어, 인게임 논리용으로 사용하지 않아야 합니다.
| 작업 | API 호출 |
|---|---|
| 가상 아이템을 생성합니다. | 가상 아이템 생성하기. |
| 가상 아이템을 가져옵니다. | 가상 아이템 가져오기. |
| 가상 아이템 목록을 가져옵니다. | 가상 아이템 목록 가져오기. |
| 지정한 그룹으로 가상 아이템 목록을 가져옵니다. | 지정된 그룹 외부 ID로 가상 아이템 목록 가져오기 API 호출 시 external_id 매개 변수를 전달합니다. |
| 관리 목적으로 그룹별 가상 아이템 목록을 가져옵니다. | 지정된 그룹 ID로 가상 아이템 목록 가져오기 API 호출 시 group_id 매개 변수를 전달합니다. |
| 가상 아이템을 업데이트합니다. | 인게임 재화 업데이트. |
| 가상 아이템을 삭제합니다. | 인게임 재화 삭제. |
| 구매할 수 있는 가상 아이템 개수를 제한합니다. | 인게임 재화 생성하기 또는 인게임 재화 업데이트 API 호출 시 다음 매개 변수를 전달합니다:
|
참고
한도에 대한 자세한 내용은 다음 지침을 참조하십시오:
스토어에 보너스 아이템 표시
가상 아이템의 표시는 카탈로그 구현 방식에 따라 달라집니다 - 웹사이트 빌더를 통해 또는 API를 통해.
웹사이트 빌더를 통해 표시
웹 사이트에 가상 아이템을 표시하는 방법:
참고
웹사이트 빌더에서 가상 아이템을 표시하려면 사전에 그룹을 생성하십시오. 가상 아이템은 그룹의 일부로만 스토어 카탈로그에 표시됩니다.
- 관리자 페이지의 프로젝트에서, 스토어프론트 > 웹 사이트 섹션으로 이동합니다.
- 원하는 사이트의 창에서 웹사이트 빌더 열기를 클릭합니다.
- 스토어 블록 섹션에서 아이템 유형 입력란에서 가상 아이템을 선택하고, 아이템 그룹 입력란에서 웹 사이트에서 판매하려는 아이템 그룹을 선택합니다.
- 아이템 카드 레이아웃 설정.
- 필요한 모든 변경 사항을 적용하고 웹사이트 출시 준비를 완료한 경우:
- 웹사이트 빌더의 오른쪽 상단 모서리에서, 게시를 클릭합니다.
- 게시하려는 페이지 옆의 확인란을 선택합니다.
- 게시를 클릭합니다.
알림
웹 사이트 게시를 사용할 수 없는 경우 다음과 같은 모든 조건이 충족되는지 확인하십시오:
- 웹 사이트에 빈 섹션이 없어야 합니다(빨간색 표시로 표시됨).
- 엑솔라와의 라이선스 계약을 체결해야 합니다.
- 메인 페이지가 게시되거나 게시를 위해 선택됩니다. 메인 페이지보다 먼저 하위 페이지를 게시할 수 없습니다.
사이트가 게시되면 가상 아이템 그룹이 있는 섹션이 활성화됩니다. 아이템이 표시되지 않는 경우 패키지 상태가 사용 가능으로 설정되어 있고 시간 기반 표시 제한이 활성화되지 않았는지 확인하십시오.
API를 통해 가상 아이템 정보 가져오기
클라이언트 측에서 가상 아이템 카탈로그를 검색하려면 가상 아이템 및 인게임 재화 메서드 그룹의 카탈로그 하위 섹션에 있는 메서드를 사용하십시오. 이 메서드 사용에는 인증이 필요하지 않습니다.
| 작업 | API 호출 |
|---|---|
| SKU로 가상 아이템 가져오기 | SKU로 가상 아이템 가져오기 API 호출 시 item_sku 매개 변수를 전달합니다. |
| 가상 아이템 목록을 가져옵니다. | 가상 아이템 목록 가져오기. |
| 지정한 그룹으로 가상 아이템 목록을 가져옵니다. | 지정한 그룹으로 아이템 목록 가져오기 API 호출 시 external_id 매개 변수를 전달합니다. |
| 프로젝트 내 가상 아이템 전체 목록을 가져옵니다. | 모든 가상 아이템 목록 가져오기. |
사용자에게 가상 아이템 부여하기
아이템 유형 및 통합 설정에 따라 가상 아이템은 다음과 같은 방법 중 하나로 사용자에게 부여됩니다:
- PlayFab을 통합한 경우, 인게임 재화와 가상 아이템은 사용자의 PlayFab 인벤토리에 자동으로 부여됩니다.
- 사용자 정의 배송 시스템을 사용하는 경우, 모든 가상 아이템과 인게임 재화는 사용자 측에서 부여됩니다. 백엔드에서 주문 데이터를 수신하려면 웹훅 핸들러를 설정하는 것이 좋습니다. 필요한 데이터는 주문 결제 성공 웹훅에 포함됩니다.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.유용한 링크
마지막 업데이트:
2026년 2월 13일
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
