스토어에서 아이템 표시 기간 제한

작동 방식

스토어 내에서 아이템 표시 기간을 다음과 같이 설정할 수있습니다:

• 연말연시 할인 행사 등 특정 시점에 카탈로그의 최신성을 유지.
• 카탈로그에 표시하지 않고 아이템을 미리 생성.
• 아이템 옆에 타이머를 표시하여 사용자의 구매를 유도합니다. 웹사이트 빌더로 카탈로그 인터페이스를 생성하면 타이머가 자동으로 표시됩니다. 사용자 정의 인터페이스로 카탈로그를 구축하는 경우 타이머를 직접 구현해야 합니다.

표시 시간 제한 설정은 다음 시나리오에서 이용할 수 있습니다:

• 게임 내 아이템 판매 - 가상 아이템, 가상 화폐 패키지 및 번들
• 게임 키를 통한 게임 및 DLC 판매

한도 구성 및 업데이트

사용 횟수가 제한된 아이템을 생성하는 방법:

2. 수동으로 생성 버튼을 클릭하고 드롭다운 목록에서 가상 아이템을 선택하세요.

3. General settings 섹션에서 다음을 지정하세요.
   • SKU
   • 아이템이 속할 그룹 1개 이상(선택 사항)
   • 이름
   • 짧은 설명
   • 상세 설명 - 추가하려면 해당 토글을 켜세요(선택 사항)

4. 미디어 섹션에서 이미지 또는 동영상을 한 개 이상 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 메인으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. 메인으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.

5. Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
   • 가격을 설정하려면 Paid item을 선택하고 Pricing in real currency 및/또는 Pricing in virtual currency 토글을 켠 다음 가격을 지정하세요. 필요하면 지역별 가격 책정을 설정하세요.
   • 무료 아이템을 생성하려면 Free item을 선택하세요.

6. 구매 가능한 아이템 수를 제한하려면 다음을 수행하세요.
   1. Limits 섹션에서 토글을 켜고 수량을 지정하세요.
   2. 제한 초기화 주기를 설정하세요. 초기화 주기를 설정하려면 드롭다운 목록에서 기간을 선택하세요:
      1. Daily.
      2. Weekly.
      3. Monthly.
      4. Custom interval. 이 간격은 스토어 내 아이템 표시 시작일부터 계산합니다.
      5. No regular refresh.
   3. 선택한 기간에 해당하는 매개변수를 지정해 초기화 일정을 설정하세요.

7. 아이템의 디스플레이 시간 제한을 설정하려면(선택 사항) 다음을 수행하세요.

   1. Add specific display period 섹션에서 토글을 켜세요.
   2. 표준시 및 기간의 시작 및 종료 시점을 지정하세요.

   아이템의 표시 종료 시점을 지정하지 않은 상태로 두려면 No end date 토글을 켜세요.

8. 다음 옵션 중 하나를 사용하여 속성을 설정하세요(선택 사항).
   1. JSON 형식으로 속성 및 해당 값 추가.
   2. 직접 속성 및 해당 값을 생성하고 아이템에 연결.

9. 유료 아이템을 무작위 리워드 메커니즘(예: 루트박스 또는 가챠)에서 사용한다면, Mark as paid randomized reward 토글을 활성화하세요.

10. Create 버튼을 클릭하세요.

11. 열린 창에서 아이템 상태를 선택하고 Continue 버튼을 클릭하세요.

생성된 아이템은 모든 아이템 섹션에 표시됩니다.

API 호출을 통한 설정 및 업데이트

스토어 내 아이템 표시 시간 제한을 설정하려면 다음 API 호출을 사용하세요:

• 가상 아이템 생성 또는 가상 아이템 업데이트
• 가상 화폐 생성 또는 가상 화폐 업데이트
• 가상 화폐 패키지 생성 또는 가상 화폐 패키지 업데이트
• 번들 생성 또는 번들 업데이트
• 게임 생성, SKU별 게임 업데이트 또는 ID별 게임 업데이트

아이템 생성 또는 아이템 업데이트 API 호출에 다음 매개 변수를 전달합니다.

• periods[0].date_from: 아이템 표시 기간 시작 일시를 YYYY-MM-DDThh:mm:ss±TMZ 형식으로 전달하세요. 여기서 TMZ는 hh:mm GMT 형식의 시간대 표기입니다.

• 아이템 표시 기간의 종료 날짜 및 시간을 YYYY-MM-DDThh:mm:ss±TMZ 형식으로 지정한 periods[0].date_until. 여기서 TMZ는 hh:mm GMT 형식의 시간대 표시기입니다. 아이템 표시 기간의 종료 시점을 지정하지 않으려면 기간을 하나만 지정하고 “periods[0].date_until”: null을 전달하세요.

스토어 내 아이템 표시 기간을 여러 개 설정할 수 있습니다. 이렇게 하려면 API 호출 시 모든 기간의 시작 및 종료 날짜가 포함된 객체 배열을 전달하세요.

예:

 1"periods": [
 2      {
 3        "date_from": "2022-06-10T14:00:00+03:00",
 4        "date_until": "2022-06-30T14:00:00+03:00"
 5      },
 6       {
 7        "date_from": "2022-07-10T14:00:00+03:00",
 8        "date_until": "2022-07-30T14:00:00+03:00"
 9      },
10       {
11        "date_from": "2022-08-10T14:00:00+03:00",
12        "date_until": "2022-08-30T14:00:00+03:00"
13      }
14]

카탈로그 조회 API 호출은 요청 시점에 스토어에 표시되는 아이템을 반환합니다. 표시 기간이 아직 시작되지 않았거나 이미 만료된 아이템에 대한 정보를 가져오려면 카탈로그 요청 시 show_inactive_time_limited_items 매개변수에 1 값을 전달하세요.

아이템 카탈로그에 한도 표시

카탈로그 내 시간 제한 아이템 표시는 카탈로그 구현 방식이 웹사이트 빌더 사용 인지 API 사용 인지에 따라 다릅니다.

웹사이트 빌더 사용 시

웹사이트 빌더를 사용한 경우 제한 시간이 자동으로 표시됩니다. 아이템 판매 기간 종료 30일 전부터 아이템 카드에 남은 시간을 표시하는 타이머가 자동으로 다음과 같이 나타납니다:

• 판매 종료까지 일주일 이상 남은 경우 타이머에 일과 시간이 표시됩니다.
• 판매 종료까지 하루 이상 남은 경우 타이머에 시간과 분이 표시됩니다.
• 판매 종료까지 하루 미만 남은 경우 타이머에 분과 초가 표시됩니다.

API로 제한 정보 가져오기

API를 사용하여 카탈로그를 구현한 경우, 다음 카탈로그 관련 API 호출의 items.periods 배열에 아이템 판매 기간 정보가 반환됩니다.

• 가상 아이템 목록 가져오기
• 가상 화폐 목록 가져오기
• 가상 화폐 패키지 목록 가져오기
• 번들 목록 가져오기
• 게임 목록 가져오기

아이템 판매 가능 기간에 관한 데이터를 카탈로그에 제한 사항을 표시하는 데 활용할 수 있습니다. 예를 들어, 사용자가 해당 상품을 구매할 수 있는 기간을 보여줄 수 있습니다.