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

작동 방식

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

• 휴일 세일 기간과 같이 특정 시점에 카탈로그의 관련성 유지.
• 카탈로그에 표시하지 않고 미리 아이템 생성.
• 아이템 옆에 타이머를 표시하여 사용자의 구매를 유도하세요. 웹사이트 빌더로 카탈로그 인터페이스를 생성할 경우 타이머가 자동으로 표시됩니다. 사용자 정의 인터페이스로 카탈로그를 구축할 때는 타이머를 직접 구현해 제공해야 합니다.

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

제한 설정 구성 및 업데이트

관리자 페이지에서 구성 및 업데이트

1. 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동합니다.
2. 추가를 클릭하고 가상 아이템을 선택합니다.

3. 다음 매개 변수를 지정합니다:
   • 이미지
   • SKU
   • 해당 아이템이 속해야 하는 하나 이상의 그룹
   • 이름
   • 설명
   • 가격

4. 사용자가 특정 아이템을 구매할 수 있는 횟수를 제한하려면 사용자 한 명이 이 아이템을 구매할 수 있는 횟수 제한 토글을 켜기로 설정하고 제한 횟수를 지정하십시오.
5. 제한 사항을 새로고침하는 빈도 설정 방법:
   1. 드롭다운 목록에서 기간을 선택합니다:
      • 매일
      • 주간
      • 월간
      • 사용자 지정 간격. 해당 아이템의 스토어 전시 기간 시작일로부터 계산된 기간입니다.
      • 정기적인 새로고침 없음

1. 2. 기간에 해당하는 매개 변수를 지정하여 업데이트 일정을 설정합니다.

6. 카탈로그 내 아이템의 표시 기간을 설정하려면, 기간 한정을 선택한 후 시간대, 시작 날짜 및 종료 날짜를 지정합니다. 아이템을 무기한 제공하려면 종료 날짜 없음을 선택하십시오.
7. 아이템 생성을 클릭합니다.

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

스토어에 표시되는 아이템의 제한 시간을 설정하려면 다음 API 호출을 사용합니다.

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

• 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를 전달합니다.

스토어에서 아이템을 표시하는 기간을 여러 개 설정할 수 있습니다. 이렇게 하려면 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 배열에 아이템 판매 기간 정보가 반환됩니다.

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