인게임 재화
작동 방식
인게임 재화는 가상 상품을 구매하는 데 사용되는 가상 화폐입니다. 사용 방식에 따라 게임 경제 균형에 영향을 미치거나 애플리케이션 수익화와 관련됩니다.
주요 기능:
- 임의 금액의 가상 머니 판매 또는 고정 금액 인게임 재화 패키지 판매.
- 가상 머니 및 인게임 재화 패키지를 실제 화폐 또는 인게임 재화로 판매.
- 구매 가능한 인게임 재화 패키지 수 제한.
- 스토어에서 가상 머니 및 인게임 재화 패키지의 표시 기간 제한.
- 무료 인게임 재화 패키지.
인게임 재화 판매를 위한 다음 옵션이 제공됩니다:
- Any amount — 사용자가 지정한 금액의 가상 머니를 판매할 수 있습니다. 이 옵션을 사용하려면, 구매 시 사용자가 원하는 금액을 입력할 수 있도록 클라이언트 측에 입력란을 구현하세요.
- Packages — 미리 정의된 금액의 인게임 재화 패키지를 판매할 수 있습니다. 패키지 가격은 별도로 설정하며, 동일 금액의 가상 머니 표준 가격과 다를 수 있습니다.
예시: 한 패키지에는 100개의 금화가 들어 있으며 가격은 90달러입니다. 한편, 금화 한 개의 가격은 1달러입니다.
제한 사항:
- 패키지에는 한 가지 유형의 가상 머니만 추가할 수 있습니다.
- 다른 가상 머니로 가격을 설정하는 것은 API 호출로만 구성할 수 있습니다.
- 인게임 재화 패키지는 실제 화폐 또는 인게임 재화 가격을 지정하지 않고 무료로 설정할 수 있습니다. 이는 모바일 게임용 계정 또는 API 호출로 구성할 수 있습니다. 패키지에 속하지 않는 무료 가상 머니는 API 호출로만 생성할 수 있습니다.
- 패키지의 가상 머니 수량은 정수로만 지정할 수 있습니다.
설정 방법
게시자 계정에서 설정
계정에서 설정
API로 설정
가상 머니를 설정하려면 Virtual items and currency 그룹의 Admin 하위 섹션에 있는 호출을 사용하세요.
| 작업 | API 호출 |
|---|---|
| 가상 머니 생성. | Create virtual currency. |
| 가상 머니 가져오기. | Get virtual currency. |
| 가상 머니 목록 가져오기. | Get list of virtual currencies. |
| 가상 머니 업데이트. | Update virtual currency. |
| 가상 머니 삭제. | Delete virtual currency. |
| 구매 가능한 가상 머니 수량 제한. | Create virtual currency 또는 Update virtual currency API 호출에서 다음 매개변수를 전달하세요:
|
| 인게임 재화 패키지 생성. | Create virtual currency package. |
| 인게임 재화 패키지 가져오기. | Get virtual currency package. |
| 인게임 재화 패키지 목록 가져오기. | Get list of virtual currency packages. |
| 인게임 재화 패키지 업데이트. | Update virtual currency package. |
| 인게임 재화 패키지 삭제. | Delete virtual currency package. |
| 구매 가능한 인게임 재화 패키지 수량 제한. | Create virtual currency package 또는 Update virtual currency package API 호출에서 다음 매개변수를 전달하세요:
|
한도에 대한 자세한 내용은 다음 가이드를 참고하세요.
카탈로그에 가상 머니 표시
가상 머니 또는 인게임 재화 패키지의 표시는 카탈로그 구현 방식에 따라 달라집니다. 웹사이트 빌더 또는 API를 사용하세요.
웹사이트 빌더로 표시
인게임 재화 패키지 표시 방법:
게시자 계정의 프로젝트에서 Storefronts > Websites 섹션으로 이동하세요.
원하는 사이트의 패널을 클릭하세요.
계정의 프로젝트에서 Storefronts > Websites 섹션으로 이동하세요.
원하는 사이트의 패널을 클릭하세요.
계정의 프로젝트에서 Storefronts > Websites 섹션으로 이동하세요.
원하는 사이트의 패널을 클릭하세요.
계정의 프로젝트에서 Storefronts > Websites 섹션으로 이동하세요.
원하는 사이트의 패널을 클릭하세요.
모바일 게임용 계정의 프로젝트에서 Web Shop 섹션으로 이동하세요.
원하는 사이트의 패널을 클릭하세요.
사이트에 여러 페이지가 있다면, 필요한 페이지를 선택하세요:
- 에디터 상단에서 현재 페이지 제목을 클릭하세요.
- 드롭다운 목록에서 원하는 페이지를 선택하세요.
Store 블록 섹션에서, Item type 입력란에 웹사이트에서 판매할 인게임 재화 패키지를 선택하세요.
필요한 변경을 모두 적용하고 웹사이트 출시를 준비했다면:
- 사이트 에디터 오른쪽 상단에서 Publish를 클릭하세요.
- 게시할 페이지 옆의 체크박스를 선택하세요.
- Publish를 클릭하세요.
웹사이트를 게시할 수 없다면, 다음 조건을 모두 충족했는지 확인하세요:
- 웹사이트에 빈 섹션이 없습니다(빨간 표시로 표시됨).
- 엑솔라와 라이선스 계약을 체결했습니다.
- 메인 페이지가 게시되었거나 게시 대상으로 선택되었습니다. 메인 페이지 이전에는 하위 페이지를 게시할 수 없습니다.
사이트를 게시하면 인게임 재화 패키지 섹션이 표시됩니다. 패키지가 표시되지 않으면, 패키지 상태가 Available로 설정되어 있고 시간 기반 표시 제한이 활성화되어 있지 않은지 확인하세요.
API로 가상 머니 정보 가져오기
클라이언트 측에서 가상 머니 및 인게임 재화 패키지 카탈로그를 조회하려면 Virtual items and currency 그룹의 Catalog 하위 섹션에 있는 호출을 사용하세요.
| 작업 | API 호출 |
|---|---|
| SKU로 가상 머니 가져오기. | virtual_currency_sku 매개변수를 Get virtual currency by SKU API 호출에 전달하세요. |
| 가상 머니 목록 가져오기. | Get virtual currency list. |
| SKU로 인게임 재화 패키지 가져오기. | virtual_currency_package_sku 매개변수를 Get virtual currency package by SKU API 호출에 전달하세요. |
| 인게임 재화 패키지 목록 가져오기. | Get virtual currency package list. |
사용자에게 가상 머니 지급
아이템 유형 및 통합 설정에 따라 인게임 재화는 다음 방법 중 하나로 사용자에게 지급됩니다:
PlayFab을 통합한 경우, 가상 머니와 아이템은 사용자의 PlayFab 인벤토리에 자동으로 지급됩니다.
커스텀 지급 시스템을 사용하는 경우, 모든 가상 아이템과 가상 머니는 귀사 측에서 지급합니다. 백엔드에서 주문 데이터를 수신하려면 웹훅 핸들러를 설정하세요. 필요한 데이터는 Successful payment for order 웹훅에 포함됩니다.
자세한 내용과 기타 구매 데이터 조회 방법은 주문 상태 추적 설정 섹션을 참고하세요.
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
