가상 아이템

작동 방식

가상 아이템은 실질 또는 인게임 재화를 받고 판매할 수 있는 인게임 콘텐츠입니다.

주요 기능:

가격 구성 기능:

  • 하나의 아이템은 실질 및 인게임 재화 모두로 가격을 정할 수 있습니다.
  • 여러 실물 화폐 또는 인게임 재화로 가격을 설정할 수 있습니다. 이 경우 기본 화폐를 선택했는지 확인해야 합니다.
  • 실물 화폐 또는 인게임 재화로 가격을 지정하지 않아도 아이템을 생성할 수 있습니다. 이러한 아이템이 스토어에 표시되면 사용자가 무료로 사용할 수 있습니다.

가격 구성 제한 사항:

  • 가격 값이 0인 아이템을 생성할 수 없습니다.

가상 아이템의 3가지 유형:

소모성 가상 아이템

소모성 아이템은 많은 수량을 보유할 수 있으며 여러 번 구매할 수 있는 인벤토리 아이템입니다. 사용자가 소모하면 수량이 줄어듭니다.

주요 기능:

  • 아이템 재고를 인벤토리에 다시 채웁니다.
  • 같은 아이템의 많은 인스턴스를 사용자 인벤토리에 보관합니다.
  • 클라이언트 측에서 소모될 수 있습니다.

예: 수류탄, 탄환 등.

비소모성 가상 아이템

비소모성 아이템은 한 번만 누적될 수 있거나 구매될 수 있는 인벤토리 아이템입니다.

주요 기능:

  • 사용자는 이 아이템을 인벤토리에 한 단위만 가질 수 있습니다.
  • 클라이언트 측에서 소모하여 제거할 수 없습니다. 오직 서버 메소드를 통해 해당 아이템을 회수해야 합니다.

예: 위치에 대한 액세스, 상태, 코스메틱, 미리 설치된 것DLC, 모바일 게임용 광고 없음 옵션 등.

사용기간 제한 아이템

사용기간 제한 아이템은 일회성 구매 상품입니다. 만료 시에는 다시 구매해야 합니다.

주요 기능:

  • 만료되면 비활성화됩니다.
  • 다시 활성화하려면 사용자가 이 구독을 다시 구매해야 합니다.

예: Battle Pass, Season PassSeason Pass, 인게임 코스메틱 아이템에 대한 일시적인 액세스, 아이템 또는 추가 콘텐츠.

자세한 내용은 사용기간 제한 아이템 레시피를 참조하십시오.

구매할 수 있는 아이템 개수 제한

번들 구매를 제한할 수 있습니다. 예를 들어 다음과 같이 제한:

  • 사용자당 아이템 개수
  • 한 번 구매했을 때만 적용되는 웰컴 아이템

사용자가 지정된 한도까지 구입한 경우 아이템이 카탈로그에 표시되지 않습니다.

최대 구매 가능 아이템 개수와 사용자가 구매 가능한 아이템 잔여 개수를 표시할 수 있습니다.

게시자 계정에 아이템을 생성할 때 구매 한도를 설정하려면 한 사용자 이 아이템 구매 회수 제한 토글을 에 설정하고 아이템 구매 가능 회수를 지정합니다.

아이템에 대한 정보를 얻으려면 가상 아이템 및 인게임 재화 방법 그룹에서카탈로그 구독 방법을 사용할 수 있습니다.

응답으로 인게임 재화 관련 정보에 추가해서 다음 정보를 받게 됩니다.

  • 한 사용자가 구매할 수 있는 최대 아이템 개수
  • 사용자가 구입할 수 있는 아이템 잔여 개수

알림

인증 받지 않은 사용자에게는 구매할 수 있는 최대 아이템 개수가 항상 표시됩니다. 사용자에게 남은 아이템 개수를 표시하려면(현재 제한 설정에 따름) 가상 아이템 및 인게임 재화 메소드 그룹의 카탈로그 하위 섹션 메소드를 사용하여 아이템 카탈로그를 요청할 때 사용자 인증 데이터를 전달해야 합니다.

사용자가 사용할 수 있는 아이템 개수를 올바르게 표시하려면 인증을 구성해야 합니다.

응답 예제:

Copy
Full screen
Small screen

{
  "items": [
    {
      "sku": "big_rocket",
      "name": "Big Rocket",
      "groups": [
        {
          "external_id": "accessory",
          "name": "Accessory"
        }
      ],
      "attributes": [
        {
          "external_id": "stack_size",
          "name": "Stack size",
          "values": [
            {
              "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
              "value": "5"
            }
          ]
        }
      ],
      "type": "virtual_good",
      "description": "Big Rocket - description",
      "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
      "is_free": false,
      "price": {
        "amount": "100.99",
        "amount_without_discount": "100.99",
        "currency": "USD"
      },
      "virtual_prices": [
        {
          "amount": 100,
          "sku": "vc_test",
          "is_default": true,
          "amount_without_discount": 100,
          "image_url": "http://image.png",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "description": "description"
        }
      ],
      "can_be_bought": true,
      "inventory_options": {
        "consumable": {
          "usages_count": 1
        },
        "expiration_period": {
          "type": "day",
          "value": 1
        }
      },
      "virtual_item_type": "non_renewing_subscription",
      "limits": {
        "per_user": {
            "total": 5,
            "available": 5
        },
        "per_item": null
      },
}

알림

엑솔라는 한도가 초과되지 않도록 하고, 사용자가 설정된 한도보다 더 많은 아이템을 구매하지 못하도록 합니다.

결제 인터페이스를 열고 어떤 아이템에 대해 지불하면 이 아이템과 관련된 모든 미지급 주문이 무효화됩니다.

: 사용자는 아이템을 구매할 때까지 여러 브라우저 탭에서 구매 제한이 있는 항목에 대한 결제 양식을 열 수 있습니다. 그러면 동일한 아이템에 대해 여러 주문이 자동으로 생성됩니다. 한 탭에서 아이템을 구입하면 엑솔라가 동일한 아이템에 대한 모든 미결제 주문을 무효화합니다.

사용자

  • 인게임 재화를 게임에 추가하고 이 화폐를 받고 가상 아이템을 판매하는 것으로 게임 경제 또는 수익 창출을 설정하려는 파트너.
  • 인게임 스토어를 통합했고 새 상품 유형(가상 아이템)을 설정하려는 파트너.

획득 방법

통합 절차

  1. 가상 아이템 및 가상 아이템 그룹을 구성합니다.
  2. 지역 제한 및 지역별 가격을 구성합니다.

가상 아이템 및 가상 아이템 그룹 구성

가상 아이템을 설정하려면 가상 아이템 그룹을 구성해야 합니다. 그룹은 다단계 카탈로그를 보유할 수 있게 해 줍니다. 지정된 그룹이 없는 아이템들은 Ungrouped 그룹에 추가됩니다.

가상 아이템 및 가상 아이템 그룹 설정 방법:

게시자 계정을 통한 구성

API 호출을 통한 구성

가상 아이템을 설정하려면 Virtual Items & Currency그룹의 Admin 하위 섹션으로부터의 API 호출을 사용합니다.

주의
Admin 하위 섹션의 메소드는 프런트 엔드 측 스토어의 카탈로그를 구축하기 위해 만들어진 것이 아닙니다. 해당 메소드는 방문 페이지, 웹 스토어, 인게임 논리용으로 사용해야 합니다.

기본 인증은 API 호출에 사용됩니다. Authorization:Basic <your_authorization_basic_key>를 전달합니다. 여기에서 <your_authorization_basic_key>는 Base64 표준으로 인코딩된 판매자 ID:API 키 쌍입니다. 이러한 매개변수를 찾으려면 게시자 계정으로 이동합니다.

  • 판매자 ID 표시 위치:
    • 프로젝트 설정 > 웹훅 섹션
    • 회사 설정 > 회사 섹션
    • 게시자 계정 페이지의 브라우저 주소 표시줄에 있는 URL. 이 URL의 형식: https://publisher.xsolla.com/​판매자 ID/게시자 계정 섹션

  • API 키는 생성할 때 한 번만 게시자 계정에 표시되며 따로 저장하고 관리해야 합니다. 다음 섹션에서 새 키를 생성할 수 있습니다.
    • 회사 설정 > API 키
    • 프로젝트 설정 > API 키

주의

API 키 작업에 대한 자세한 정보는 API 참조를 확인하세요.

주요 권장 사항:

  • 본인의 공간에 생성된 API 키를 저장합니다.. 생성된 API 키는 게시자 계정에서 한 번만 볼 수 있습니다.
  • API 키를 비밀로 유지해야 합니다. 이러한 API 키는 개인 계정과 게시자 계정의 프로젝트에 대한 액세스를 제공합니다.
  • API 키는 서버에 저장해야 하며 바이너리나 프론트엔드에는 저장해선 안 됩니다.

클라이언트 측 가상 아이템 카탈로그를 가져오려면 Virtual Items & Currency 그룹의 Catalog 하위 섹션의 API 호출을 사용합니다. 이 호출은 기본 권한 부여가 필요하지 않습니다.

그룹으로 나누어지지 않은 아이템의 전체 목록을 가져오려면 Get virtual items list API 호출을 사용합니다. 확실한 어떤 그룹의 아이템 목록을 가져오려면 external_id 매개 변수를 Get items list by specified group 호출에 전달합니다.

지역 제한 및 지역별 가격 구성

가상 아이템에 대해 지역 제한을 설정하려면 아이템이 구매 가능한 지역의 식별자를 포함하는 개체 배열을 Create item 또는 Update item 호출에 전달합니다.

Copy
Full screen
Small screen

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

가상 아이템에 대해 지역별 가격을 설정하려면 지역별 가격 설정을 포함하는 개체 배열을 Create item 또는 Update item 호출에 전달합니다.

Copy
Full screen
Small screen

"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

알림
미리 프로젝트에서 지역을 구성해야 합니다. 이를 수행하려면 계정 관리자에게 문의하십시오.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2022년 11월 25일

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

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!