가상 아이템

작동 방식

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

주요 기능:

가격 구성 기능:

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

가격 구성 제한 사항:

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

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

소모성 가상 아이템

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

주요 기능:

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

예: 수류탄, 탄환 등.

비소모성 가상 아이템

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

주요 기능:

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

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

사용기간 제한 아이템

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

주요 기능:

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

예: Battle Pass, Season 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
      },
}
알림

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

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

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

스토어 내 아이템의 표시 시간 제한

스토어에서 아이템의 표시 기간을 다음과 같이 설정할 수 있습니다:
  • 휴일 세일 기간과 같이 특정 시점에 카탈로그의 관련성을 유지.
  • 카탈로그에 표시하지 않고 미리 아이템을 생성합니다.
  • 아이템 옆에 타이머를 표시하여 사용자가 아이템을 구매하도록 동기를 부여합니다.
알림
웹사이트 빌더를 사용하여 카탈로그 인터페이스를 생성하면 타이머가 자동으로 표시됩니다. 자체 인터페이스에서 카탈로그를 생성하는 경우 타이머를 구현해야 합니다.
관리자 페이지를 통해 스토어에 아이템을 표시하는 기간 제한을 설정하려면 기간을 선택하고 해당 기간의 시간대, 시작일과 종료일을 지정합니다. 아이템 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.
알림
가상 아이템, 인게임 재화 또는 인게임 재화 패키지를 생성한 후에는 해당 아이템의 상태를 설정하여 사용 가능, 사용 불가능 또는 일부 사용 가능 여부를 결정할 수 있습니다.
API를 통해 스토어에 아이템을 표시하는 시간 제한을 설정하려면 가상 아이템 생성하기 또는 가상 아이템 업데이트 API 호출에 다음 매개 변수를 전달합니다:
  • periods[0].date_from는 항목 표시 기간 시작 날짜와 시간을 YYYY-MM-DDThh:mm:ss±TMZ 형식으로 표시하고, TMZhh:mm GMT 형식의 표준 시간대 표시기입니다.
  • periods[0].date_until는 아이템 표시 기간 시작 날짜와 시간을 YYYY-MM-DDThh:mm:ss±TMZ 형식으로 표시하고, CTMZhh:mm GMT 형식의 표준 시간대 표시기입니다. 항목 표시 기간의 끝을 표시하지 않으려면 null를 전달합니다.

스토어에 아이템을 표시하는 기간을 여러 개 설정할 수 있습니다. 이를 위해 가상 아이템 생성하기 or 가상 아이템 업데이트 메서드에서 모든 기간의 시작 날짜와 종료 날짜가 포함된 개체 배열을 전달합니다.

:

Copy
Full screen
Small screen
    "periods": [
          {
            "date_from": "2022-06-10T14:00:00+03:00",
            "date_until": "2022-06-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-07-10T14:00:00+03:00",
            "date_until": "2022-07-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-08-10T14:00:00+03:00",
            "date_until": "2022-08-30T14:00:00+03:00"
          }
    ]
    

    사용자

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

    획득 방법

    통합 절차

    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
      }
    ]
    
    알림
    미리 프로젝트에서 지역을 구성해야 합니다. 이를 수행하려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 메일을 보내주세요.
    이 기사가 도움이 되었나요?
    감사합니다!
    개선해야 할 점이 있을까요? 메시지
    유감입니다
    이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
    의견을 보내 주셔서 감사드립니다!
    메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
    이 페이지 평가
    이 페이지 평가
    개선해야 할 점이 있을까요?

    답하기 원하지 않습니다

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

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

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