지역별 가격 책정

아이템 카탈로그를 설정할 때 여러 국가의 사용자를 위해 가상 아이템과 게임 키 패키지의 가격 정책을 지역별로 구성할 수 있습니다. 각 아이템 또는 게임 키 패키지의 가격은 기본적으로 USD로 설정됩니다. 지역 제한과 지역별 가격을 동시에 설정할 수 있습니다.

작동 방식

카탈로그의 가격은 사용자의 국가를 기준으로 합니다.

페이 스테이션으로 구매하면 아이템 가격이 사용자 국가의 통화로 변환되며 해당되는 경우 세금도 포함됩니다.

국가 결정

• 아이템 카탈로그를 요청할 때 가상 아이템 및 인게임 재화 또는 게임 키 메소드 그룹의 카탈로그 하위 섹션의 메소드에 있는 country 매개 변수로 사용자의 국가를 전달합니다.
  국가가 지정되지 않으면 사용자의 IP 주소를 기준으로 국가가 결정됩니다. 그런 다음 사용자의 국가에 맞는 아이템 카탈로그 가격이 선택됩니다.
• 아이템을 구매하는 경우:
  • 결제 토큰을 획득하는 클라이언트 메소드를 사용하는 경우 서버 측이 아닌 클라이언트 측에서만 사용하는 것이 중요합니다. 클라이언트 메소드의 국가와 통화는 사용자의 IP 주소에 따라 결정됩니다. 서버 측에서 이 메소드를 사용하면 통화가 잘못 결정되고 페이 스테이션의 결제 수단에 영향을 줄 수 있습니다.
  • 구매용 결제 토큰 생성 서버 메소드를 사용하는 경우 요청 본문의 country 개체를 전달하거나 X-User-Ip 헤더의 사용자의 IP 주소를 전달해야 합니다.

1. 1. country.value 매개 변수의 국가와 X-User-Ip 헤더의 IP 주소가 전달되면 country.value 매개 변수의 국가 값이 우선됩니다.

아이템 카탈로그의 가격 표시 원칙

카탈로그의 모든 아이템은 지정된 가격과 동일한 통화 목록을 사용해야 합니다.

이는 카탈로그의 모든 아이템이 동일한 통화로 표시하기 위해 필요합니다. 국가 중 한 곳의 아이템 하나에 가격을 지정하지 않으면 해당 국가의 전체 카탈로그 가격이 기본 통화로 표시됩니다.

아이템의 기본 통화가 서로 다른 경우 가격은 카탈로그에서 첫 번째 아이템의 기본 통화로 표시됩니다. 그중 한 아이템에 이 통화로 된 가격이 없는 경우 응답에서 해당 아이템 대한 null 가격 값이 반환됩니다. 이로 인해 아이템 가격이 잘못 표시되어 카탈로그 전체에 영향을 미칠 수 있습니다.

예시:

• 1개 아이템, 1개 통화, 지역 가격 없음
• 1개 아이템, 2개 통화, 지역 가격 없음
• 1개 아이템, 지역 가격 있음
• 여러 아이템, 지역 가격 있음, 기본 통화 1개
• 여러 아이템, 지역 가격, 다양한 기본 통화 있음

아이템의 기본 통화는 USD이고 가격은 5달러이며 국가 설정은 없습니다. 이 경우 모든 국가의 사용자에게 이 가격이 표시됩니다.

아이템에 USD와 EUR의 두 가지 가격 옵션이 설정되지만 국가별 특별 가격은 지정되지 않습니다. 이 경우 EUR를 사용하는 국가의 사용자에게는 7 EUR로 가격이 표시됩니다. 다른 국가의 사용자에게는 모든 기본 통화 가격인 5 USD가 표시됩니다.

프로젝트 가격은 다음 통화로 표시됩니다.

• 기본 가격 - 7 USD
• 유로화 가격 - 6 EUR
• 지역별 가격:
  • 독일 - 8 EUR
  • 이탈리아 - 5 EUR
  • 말레이시아 - 20 MYR
  • 남아프리카 공화국- 90 ZAR

사용자의 국가에 따라 카탈로그에 표시되는 가격은 다음과 같습니다.

사용자의 국가	카탈로그 가격	내용
미국	7 USD	미국은 USD를 사용하는 국가입니다. 미국의 특별 가격은 지정되지 않습니다.
일본	7 USD	일본 통화가 지정되지 않았으므로 가격이 기본 통화로 표시됩니다.
프랑스	6 EUR	프랑스는 EUR를 사용하는 국가입니다. 프랑스의 특별 가격은 지정되지 않습니다.
독일	8 EUR	독일은 지역 가격이 지정되어 있습니다.
이탈리아	5 EUR	이탈리아는 지역 가격이 지정되어 있습니다.
말레이시아	20 MYR	말레이시아는 지역 가격이 지정되어 있습니다.
남아프리카 공화국	90 ZAR	남아프리카 공화국은 지역 가격이 지정되어 있습니다.

이 프로젝트의 가격은 다음 통화로 표시됩니다.

• 모든 아이템의 기본 가격은 미국 달러(USD)로 표시
• 말레이시아의 경우 모든 아이템의 가격이 말레이시아 링깃(MYR)으로 표시
• 남아프리카 공화국의 경우 하나를 제외한 모든 아이템의 가격이 남아프리카 공화국 랜드(ZAR)로 표시

이 경우 말레이시아 사용자에게는 카탈로그가 MYR로 표시되지만 남아프리카 공화국 사용자에게는 USD로 표시됩니다. 남아프리카 공화국 사용자에게는 한 아이템에 ZAR 가격이 지정되지 않았기 때문에 USD로 표시됩니다.

프로젝트의 가격은 다음 통화로 표시됩니다.

• 1_test_item의 기본 가격은 미국 달러(USD)
• 2_test_item의 기본 가격은 유로(EUR)
• 남아프리카 공화국의 경우 1_test_item의 가격은 남아프리카 공화국 랜드(ZAR)로 표시되며, 2_test_item의 통화는 지정되지 않음

이 경우 남아프리카 공화국 사용자의 경우 가격이 카탈로그의 첫 번째 아이템인 1_test_item의 기본 통화로 표시되어야 합니다.

1_test_item의 기본 통화는 USD입니다. 2_test_item의 기본 통화인 EUR와 일치하지 않습니다. 또한 가격 목록에 해당 아이템의 USD 가격이 없습니다.

따라서 2_test_item의 경우 반환된 가격 값은 null이(가) 됩니다.

사용자

다른 국가 출신의 사용자에 대한 스토어 가격 정책을 설정하여 구매력이 낮은 국가에서 판매를 늘리고 싶은 파트너.

획득 방법

다음과 같이 지역별 가격을 추가, 편집, 삭제할 수 있습니다.

• 아이템 생성/편집 시 관리자 페이지를 통해
• 파일을 통해 가격을 가져올 때 관리자 페이지를 통해
• API 메서드 사용하여

아이템 생성 및 편집 시 관리자 페이지를 통해 설정하기

1. 관리자 페이지에서 프로젝트를 엽니다.
2. 사이드 메뉴에서 스토어를 클릭합니다.
3. 가상 아이템 창에서 구성을 클릭합니다.
4. +를 클릭한 후 드롭다운 목록에서 아이템 생성을 선택합니다.

5. 지정해야 하는 항목:
   • 이미지
   • SKU
   • 아이템이 속할 하나 또는 여러 그룹
   • 이름
   • 설명
   • 아이템 속성 - 소모품, 비소모품 또는 사용 기간 제한 아이템
6. 가격 설정 블록에서 유료 아이템을 선택합니다.
7. 실제 통화로 가격 책정 토글을 온으로 전환한 후 가격을 지정합니다. 지역별 가격을 설정하지 않으면 아이템의 가격이 모든 국가에서 동일하게 미국 달러로 표시됩니다.

8. 가격 설정 방법:
   • 여러 통화로 아이템 가격을 설정하려면 +를 클릭한 후 통화와 가격을 지정합니다.
   • 국가별로 특별한 가격을 설정하려면 가격 추가를 클릭한 후 국가와 통화와 수량을 지정합니다. 원하는 만큼 지역별 가격의 수를 설정할 수 있습니다.
9. 인게임 재화로 가격을 추가하려면 인게임 재화 가격 토글을 On(켜기)으로 전환한 후 가격을 지정합니다.
10. 특정 사용자의 아이템의 가용성을 제한하려면 한 사용자가 이 아이템을 구매할 수 있는 횟수 제한 토글을 On(켜기)으로 전환한 후 횟수를 지정합니다.
11. 스토어에 아이템을 표시하려면 스토어에 아이템 표시 토글을 On(켜기)으로 전환합니다.
12. 아이템 생성을 클릭합니다.

관리자 페이지 파일에서 가져오기

미리 생성된 아이템의 경우 파일에서 지역별 가격을 가져올 수 있습니다.

특징

• 여러 아이템의 지역별 가격을 한 번에 업로드하거나 업데이트할 수 있습니다.
• 모든 유형의 아이템 지원:
  • 가상 아이템
  • 인게임 재화
  • 인게임 재화 패키지
  • 번들
  • 특정 플랫폼의 게임 키 패키지

• 업로드된 데이터의 유효성 검사. 파일 구조 또는 데이터 형식이 요구 사항을 충족하지 못하는 경우 가져오는 동안 오류 목록이 표시됩니다.

파일 구조

• SKU - 지역별 가격을 설정해야 하는 아이템 SKU.
• Country - ISO 3166-1 alpha-2 형식의 국가 코드입니다. CSV 파일을 업로드하기 전에 엑솔라에서 지원하는 국가 목록을 확인하세요. 이 열의 셀을 채우는 것은 선택 사항입니다. 국가가 지정되지 않은 경우 가격 표시 예시를 참조해 주세요.
• Currency - ISO 4217 형식으로 된 통화 코드.
• Amount - 아이템의 가격. 소수점 구분 기호로 마침표 사용.

• IsDefault - 기본 가격인지 여부입니다. 지정해야 하는 항목:

  • 1 - 이는 기본 가격이 있는 행에 사용합니다. 지역별 가격이 없는 모든 국가에 표시합니다.
  • 0 - 다른 모든 행에 사용. IsDefault 열의 셀을 비워 둘 수도 있습니다.

알림

기본 가격은 지역별 가격이 아니며, Country 열의 셀을 비워 두어야 합니다.

예제

올바르게 입력된 파일(여러 항목, 3개 통화, 지역별 가격 제공).

잘못 입력된 파일(여러 아이템, 3개 통화, 지역별 가격 제공).
오류: 가상-아이템-1 및 번들-1에서 국가 열의 그룹 셀이 비어 있지 않습니다.

각각의 새로운 항목을 추가할 때는 기본 통화로 가격을 설정해야 합니다. 지정하지 않을 경우 파일을 가져올 때 오류가 표시됩니다.

예제

올바르게 입력된 파일(여러 항목, 3개 통화, 지역별 가격 제공).

잘못 입력된 파일(여러 아이템, 3개 통화, 지역별 가격 제공).
오류: 가상-아이템-1 및 번들-1 그룹에 대한 기본 통화가 없습니다.

• 플랫폼 - 플랫폼 SKU. 게임 키의 지역별 가격을 설정할 때 사용되지만 다른 항목에는 사용되지 않습니다.

  사용 가능한 플랫폼.

  플랫폼 SKU	플랫폼 이름
  스팀	Steam
  playstation	PlayStation
  xbox	Xbox
  uplay	Uplay
  origin	Origin
  drmfree	DRM Free
  gog	GOG
  epicgames	Epic Games Store
  nintendo_eshop	Nintendo Switch eShop
  discord_game_store	Discord Game Store
  oculus	Oculus
  viveport	Viveport
  stadia	Google Stadia

알림

SKU는 동일하지만 플랫폼이 다른 게임 키는 서로 다른 객체로 간주됩니다. 각 객체에는 기본 통화로 지정된 가격이 있어야 합니다.

예제

올바르게 입력된 파일(여러 게임 키, 3개 통화, 지역별 가격 제공, 2개 플랫폼).

잘못 입력된 파일(여러 게임 키, 3개 통화, 지역별 가격 제공, 2개 플랫폼).
오류 1: SKU 및 플랫폼에 의해 게임 키가 잘못 그룹화되어 있으므로 3개가 아닌 9개의 객체가 검색되었습니다.
오류 2: 잘못된 그룹화로 인해 그룹 3, 4, 5 및 6에는 기본 가격이 없습니다.
오류 3: 그룹 9는 동일한 객체에 대한 전체 가격 집합을 가지고 있기 때문에 그룹 7의 데이터를 덮어씁니다. 따라서 playstation 플랫폼에 대한 게임-키-2는 가져오기한 후 MYR에만 가격이 있습니다.

파일 완성 예시 및 발생 가능한 오류

• 여러 아이템, 3개 통화, 지역별 가격 없음.
• 여러 아이템, 1개 통화, 지역별 가격 없음.
• 여러 게임 키, 3개 통화, 지역별 가격 제공, 1개 플랫폼.
• 여러 게임 키, 3개 통화, 지역별 가격 없음, 2개 플랫폼.

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault
virtual-item-1,EUR,9.09,,0
virtual-item-1,USD,10.1,,1
virtual-item-1,MYR,47,,0
virtual-currency-1-pack-100,EUR,2.09,,0
virtual-currency-1-pack-100,USD,2.3,,1
virtual-currency-1-pack-100,MYR,24,,0
bundle-1,EUR,15,,0
bundle-1,USD,17,,1
bundle-1,MYR,82,,0

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault
virtual-item-1,USD,10.1,,1
virtual-currency-1-pack-100,USD,2.3,,1
bundle-1,USD,17,,1

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault,Platform
game-key-1,EUR,9.09,,1,steam
game-key-1,EUR,9.2,DE,0,steam
game-key-1,EUR,8.09,IT,0,steam
game-key-1,USD,10.1,US,0,steam
game-key-1,MYR,47,MY,0,steam
game-key-2,EUR,2.09,,1,steam
game-key-2,EUR,2.2,DE,0,steam
game-key-2,EUR,1.79,IT,0,steam
game-key-2,USD,2.3,US,0,steam
game-key-2,MYR,24,MY,0,steam

Copy

Full screen

Small screen

• csv

SKU,Currency,Amount,Country,IsDefault,Platform
game-key-1,USD,10.1,,1,steam
game-key-1,EUR,9.09,,0,steam
game-key-1,MYR,47,,0,steam
game-key-1,USD,17,,1,playstation
game-key-1,EUR,15,,0,playstation
game-key-1,MYR,82,,0,playstation
game-key-2,USD,2.3,,1,steam
game-key-2,EUR,2.09,,0,steam
game-key-2,MYR,24,,0,steam

• 여러 게임 키, 3개 통화, 지역별 가격 없음, 2개 플랫폼.
• 여러 게임 키, 3개 통화, 지역별 가격 제공, 2개 플랫폼.
• 여러 아이템, 3개 통화, 지역별 가격 제공.
• 여러 아이템, 3개 통화, 지역별 가격 제공.
• 여러 아이템, 3개 통화, 지역별 가격 없음.

오류: 그룹 게임-키-1 + 스팀 및 게임-키-2 + 스팀에 기본 가격이 없습니다.

오류: 그룹 게임-키-1 + 스팀 및 게임-키-2 + 스팀에 기본 가격에 대한 국가로 미국이 언급되어 있습니다.

오류: 그룹 가상-아이템-1 및 번들-1 에 기본 가격이 없습니다.

오류: 그룹 가상-아이템-1 및 번들-1에 기본 가격에 대한 국가로 미국이 언급되어 있습니다.

오류 1: 항목을 SKU별로 잘못 그룹화하여 3개가 아닌 5개의 객체가 검색되었습니다.
오류 2: 그룹 3은 잘못된 그룹화로 인해 기본 가격이 없습니다.
오류 3: 그룹 4는 동일한 항목에 대한 전체 가격 집합을 가지고 있기 때문에 그룹 2의 데이터를 덮어씁니다. 따라서 인게임-재화-1-팩-100에 대한 SKU는 가져오기한 후 MYR에만 가격이 있습니다.

파일 가져오기

1. 관리자 페이지에서 프로젝트를 엽니다.
2. 사이드 메뉴에서 스토어를 클릭한 후 원하는 유형의 상품 섹션으로 이동합니다.
3. 가격 가져오기를 클릭합니다.

4. 가져오기 창에서 파일 템플릿을 다운로드하고 값을 추가할 수 있습니다.
5. 가져오기 창의 해당 필드에서 파일을 업로드합니다.
6. 가져오기를 수행하는 동안 오류가 발생하면 가져오기 창에 이러한 오류 목록과 수정 권장 사항이 표시됩니다. 파일에서 필요한 항목을 변경한 후 다시 업로드합니다.

업로드에 성공하면 지정된 SKU가 있는 아이템의 지역 가격이 파일의 가격에 따라 업데이트됩니다. 이전에 지정한 가격은 삭제됩니다.

예시:

관리자 페이지의 아이템에 여러 통화로 설정된 여러 가격과 여러 지역 가격이 있습니다. 가져온 파일에는 EUR 가격이 하나만 있습니다. 파일을 가져온 후에는 관리자 페이지에서 이 아이템에 대해 EUR 가격이 하나만 지정됩니다.

API 메소드를 사용하여 설정하기

• 가상 아이템 생성 및 업데이트용 메소드에서
• 인게임 재화 생성 및 업데이트용 메소드에서
• 인게임 재화 패키지 생성 및 업데이트용 메소드에서
• 번들 생성 및 업데이트용 메소드에서

• 게임 키 패키지 생성 및 업데이트용 메소드에서

"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]