인게임 재화

작동 방식

인게임 재화는 가상 상품을 구매 및 판매하는 데에 사용되는 가상 머니입니다. 목적에 따라 인게임 재화는 게임 경제 균형에 영향을 주거나 앱의 수익 창출과 연결되어 있습니다.

주요 기능:

정해진 금액의 인게임 재화 또는 별도의 화폐 패키지 판매.
하드 화폐 판매.
인게임 재화 및 인게임 재화 패키지를 실제 또는 가상 화폐로 판매.
구매할 수 있는 인게임 재화 패키지 수 제한.
스토어에서 인게임 재화 및 인게임 재화 패키지의 표시 시간 제한.
무료 아이템.

가격이 0인 가상 화폐 및 가상 화폐 패키지를 만들려는 경우 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 메일을 보내주세요.

할인이 있는 캠페인, 프로모션 코드 또는 쿠폰이 있는 캠페인에서, 인게임 재화 패키지만 사용할 수 있습니다. 모든 인게임 재화 금액은 보너스가 있는 캠페인에만 사용할 수 있습니다.

화폐 판매 선택 사항

인게임 재화 판매 선택 사항:

모든 금액의 인게임 재화 판매
인게임 재화 패키지 판매

모든 금액대의 인게임 재화 판매

사용자가 요구하는 금액의 인게임 재화를 판매합니다. 애플리케이션의 클라이언트 측에서 구매를 위한 요구 화폐 금액 입력 요청을 구현합니다.

인게임 재화 패키지 판매

기설정액만큼 인게임 재화를 판매합니다. 이 기능을 사용하면 인게임 통화를 패키지로 판매할 수 있으며 사용자 정의 금액으로 통화를 구매한 경우, 가격이 더 낮을 수 있습니다.

예: 패키지의 경우, 그 안에 포함된 인게임 재화의 금액과 같지 않은 특가를 정의할 수 있습니다. 예: 가상 코인 1개 = 1 USD. 가상 코인 500개 = 450 USD.

제한 사항:

패키지에 하나의 인게임 재화 유형만 추가할 수 있습니다.
실물 화폐 또는 인게임 재화로 가격을 지정하지 않아도 인게임 재화 패키지를 생성할 수 있습니다. 이러한 아이템이 스토어에 표시되면 사용자가 무료로 사용할 수 있습니다.
인게임 재화 금액은 정숫값으로만 지정할 수 있습니다.

화폐 배달

사용 가능한 배달 방법:

엑솔라 인벤토리에 직접(기본 방법). 배달 전에 인게임 재화 패키지의 압축이 풀어지며 패키지 안의 화폐가 플레이어 인벤토리에 부여됩니다.
통합을 구성한 경우 PlayFab에.

인게임 스토어 논리가 귀하의 서버 측에서 구현된 경우 구매 웹훅을 구성할 수 있습니다.

경화

경화는 구매 플랫폼에 연결된 화폐로 실질 화폐로만 구매할 수 있습니다.

제한:

첫 단계에서만 화폐를 경화 상태로 지정할 수 있습니다.
가상 경화가 있는 인게임 재화 패키는 실질 화폐로만 구매할 수 있습니다.

하드 화폐를 다른 플랫폼에 별도로 저장하려는 경우:

하드 인게임 재화 토글을 켜짐으로 설정합니다.

인벤토리 관리용 API 엔드포인트를 호출할 때 문자열을 구매 플랫폼과 함께 platform 필드로 전달합니다.

예

Copy

Full screen

Small screen


"platform": “playstation_network”

구매할 수 있는 인게임 재화 패키지 개수 제한

인게임 재화 패키지 구매를 제한할 수 있습니다. 예를 들어 다음과 같이 제한:

사용자당 인게임 재화 개수
한 번 구매했을 때만 적용되는 웰컴 인게임 재화 패키지

사용자가 지정된 한도까지 구입한 경우 인게임 재화 패키지가 카탈로그에 표시되지 않습니다.

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

관리자 페이지에서 인게임 재화 패키지를 생성할 때 구매 한도를 설정하려면 한 사용자의 패키지 구매 가능 횟수 제한 토글을 켜짐으로 전환하고 패키지를 구매할 수 있는 횟수를 지정합니다.

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

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

한 사용자가 구매할 수 있는 최대 인게임 재화 패키지 개수
사용자가 구입할 수 있는 인게임 재화 패키지 잔여 개수

제한을 설정하거나 업데이트하는 방법에 대한 자세한 내용은 사용자 제한 설정 지침에서 확인할 수 있습니다.

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

사용자가 사용할 수 있는 인게임 재화 패키지 개수를 올바르게 표시하려면 인증을 구성해야 합니다.

응답 예제:

Copy

Full screen

Small screen


{
  "items": [
    {
      "sku": "vc_package_1",
      "name": "VC Name first package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "2.0000",
        "amount_without_discount": "2.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "Big Rocket - short description",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "sku": "big_rocket",
          "name": "Big Rocket",
          "type": "virtual_currency",
          "quantity": 100,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    },
    {
      "sku": "vc_package_3",
      "name": "VC Name third package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "4.0000",
        "amount_without_discount": "4.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "description",
          "image_url": "http://image.png",
          "sku": "shotgun_raider",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "quantity": 200,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    }
  ]
}

엑솔라는 한도가 초과되지 않도록 하고, 사용자가 설정된 한도보다 더 많은 인게임 재화 패키지를 구매하지 못하도록 합니다.

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

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

스토어에서 인게임 재화 및 인게임 재화 패키지의 표시 시간 제한하기

스토어에서 인게임 재화 및 인게임 재화 패키지의 표시 기간을 다음과 같이 설정할 수있습니다.

휴일 세일 기간과 같이 특정 시점에 카탈로그의 관련성 유지
카탈로그에 표시하지 않고 인게임 재화 및 인게임 재화 패키지를 미리 생성
아이템 옆에 타이머를 표시하여 사용자가 인게임 재화 및 인게임 재화 패키지를 구매하도록 동기를 부여

웹사이트 빌더를 사용하여 카탈로그 인터페이스를 생성하면 타이머가 자동으로 표시됩니다. 자체 인터페이스에서 카탈로그를 생성하는 경우 타이머를 구현해야 합니다.

스토어 내 인게임 재화의 표시 기간은 API 메서드를 통해서만 설정할 수 있습니다.

API를 통해 스토어에 인게임 재화의 표시 시간 제한을 설정하려면 Create virtual currency 또는 Update virtual currency API 호출에서 다음 매개 변수를 전달합니다:

periods[0].date_from는 아이템 표시 기간의 시작 날짜와 시간을 YYYY-MM-DDThh:mm:ss±TMZ 형식으로 표시합니다. TMZ는hh:mm형식의 시간대 구분자입니다.
periods[0].date_until는 아이템 표시 기간의 시작 날짜와 시간을 YYYY-MM-DDThh:mm:ss±TMZ 형식으로 표시합니다. TMZ는 hh:mmGMT 형식의 시간대 구분자입니다. 아이템 표시 기간의 종료 날짜를 표시하지 않으려면 null를 전달합니다.

스토어에 가상 화폐를 표시하는 기간을 여러 개 설정할 수 있습니다. 이를 위해 Create virtual currency 또는 Update virtual currency 메서드에서 모든 기간의 시작 날짜와 종료 날짜가 포함된 객체 배열을 전달합니다.

예:

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"
      }
]

관리자 페이지를 통해 스토어에 인게임 재화 패키지를 표시하는 기간 제한을 설정하려면 기간을 선택하고 해당 기간의 시간대, 시작일과 종료일을 지정합니다. 패키지 표시 기간의 종료일을 표시하지 않으려면 종료 날짜 없음 확인란을 선택합니다.

API를 통해 스토어에 패키지의 표시 시간 제한을 설정하려는 경우Create virtual currency package 또는 Update virtual currency package API 호출에 다음 파라미터를 전달합니다.

periods[0].date_from는 아이템 표시 기간의 시작 날짜와 시간을 YYYY-MM-DDThh:mm:ss±TMZ 형식으로 표시합니다. TMZ는hh:mm형식의 시간대 구분자입니다.
periods[0].date_until는 아이템 표시 기간의 시작 날짜와 시간을 YYYY-MM-DDThh:mm:ss±TMZ 형식으로 표시합니다. TMZ는 hh:mmGMT 형식의 시간대 구분자입니다. 아이템 표시 기간의 종료 날짜를 표시하지 않으려면 null를 전달합니다.

스토어에 패키지를 표시하는 기간을 여러 개 설정할 수 있습니다. 이를 위해 Create virtual currency package 또는 Update virtual currency package 메서드에서 모든 기간의 시작 날짜와 종료 날짜가 포함된 객체 배열을 전달합니다.

예:

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"
      }
]

사용자

게임에 인게임 재화를 추가하는 것과 인게임 재화를 대가로 가상 아이템을 판매하는 것으로 게임 경제 또는 수익 창출을 설정하려는 파트너
다음 제품 중 하나 이상을 통합한 파트너:
- 구성된 가상 아이템 모듈이 있는 인게임 스토어.
- 구성된 게임 키 모듈이 있는 Buy Button.

획득 방법

선행 조건

엑솔라 관리자 페이지을 등록합니다.
귀하의 프로젝트를 엽니다.

인게임 스토어 또는 Buy Button 모듈을 구성합니다.