지역별 가격 책정
아이템 카탈로그를 설정할 때 여러 국가의 사용자를 위해 가상 아이템과 게임 키 패키지의 가격 정책을 지역별로 구성할 수 있습니다. 각 아이템 또는 게임 키 패키지의 가격은 기본적으로 USD로 설정됩니다. 지역 제한과 지역별 가격을 동시에 설정할 수 있습니다.
작동 방식
카탈로그의 가격은 사용자의 국가를 기준으로 합니다.
페이 스테이션으로 구매하면 아이템 가격이 사용자 국가의 통화로 변환되며 해당되는 경우 세금도 포함됩니다.
국가 결정
- 아이템 카탈로그를 요청할 때 가상 아이템 및 인게임 재화 또는 게임 키 메소드 그룹의 카탈로그 하위 섹션의 메소드에 있는
country
매개 변수로 사용자의 국가를 전달합니다.
국가가 지정되지 않으면 사용자의 IP 주소를 기준으로 국가가 결정됩니다. 그런 다음 사용자의 국가에 맞는 아이템 카탈로그 가격이 선택됩니다. - 아이템을 구매하는 경우:
- 결제 토큰을 획득하는 클라이언트 메소드를 사용하는 경우 서버 측이 아닌 클라이언트 측에서만 사용하는 것이 중요합니다. 클라이언트 메소드의 국가와 통화는 사용자의 IP 주소에 따라 결정됩니다. 서버 측에서 이 메소드를 사용하면 통화가 잘못 결정되고 페이 스테이션의 결제 수단에 영향을 줄 수 있습니다.
- 구매용 결제 토큰 생성 서버 메소드를 사용하는 경우 요청 본문의
country
개체를 전달하거나X-User-Ip
헤더의 사용자의 IP 주소를 전달해야 합니다.
- country.value 매개 변수의 국가와
X-User-Ip
헤더의 IP 주소가 전달되면 country.value 매개 변수의 국가 값이 우선됩니다.
- country.value 매개 변수의 국가와
아이템 카탈로그의 가격 표시 원칙
카탈로그의 모든 아이템은 지정된 가격과 동일한 통화 목록을 사용해야 합니다.
이는 카탈로그의 모든 아이템이 동일한 통화로 표시하기 위해 필요합니다. 국가 중 한 곳의 아이템 하나에 가격을 지정하지 않으면 해당 국가의 전체 카탈로그 가격이 기본 통화로 표시됩니다.
아이템의 기본 통화가 서로 다른 경우 가격은 카탈로그에서 첫 번째 아이템의 기본 통화로 표시됩니다. 그중 한 아이템에 이 통화로 된 가격이 없는 경우 응답에서 해당 아이템 대한 null
가격 값이 반환됩니다. 이로 인해 아이템 가격이 잘못 표시되어 카탈로그 전체에 영향을 미칠 수 있습니다.
예시:
사용자
다른 국가 출신의 사용자에 대한 스토어 가격 정책을 설정하여 구매력이 낮은 국가에서 판매를 늘리고 싶은 파트너.
획득 방법
다음과 같이 지역별 가격을 추가, 편집, 삭제할 수 있습니다.
아이템 생성 및 편집 시 관리자 페이지를 통해 설정하기
지역별 가격으로 가상 아이템을 생성하는 방법:- 관리자 페이지에서 프로젝트를 엽니다.
- 사이드 메뉴에서 스토어를 클릭합니다.
- 가상 아이템 창에서 구성을 클릭합니다.
- +를 클릭한 후 드롭다운 목록에서 아이템 생성을 선택합니다.
- 지정해야 하는 항목:
- 이미지
- SKU
- 아이템이 속할 하나 또는 여러 그룹
- 이름
- 설명
- 아이템 속성 - 소모품, 비소모품 또는 사용 기간 제한 아이템
- 가격 설정 블록에서 유료 아이템을 선택합니다.
- 실제 통화로 가격 책정 토글을 온으로 전환한 후 가격을 지정합니다. 지역별 가격을 설정하지 않으면 아이템의 가격이 모든 국가에서 동일하게 미국 달러로 표시됩니다.
- 가격 설정 방법:
- 여러 통화로 아이템 가격을 설정하려면 +를 클릭한 후 통화와 가격을 지정합니다.
- 국가별로 특별한 가격을 설정하려면 가격 추가를 클릭한 후 국가와 통화와 수량을 지정합니다. 원하는 만큼 지역별 가격의 수를 설정할 수 있습니다.
- 인게임 재화로 가격을 추가하려면 인게임 재화 가격 토글을 On(켜기)으로 전환한 후 가격을 지정합니다.
- 특정 사용자의 아이템의 가용성을 제한하려면 한 사용자가 이 아이템을 구매할 수 있는 횟수 제한 토글을 On(켜기)으로 전환한 후 횟수를 지정합니다.
- 스토어에 아이템을 표시하려면 스토어에 아이템 표시 토글을 On(켜기)으로 전환합니다.
- 아이템 생성을 클릭합니다.
관리자 페이지 파일에서 가져오기
미리 생성된 아이템의 경우 파일에서 지역별 가격을 가져올 수 있습니다.
특징
- 여러 아이템의 지역별 가격을 한 번에 업로드하거나 업데이트할 수 있습니다.
- 모든 유형의 아이템 지원:
- 가상 아이템
- 인게임 재화
- 인게임 재화 패키지
- 번들
- 특정 플랫폼의 게임 키 패키지
업로드된 데이터의 유효성 검사. 파일 구조 또는 데이터 형식이 요구 사항을 충족하지 못하는 경우 가져오는 동안 오류 목록이 표시됩니다.
파일 구조
파일은 CSV 형식이어야 하며 다음 열을 포함해야 합니다.SKU - 지역별 가격을 설정해야 하는 아이템 SKU.Country - ISO 3166-1 alpha-2 형식의 국가 코드입니다. CSV 파일을 업로드하기 전에 엑솔라에서 지원하는 국가 목록을 확인하세요. 이 열의 셀을 채우는 것은 선택 사항입니다. 국가가 지정되지 않은 경우 가격 표시 예시를 참조해 주세요.Currency - ISO 4217 형식으로 된 통화 코드.Amount - 아이템의 가격. 소수점 구분 기호로 마침표 사용.IsDefault - 기본 가격인지 여부입니다. 지정해야 하는 항목:1
- 이는 기본 가격이 있는 행에 사용합니다. 지역별 가격이 없는 모든 국가에 표시합니다.0
- 다른 모든 행에 사용. IsDefault 열의 셀을 비워 둘 수도 있습니다.
기본 가격은 지역별 가격이 아니며,
예제
올바르게 입력된 파일(여러 항목, 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에만 가격이 있습니다.
파일 완성 예시 및 발생 가능한 오류
가져오기용 CSV 파일의 올바른 입력 예시:파일 가져오기
파일에서 가격을 가져오는 방법:- 관리자 페이지에서 프로젝트를 엽니다.
- 사이드 메뉴에서 스토어를 클릭한 후 원하는 유형의 상품 섹션으로 이동합니다.
- 가격 가져오기를 클릭합니다.
- 가져오기 창에서 파일 템플릿을 다운로드하고 값을 추가할 수 있습니다.
- 가져오기 창의 해당 필드에서 파일을 업로드합니다.
- 가져오기를 수행하는 동안 오류가 발생하면 가져오기 창에 이러한 오류 목록과 수정 권장 사항이 표시됩니다. 파일에서 필요한 항목을 변경한 후 다시 업로드합니다.
업로드에 성공하면 지정된 SKU가 있는 아이템의 지역 가격이 파일의 가격에 따라 업데이트됩니다. 이전에 지정한 가격은 삭제됩니다.
예시:
관리자 페이지의 아이템에 여러 통화로 설정된 여러 가격과 여러 지역 가격이 있습니다. 가져온 파일에는 EUR 가격이 하나만 있습니다. 파일을 가져온 후에는 관리자 페이지에서 이 아이템에 대해 EUR 가격이 하나만 지정됩니다.
API 메소드를 사용하여 설정하기
API 메소드를 통해 지역별 가격을 설정하려면 국가별 가격 설정을 사용하는 개체 배열을 전달해야 합니다.배열 예시:- http
"prices": [
{
"amount": 100,
"currency": "USD",
"is_enabled": true,
"is_default": true
},
{
"amount": 200,
"currency": "CZK",
"country_iso": "CZ",
"is_enabled": false,
"is_default": false
}
]
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.