인게임 재화

작동 방식

인게임 재화는 가상 상품을 구매하고 판매하는 데 사용되는 가상 화폐입니다. 사용 방식에 따라 게임 경제 균형에 영향을 미치거나 애플리케이션 수익화와 관련됩니다.

주요 기능:

  • 인게임 재화 또는 확정 금액으로 인게임 재화 패키지 판매.
  • 실제 화폐 또는 인게임 재화로 인게임 재화 및 인게임 재화 패키지 판매.
  • 구매할 수 있는 인게임 재화 패키지 개수 제한.
  • 스토어에서 인게임 재화 및 인게임 재화 패키지의 표시 시간 제한.
  • 무료 인게임 재화 패키지.
알림
할인 캠페인 및 프로모션 코드 또는 쿠폰이 포함된 캠페인에서는 반드시 인게임 재화 패키지를 사용해야 합니다. 임의의 인게임 재화 금액은 보너스 캠페인에서만 사용할 수 있습니다.

인게임 재화 판매를 위한 다음 옵션이 제공됩니다:

  • 금액 - 사용자가 지정한 금액으로 인게임 재화를 판매할 수 있습니다. 이 옵션을 사용하려면 구매 시 사용자가 원하는 통화 금액을 입력할 수 있는 입력 필드를 클라이언트 측에 구현하십시오.
  • 패키지 - 미리 정해진 금액으로 인게임 재화를 판매할 수 있습니다. 재화 패키지의 가격은 별도로 설정되며, 동일한 금액의 해당 화폐 표준 가격과 다를 수 있습니다.
  1. 예시: 한 패키지에는 100개의 금화가 들어 있으며 가격은 90달러입니다. 한편, 금화 한 개의 가격은 1달러입니다.

제한 사항:

  • 패키지에는 한 종류의 인게임 재화만 추가할 수 있습니다.
  • 다른 인게임 재화 가격은 API 호출을 통해서만 설정할 수 있습니다.
  • 인게임 재화 패키지는 실제 화폐나 인게임 재화로 가격을 지정하지 않고 무료로 구성할 수 있습니다. 이는 관리자 페이지 또는 API 호출을 통해 구성할 수 있습니다. 패키지의 일부가 아닌 무료 인게임 재화는 API 호출을 통해서만 생성할 수 있습니다.
  • 패키지에 포함된 인게임 재화 금액은 정수로만 지정할 수 있습니다.

설정 방법

관리자 페이지를 통한 설정

참고
인게임 재화 또는 인게임 재화 패키지를 설정하기 전에, 아이템을 분류하고 상점 내 표시 방식을 관리하는 데 도움이 되도록 그룹을 생성하는 것이 좋습니다.

API를 통한 설정

인게임 재화를 설정하려면 가상 아이템 및 인게임 재화 그룹에서 관리자 하위 섹션의 호출을 사용합니다.

알림
관리자 하위 섹션의 호출은 프런트 엔드에 스토어 카탈로그를 구축하도록 만들어진 것이 아닙니다. 해당 메서드를 방문 페이지, 웹 스토어, 인게임 논리용으로 사용하지 않아야 합니다.
작업API 호출
인게임 재화를 생성합니다.인게임 재화 생성.
인게임 재화를 가져옵니다.인게임 재화 목록 가져오기.
인게임 재화 패키지 목록을 가져옵니다.인게임 재화 목록 가져오기.
인게임 재화를 업데이트합니다.인게임 재화 업데이트.
인게임 재화를 삭제합니다.인게임 재화 삭제.
구매 가능한 인게임 재화 금액을 제한합니다.인게임 재화 생성하기 또는 인게임 재화 업데이트 API 호출 시 다음 매개 변수를 전달합니다:
  • limits - 구매 가능한 인게임 재화의 최대 수량을 지정합니다.
  • limits.recurrent_schedule - 한도 재설정 주기를 정의합니다.
인게임 재화 패키지를 생성합니다.인게임 재화 패키지 생성.
인게임 재화 패키지를 가져옵니다.인게임 재화 패키지 목록 가져오기.
인게임 재화 패키지 목록을 가져옵니다.인게임 재화 패키지 목록 가져오기.
인게임 재화 패키지를 업데이트합니다.인게임 재화 패키지 업데이트.
인게임 재화 패키지를 삭제합니다.인게임 재화 패키지 삭제.
구매할 수 있는 인게임 재화 패키지 개수 제한.인게임 재화 패키지 생성 또는 인게임 재화 패키지 업데이트 API 호출 시 다음 매개 변수를 전달합니다:
  • limits - 구매 가능한 인게임 재화 패키지의 최대 수량을 지정합니다.
  • limits.recurrent_schedule - 한도 재설정 주기를 정의합니다.
알림
스토어 내 인게임 재화의 표시 기간은 API 호출을 통해서만 설정할 수 있습니다.

스토어에 인게임 재화 표시

인게임 재화 또는 인게임 재화 패키지의 표시는 카탈로그 구현 방식에 따라 달라집니다 - 웹사이트 빌더를 통해 또는 API를 통해.

웹사이트 빌더를 통해 표시

참고
스토어 카탈로그에는 인게임 재화 패키지만 표시할 수 있습니다.
인게임 재화 패키지 표시 방법:
  1. 인게임 재화 패키지 생성.
  2. 관리자 페이지의 프로젝트에서, 스토어프론트 > 웹 사이트 섹션으로 이동합니다.
  3. 원하는 사이트의 창에서 웹사이트 빌더 열기를 클릭합니다.
  1. 스토어 블록 섹션에서, 아이템 유형 입력란에 웹 사이트에서 판매할 인게임 재화 패키지를 선택합니다.
  1. 아이템 카드 레이아웃 설정.
  2. 필요한 모든 변경 사항을 적용하고 웹사이트 출시 준비를 완료한 경우:
    1. 웹사이트 빌더의 오른쪽 상단 모서리에서, 게시를 클릭합니다.
    2. 게시하려는 페이지 옆의 확인란을 선택합니다.
    3. 게시를 클릭합니다.
알림

웹 사이트 게시를 사용할 수 없는 경우 다음과 같은 모든 조건이 충족되는지 확인하십시오:

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

API를 통해 인게임 재화 정보 가져오기

클라이언트 측에서 인게임 재화 및 인게임 재화 패키지 카탈로그를 가져오려면 가상 아이템 및 인게임 재화 그룹의 카탈로그 하위 섹션의 호출을 사용하십시오.

작업API 호출
SKU로 인게임 재화를 가져옵니다.virtual_currency_sku 매개 변수를 SKU로 인게임 재화 가져오기 API 호출에 전달합니다.
인게임 재화 목록을 가져옵니다.인게임 재화 목록 가져오기.
SKU로 인게임 재화 패키지를 가져옵니다.virtual_currency_package_sku 매개 변수를 SKU로 인게임 재화 패키지 가져오기 API 호출에 전달합니다.
인게임 재화 패키지 목록을 가져옵니다.인게임 재화 패키지 목록 가져오기.

사용자에게 인게임 재화 부여

아이템 유형 및 통합 설정에 따라 인게임 재화는 다음 방법 중 하나로 사용자에게 지급됩니다:

  • PlayFab을 통합한 경우, 인게임 재화와 아이템은 사용자의 PlayFab 인벤토리에 자동으로 부여됩니다.
  • 사용자 정의 배송 시스템을 사용하는 경우, 모든 가상 아이템과 인게임 재화는 사용자 측에서 부여됩니다. 백엔드에서 주문 데이터를 수신하려면 웹훅 핸들러를 설정하는 것이 좋습니다. 필요한 데이터는 주문 결제 성공 웹훅에 포함됩니다.
이에 대한 방법과 구매 데이터 조회 방법에 대한 자세한 내용은 주문 상태 추적 설정 섹션을 참조하십시오.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
마지막 업데이트: 2026년 2월 13일

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

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