쿠폰
작동 방식
쿠폰 프로모션은 새로운 고객을 유인하고 매출을 증가시키는 마케팅 도구입니다. 쿠폰을 사용하는 플레이어는 이 쿠폰에 연결된 보상을 받게 됩니다. 보상에 포함될 수 있는 것:
- 인게임 재화 패키지
- 게임 키
- 가상 아이템
모든 쿠폰은 코드가 있습니다. 쿠폰을 사용하려면 사용자는 게임에, 웹사이트에 또는 모바일 애플리케이션에 코드를 입력해야 합니다.
주요 기능:
- 하나의 캠페인에 대한 일반적인 쿠폰 사용 횟수를 결정합니다.
- 하나의 캠페인에서 사용자 한 명에 대한 쿠폰 사용 횟수를 정합니다.
- 쿠폰 코드를 여러 번 생성합니다.
- 쿠폰에 연결된 아이템과 프로모션에 대한 지역 판매 제한을 적용합니다.
제한 사항:
- 게임 키를 쿠폰에 연결하는 경우, 그중 하나가 쿠폰을 사용하는 플레이어에게 이메일로 전송됩니다. 캠페인에 남은 키가 없는 경우, 플레이어의 쿠폰 사용 요청은 거절됩니다.
- 지역 제한이 있는 프로모션을 쿠폰이 포함하는 경우, 제한된 지역의 사용자는 쿠폰을 사용할 수 없습니다.
- 지역 판매 제한이 있는 아이템을 쿠폰이 포함하는 경우, 제한된 지역의 사용자는 쿠폰에 연결된 아이템을 얻을 수 없습니다.
사용자 절차:
- 사용자가 쿠폰을 사용합니다.
- 쿠폰에 연결된 보상이 사용자에게 전달되는 방법:
- 인벤토리로 직접(가상 아이템 또는 인게임 재화 패키지)
- 이메일을 통해(게임 키)
- 자격 관리 시스템으로 직접(게임 키)
획득 방법
선행 조건
- 엑솔라 관리자 페이지을 만듭니다.
- 내 프로젝트에 스토어를 연결합니다.
통합 절차
쿠폰으로 캠페인 설정
- 관리자 페이지에서 스토어 > 프로모션 및 보상으로 이동하여 프로모션을 만듭니다.
- 필요한 매개 변수 지정:
- 프로모션 제목을 입력합니다.
- 프로모션 유형으로서 쿠폰을 선택합니다.
- 사용자가 쿠폰을 사용하면 받을 보너스 아이템을 선택합니다.
- 인게임 재화 패키지.
- 게임 키.
- 가상 아이템(번들을 포함해 하나 또는 그 이상, 사용기간 제한 아이템).
- 총 사용 가능 횟수 및 사용자당 사용 횟수를 지정합니다.
- 캠페인 시작 및 종료 날짜를 설정합니다.
- 설정을 확인하고 프로모션을 저장합니다.
- 프로모션 편집 메뉴로 이동합니다.
- 코드 메뉴에서 쿠폰 생성 방법 메소드를 선택합니다.
- 쿠폰 코드를 생성 또는 수동으로 입력합니다.
- 변경 사항을 저장합니다.
- 프로모션을 활성화합니다.
인게임 재화 패키지와 쿠폰
인게임 재화 패키지 쿠폰을 위한 통화 패키지를 지정해야 합니다. 가인게임 재화패키지 생성 방법:- 인게임 재화 모듈로 이동하여 다음 매개변수를 명시합니다.
- 이미지
- SKU
- 통화 이름
- 인게임 재화 단위 유닛 가격
- 기본 통화
- 필요한 수량 만큼의 통화 패키지를 생성하고 각각에 대해 다음의 매개변수를 명시합니다.
- 이미지
- SKU
- 이름
- 설명
- 사용된 통화
- 패키지 내의 통화 금액
- 가격
- 기본 통화
- 스토어에서 통화 패키지 보여주기 사용.
게임 키와 쿠폰
게임 키 쿠폰에 대한 게임 키 SKU와 DRM 정보를 명시해야 합니다. 2가지 선택 사항:- 이미 설정된 DRM에 대한 쿠폰을 발행합니다. 쿠폰 발행 시 매개 변수가 설정됩니다.
- 쿠폰 사용 시 DRM을 선택합니다.
가상 아이템과 쿠폰
가상 아이템 SKU 및 가상 아이템 쿠폰 수량을 명시해야 합니다. 번들과 사용기간 제한 아이템을 포함하는 하나의 쿠폰에 대하여 다른 SKU로 하나 이상의 아이템을 선택할 수 있습니다.쿠폰 발행
캠페인은 하나 이상의 쿠폰을 포함할 수 있습니다. 쿠폰 형식의 2가지 선택 사항:- 수동 입력 문자열 — 여러 번 사용할 수 있는 쿠폰 하나만을 사용하는 캠페인에 적합합니다(최대 128자).
- 생성된 문자열 — 숫자 및 라틴 심볼로 구성된 라인(10자). 많은 쿠폰을 가지는 캠페인에 적합합니다.
알림
쿠폰 코드는 대/소문자를 구분합니다. 예를 들어,
winter2021과 WINTER2021은 서로 다른 2개의 쿠폰입니다.지역 제한
지역 제한은 전체 프로모션 캠페인에 적용됩니다. 지역 제한은 엑솔라에 이메일로 요청 시적용됩니다.쿠폰 보상 얻기
쿠폰 사용 후에 사용자가 받는 아이템 목록을 가져오려면 쿠폰 보상 받기 메서드를 호출합니다. 응답의is_selectable 매개 변수 값에 따라 2가지 가능한 플로우가 있습니다.is_selectable=true값의 경우,type=unit요소의 모든item에 대해unit_items개체에서 선택하는 요소에 대한 양식을 표시해야 합니다. 이 양식에서 사용자는 각unit유형에 대해 하나의 요소만 선택합니다.
Copy
- http
{
"bonus": [{
"item": {
"sku": "xsollus_gold_edition",
"name": "Xsollus: Gold Edition",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"unit_items": [{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_gold_edition_playstation",
"name": "Xsollus: Gold Edition (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_gold_edition_xbox",
"name": "Xsollus: Gold Edition (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}, {
"sku": "xsollus_gold_edition_rockstar",
"name": "Xsollus: Gold Edition (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"quantity": 1
}, {
"item": {
"sku": "xsollus_bonus_pack_edition",
"name": "Xsollus: Bonus Pack",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"unit_items": [{
"sku": "xsollus_bonus_pack_edition_steam",
"name": "Xsollus: Bonus Pack (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_bonus_pack_edition_playstation",
"name": "Xsollus: Bonus Pack (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_bonus_pack_edition_xbox",
"name": "Xsollus: Bonus Pack (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}]
},
"quantity": 3
}],
"is_selectable": true
is_selectable=false의 경우, 요청에서 추가 매개 변수를 전달하지 않아야 합니다.
코드로 쿠폰 사용
쿠폰을 사용하려면 쿠폰 코드 사용 메서드를 호출합니다. 쿠폰 보상 받기 메서드 응답의is_selectable 매개 변수 값에 따라 2가지 가능한 플로우가 있습니다.is_selectable=true의 경우, 쿠폰 코드 사용메서드 호출 시 다음 형식의selected_unit_items개체를 전달해야 합니다.
Copy
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
응답 예시:
Copy
- http
{
{
"items": [
{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 1
},
{
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 3
}
]
}
is_selectable=false의 경우, 요청에서 추가 매개 변수를 전달하지 않아야 합니다.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
