프로모션 코드

작동 방식

프로모션 코드는 새로운 고객을 유인하고 매출을 증가시키는 마케팅 도구입니다. 프로모션 코드를 활성화하고 장바구니 안의 아이템에 대한 값을 지불하면 사용자는 다음 보상 옵션 중 하나를 받습니다.

  • 사용자의 장바구니에 적용되는 할인
  • 보너스 아이템:
    • 가상 화폐 패키지
    • 게임 키
    • 비갱신 정기결제 또는 번들 포함 가상 아이템

주요 기능:

  • 할인만, 보너스 아이템만 또는 둘 다 보상으로 받습니다.
  • 캠페인에서 프로모션 코드를 사용할 수 있는 횟수를 결정합니다.
  • 하나의 캠페인에서 사용자 한 명에 대한 프로모션 코드 사용 횟수를 정합니다.
  • 요청 시 지역 제한을 설정합니다.
  • 프로모션 코드를 여러 번 생성합니다.
  • 프로모션 코드 사용 후에 장바구니 안 아이템 목록을 변경합니다.
  • 프로모션 코드 사용 후 장바구니에 추가된 아이템에 할인을 적용합니다.

제한 사항:

  • 사용자는 하나의 프로모션 코드를 하나의 장바구니에만 적용할 수 있습니다.
  • 사용자는 장바구니에 아이템을 몇 개 추가한 후에만 장바구니 UI에서 프로모션 코드를 활성화할 수 있습니다.
  • 할인 또는 보너스를 얻으려면, 사용자는 장바구니 안 아이템에 대한 지불을 해야 합니다.
  • 프로모션 코드가 지역 판매 제한이 있는 아이템을 포함하는 경우, 제한된 지역의 사용자는 프로모션 코드에 연결된 아이템을 얻을 수 없습니다.

사용자 플로우:

  1. 사용자가 장바구니 UI에서 해당 필드에 프로모션 코드를 입력합니다.
  2. 장바구니 총액이 다시 계산됩니다.
  3. 사용자가 장바구니 비용을 지불하면서 프로모션 코드를 사용합니다.
  4. 프로모션 코드가 보너스 아이템을 포함하는 경우 사용자에게 전달되는 방법:
    • 인벤토리로 직접(가상 아이템 또는 가상 화폐 패키지)
    • 이메일을 통해(게임 키)
    • 자격 관리 시스템으로 직접(게임 키)

사용자

  • 다음 제품 중 하나 (혹은 둘 다)를 통합한 파트너:
  • 프로모션 코드에 힘입어 매출을 증대시키고자 하는 파트너.

획득 방법

선행 조건

  1. 엑솔라 게시자 계정을 만듭니다.
  2. 내 프로젝트에 스토어를 연결합니다.

통합 절차

프로모션 코드로 캠페인 설정

  1. 게시자 계정에서 스토어 > 프로모션으로 이동하여 프로모션을 만듭니다.
  2. 필요한 매개 변수 지정:
    1. 프로모션 제목을 입력합니다.
    2. 프로모션 유형으로서 프로모션 코드를 선택합니다.
  3. 프로모션 코드의 할인율을 선택합니다.
  4. 사용자가 프로모션 코드를 사용하면 받을 보너스 상품을 선택합니다. 이용 가능한 옵션:
    1. 보상 없음.
    2. 가상 화폐 패키지.
    3. 게임 키.
    4. 가상 아이템(번들을 포함해 하나 또는 그 이상, 비갱신 정기결제).
  5. 총 사용 가능 횟수 및 사용자당 사용 횟수를 결정합니다.
  6. 캠페인 시작 및 종료 날짜를 설정합니다.
  7. 설정을 확인하고 프로모션을 저장합니다.
  8. 프로모션 편집 메뉴로 이동합니다.
  9. 코드 메뉴에서 프로모션 코드 생성 방법 메소드를 선택합니다.
  10. 프로모션 코드를 생성 또는 수동으로 입력합니다.
  11. 변경 사항을 저장합니다.
  12. 프로모션을 활성화합니다.

가상 화폐 패키지와 프로모션 코드

가상 화폐 패키지 프로모션 코드를 위한 화폐 패키지를 지정해야 합니다. 가상 화폐 패키지 만들기:

  1. 가상 화폐 모듈 설정으로 이동해 다음 매개 변수를 지정합니다.
    • 이미지
    • SKU
    • 화폐 이름
    • 가상 화폐 1개당 가격
    • 기본 화폐
  2. 화폐 패키지 필수 개수만큼 만들기 및 만들어 낸 패키지에 대해 지정해야 할 매개 변수:
    • 이미지
    • SKU
    • 이름
    • 설명
    • 사용된 화폐
    • 패키지 안의 화폐 금액
    • 가격
    • 기본 화폐
  3. 화폐 패키지 디스플레이 스토어에서 활성화.

게임 키와 프로모션 코드

게임 키 프로모션 코드에 대한 게임 키 SKU 및 DRM 선택 메소드를 지정해야 합니다. 2가지 선택 사항:

  • 이미 설정된 DRM에 대한 프로모션 코드를 발행합니다. 프로모션 코드 발행 시 매개 변수가 설정됩니다.
  • 프로모션 코드 사용 시 DRM을 선택합니다.
하나의 프로모션 코드에 대해 여러 개의 키를 서로 다른 SKU와 선택할 수 있습니다.

가상 아이템과 프로모션 코드

가상 아이템 SKU 및 가상 아이템 프로모션 코드를 위한 가상 아이템 SKU 수를 지정해야 합니다. 번들 및 비갱신 정기결제를 포함한 하나의 프로모션 코드에 대해 하나 또는 몇 개의 아이템을 다른 SKU와 선택할 수 있습니다.

프로모션 코드 생성

캠페인은 하나 이상의 프로모션 코드를 포함할 수 있습니다. 프로모션 코드 형식의 2가지 선택 사항:

  • 수동 입력 문자열 — 여러 번 사용할 수 있는 프로모션 코드 하나만을 사용하는 캠페인에 적합합니다(최대 128자).
  • 생성된 문자열 — 숫자 및 라틴 심볼로 구성된 라인(10자). 많은 프로모션 코드를 가지는 캠페인에 적합합니다.
프로모션 코드로 프로모션을 만든 후 프로모션 편집기에서 프로모션 코드를 생성할 수 있습니다. 프로모션 코드는 여러 번 생성할 수 있습니다. 수동 입력된 코드 업로드는 엑솔라 측에 이메일로 요청 시 이루어집니다.

Note:
프로모션 코드는 대/소문자를 구분합니다. 예를 들어, winter2021WINTER2021은 서로 다른 2개의 프로모션 코드입니다.

지역 제한

지역 제한은 전체 프로모션 캠페인에 적용됩니다. 지역 제한은 엑솔라에 이메일로 요청 시적용됩니다.

프로모션 코드 보상 얻기

프로모션 코드 사용 후에 사용자가 받는 아이템 목록을 가져오려면 Get promo code rewards의 호출을 구현합니다. 응답의 is_selectable 매개 변수의 값에 따라 2가지 가능한 플로우가 있습니다.

  1. is_selectable=true 값의 경우, type=unit 요소의 모든 item에 대해 unit_items개체에서 선택하는 요소에 대한 양식을 표시해야 합니다. 이 양식에서 사용자는 각 unit 유형에 대해 하나의 요소만 선택합니다.
응답 예시:

Copy
Full screen
Small screen
{
   "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_nintendo_eshop",
               "name": "Xsollus: Gold Edition (nintendo_eshop)",
               "type": "game_key",
               "drm_name": "Nintendo Switch eShop",
               "drm_sku": "nintendo_eshop"
           }]
       },
       "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_origin",
               "name": "Xsollus: Bonus Pack (origin)",
               "type": "game_key",
               "drm_name": "Origin",
               "drm_sku": "origin"
           }, {
               "sku": "xsollus_bonus_pack_edition_drmfree",
               "name": "Xsollus: Bonus Pack (drmfree)",
               "type": "game_key",
               "drm_name": "DRM Free",
               "drm_sku": "drmfree"
           }, {
               "sku": "xsollus_bonus_pack_edition_gog",
               "name": "Xsollus: Bonus Pack (gog)",
               "type": "game_key",
               "drm_name": "GOG",
               "drm_sku": "gog"
           }, {
               "sku": "xsollus_bonus_pack_edition_rockstar",
               "name": "Xsollus: Bonus Pack (rockstar)",
               "type": "game_key",
               "drm_name": "Rockstar Games Launcher",
               "drm_sku": "rockstar"
           }]
       },
       "quantity": 3
   }],
   "discount": {
       "percent": null
   },
   "is_selectable": true

  1. is_selectable=false의 경우, 요청에서 추가 매개 변수를 전달하지 않아야 합니다.

프로모션 코드 사용

프로모션 코드를 사용하려면 Redeem promo code method의 호출을 구현합니다. is_selectable 매개 변수의 값에 따라 Get promo code rewards method 응답에는 2가지 가능한 플로우가 있습니다.

  1. is_selectable=true의 경우, 다음 형식의 selected_unit_items 개체를 Redeem promo code method 호출 시 전달해야 합니다.

Copy
Full screen
Small screen
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

응답 예시:

Copy
Full screen
Small screen
{
  {
    "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
    }
    ]
}

  1. is_selectable=false의 경우, 요청에서 추가 매개 변수를 전달하지 않아야 합니다.