번들

작동 방식

번들은 하나의 단위로 판매되는 여러 아이템으로 구성된 세트입니다.

주요 기능:

구매에 성공하면 번들이 자동으로 압축 해제됩니다. 번들에 다른 번들이 포함되어 있는 경우 포함된 번들이 자동으로 독립형 아이템으로 분리됩니다.

아이템 유형에 따라 달라지는 압축 해제된 번들의 아이템 전달 메소드:

알림
서버에 인게임 스토어 논리를 구현한 경우 아이템 구매 웹훅을 설정할 수 있습니다. 해당 웹훅은 번들과 번들의 모든 콘텐츠를 포함합니다.

구매자가 트랜잭션을 취소하여 번들을 반환하는 경우(예를 들어), 번들에서 수여된 모든 아이템은 자동으로 사용자로부터 회수됩니다. 구매자가 일부 아이템을 소모한 경우에도 남은 아이템이 회수됩니다.

제한:

  • 번들에 추가할 수 없는 아이템:
    • 같은 번들
    • 실물 상품
  • 빈 번들은 만들 수 없습니다.
  • 판매할 키를 모두 소모한 경우 번들 판매는 중단되며 해당 키는 번들에 포함되어 있습니다.
  • 번들 가격은 실제 및/또는 인게임 재화로 고정된 값이어야 합니다.
  • API를 통해서만 번들에 대한 지역 제한을 구성할 수 있습니다.

구매할 수 있는 번들 개수 제한

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

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

사용자가 지정된 한도까지 구매할 경우 번들이 카탈로그에 표시되지 않습니다. 번들에 구매 한도가 있는 인게임 재화 패키지나 아이템이 포함되고 사용자가 이미 허용된 양을 구매한 경우, 번들이 카탈로그에 표시되지 않습니다.

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

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

번들에 대한 정보를 얻으려면 번들 방법 그룹에서 카탈로그 구독 방법을 사용할 수 있습니다.

응답으로 번들 관련 정보에 추가해서 다음 정보를 받게 됩니다.

  • 한 사용자가 구매할 수 있는 최대 번들 개수
  • 사용자가 구입할 수 있는 번들 잔여 개수

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

알림

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

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

사용자 특성이 포함된 응답 예시:
Copy
Full screen
Small screen

{
  "items": [
    {
      "sku": "kg_1",
      "name": "kg_10.00_bundle",
      "type": "bundle",
      "description": "pricePoint_44056_1",
      "image_url": null,
      "long_description": null,
      "attributes": {
        "external_id": "genre",
        "name": "Genre",
        "values": [
          {
            "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
            "value": "Casual"
          },
          {
            "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
            "value": "Strategy"
          },
          {
            "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
            "value": "Mobile"
          }
        ]
      },
      "is_free": false,
      "order": 999,
      "groups": [],
      "price": {
        "amount": 9.99,
        "currency": "USD",
        "amount_without_discount": 9.99
      },
      "total_content_price": {
        "amount": 10.99,
        "currency": "USD",
        "amount_without_discount": 10.99
      },
      "media_list": [],
      "virtual_prices": [],
      "can_be_bought": true,
      "bundle_type": "standard",
      "limits": {
        "$ref": "./Catalog_item_limits.yaml"
      },
      "content": [
        {
          "sku": "big_rocket",
          "name": "Big Rocket",
          "description": "Big Rocket - short description.",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "type": "virtual_currency",
          "quantity": 100,
          "virtual_item_type": "non_consumable",
          "attributes": {
            "external_id": "size",
            "name": "Size",
            "values": [
              {
                "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
                "value": "Large"
              }
            ]
          },
          "is_free": false,
          "groups": [],
          "price": {
            "amount": 10.99,
            "currency": "USD",
            "amount_without_discount": 10.99
          },
          "virtual_prices": [],
          "limits": {
            "per_user": {
              "total": 5,
              "available": 5
              },
            "per_item": null
           },
          }
        }
      ]
    }
  ]
}
알림

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

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

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

스토어에서 번들 표시 기간 제한

스토어에서 아이템 표시 기간을 다음과 같이 설정할 수있습니다.
  • 휴일 세일 기간과 같이 특정 시점에 카탈로그의 관련성 유지
  • 카탈로그에 표시하지 않고 미리 번들을 생성
  • 아이템 옆에 타이머를 표시하여 사용자가 번들을 구매하도록 동기를 부여
알림
웹사이트 빌더를 사용하여 카탈로그 인터페이스를 생성하면 타이머가 자동으로 표시됩니다. 자체 인터페이스에서 카탈로그를 생성하는 경우 타이머를 구현해야 합니다.

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

API를 통해 스토어의 번들 표시 시간 제한을 설정하려면 Create bundle 또는 Update bundle API 호출에 다음 매개 변수를 전달합니다:

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

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

:

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. 카탈로그의 번들 가져오기를 구현합니다.

    번들 설정

    다음 방법 중 하나로 번들 설정:

    관리자 페이지을 이용한 설정

    1. 관리자 페이지 >스토어 > 번들로 이동해서 번들 만들기를 클릭합니다.
    2. 번들에 대한 매개 변수 지정:
      1. 이미지
      2. 이름
      3. 설명
      4. 콘텐츠
      5. 가격
      6. 스토어에 표시
    3. 설정을 확인하고 저장을 클릭합니다.

    API 메소드를 통한 설정

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

    번들에 게임 키 추가

    선택된 플랫폼에 대한 게임 키를 번들에 추가하려면 필수 플랫폼의 SKU를 포함하는 배열을 Create bundle 또는 Update bundle 메소드에 전달합니다.

    Copy
    Full screen
    Small screen
    
    "content": [{
         “sku”: “brilliant_game_sku_steam”,
         “quantity”: 1
      }
    ]
    

    지역 제한 설정

    번들에 대한 지역 제한을 설정하려면 지원되는 지역의 ID를 포함하는 배열을 Create bundle 또는 Update bundle 메소드에 전달합니다.

    알림
    API 메소드를 통해 프로젝트의 지역을 설정하거나 고객 성공 매니저에게 연락하여 그렇게 하도록 해 주십시오.
    Copy
    Full screen
    Small screen
    "regions": [{
         “id”: “123”
      }, {
         “id”: “456”
      }
    ]
    

    지역별 가격 설정

    번들에 대한 지역별 가격을 설정하려면 지역에 대한 가격 설정을 포함하는 개체의 배열을 Create bundle 또는 Update bundle 메소드에 전달합니다.

    알림
    API 메소드를 통해 프로젝트의 지역을 설정하거나 고객 성공 매니저에게 연락하여 그렇게 하도록 해 주십시오.
    Copy
    Full screen
    Small screen
    "regional_prices": [{
         “region_id”: “123”,
         “country_iso”: “CHN”,
         “amount”: 40,
         “currency_iso”: “CNY”,
         “is_default”: true,
         “is_enabled”: true
      }
    ]
    

    카탈로그의 번들 가져오기

    Bundles 메소드 그룹의 Catalog 하위 섹션의 메소드를 사용하여 번들 카탈로그를 가져올 수 있습니다.
    알림
    Catalog 하위 섹션의 메소드는 프론트 엔드 측의 스토어에 카탈로그를 구축하기 위해 만들어집니다. 해당 메소드는 권한 부여가 필요하지 않습니다.
    이 기사가 도움이 되었나요?
    감사합니다!
    개선해야 할 점이 있을까요? 메시지
    유감입니다
    이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
    의견을 보내 주셔서 감사드립니다!
    메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
    마지막 업데이트: 2024년 11월 8일

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

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