프로모션 코드

작동 방식

일반 정보

프로모션 코드를 활용한 프로모션은 구매 전환율을 높이고 평균 결제 금액을 증가시키기 위해 고안된 마케팅 도구입니다. 프로모션 코드를 주문에 적용하면 사용자는 다음과 같은 혜택을 누릴 수 있습니다:

  • 전체 구매 또는 특정 아이템에 적용되는 할인
  • 다음을 포함한 보너스 아이템:
    • 인게임 재화 패키지
    • 게임 키
    • 가상 아이템
    • 번들

주요 기능:

  • 유연한 보너스 구성. 단일 보너스 유형(구매 시 할인, 선택 아이템 할인 또는 보너스 아이템) 또는 이들의 조합을 설정할 수 있습니다.
  • 캠페인 내 총 사용 수량 설정.
  • 캠페인 내 사용자당 사용 횟수 설정.
  • 프로모션 코드의 다중 생성.
  • 프로모션 코드와 연결된 캠페인 및 아이템에 대한 지역 제한 적용.
참고
캠페인 지역 제한을 설정하려면 igs@xsolla.com으로 문의해 주세요.

제한 사항:

  • 구매 시 프로모션 코드는 하나만 적용할 수 있습니다.
  • 할인 또는 보너스 아이템을 받으려면 사용자는 구매 대금을 지불해야 합니다.
  • 인게임 재화로 표시된 가격에는 할인이 적용되지 않습니다. 실제 통화와 인게임 재화 가격이 모두 표시된 아이템의 경우, 할인은 실제 통화 가격에만 적용됩니다.
  • 게임 키가 보너스 아이템으로 사용될 경우, 키는 사용자에게 이메일 또는 자격 시스템으로 발송됩니다. 캠페인의 키가 소진되면 사용자는 프로모션 코드를 사용할 수 없습니다.
  • 프로모션 코드 캠페인에 지역 제한이 적용되면 해당 지역의 사용자는 프로모션 코드를 사용할 수 없습니다.
  • 프로모션 코드에 지역 제한이 적용된 보너스 아이템이 하나 이상 포함된 경우, 해당 지역의 사용자는 이 프로모션 코드를 사용할 수 없습니다.
예: 프로모션 코드 사용 시 방패와 검이 보너스로 제공됩니다. 방패에는 지역 제한이 적용되며 미국 내에서만 구매할 수 있습니다. 미국 외 지역 사용자가 프로모션 코드를 입력하면 프로모션 코드 확인 또는 프로모션 코드 사용 호출에 대한 오류 응답이 반환됩니다. 해당 사용자는 프로모션 코드로 제공되는 아이템을 받을 수 없습니다.
참고

스토어에 쿠폰 프로모션을 설정할 수도 있습니다.

주요 차이점:

  • 쿠폰을 사용할 경우 사용자가 보너스 아이템만 받을 수 있습니다. 프로모션 코드 사용 시 보너스 아이템, 특정 아이템 할인 또는 전체 장바구니 할인을 제공할 수 있습니다.
  • 프로모션 코드는 구매 중(결제 단계에서) 사용되며, 쿠폰은 사용자가 코드를 입력하고 적용한 후에 사용됩니다.

사용자 절차

참고
사용자가 결제를 완료하기 전에 프로모션 코드 적용을 취소할 수 있습니다.

할인 적용 규칙

구매 시 한 아이템에 여러 프로모션을 사용할 수 있는 경우 아이템에 할인이 하나씩 적용됩니다. 할인이 적용되는 순서는 중요하지 않습니다.

예시:

가상 아이템의 가격은 10달러입니다. 관리자 페이지에서는 가상 아이템에 대해 다음과 같은 프로모션이 생성되었습니다:

  • 11월 4일부터 30일까지 10% 할인을 제공하는 블랙 프라이데이 할인 프로모션
  • 11월 15일부터 12월 15일까지 20% 할인을 제공하는 세일 할인 프로모션
  • 11월 4일부터 30일까지 프로모션 코드로 5% 할인 혜택

아이템을 11월 20일에 구매하면 할인 프로모션과 프로모션 코드를 제공하는 프로모션을 모두 사용할 수 있습니다.

이 경우 가상 아이템의 총 비용은 (($10 - 10%) - 20%) - 5% = $10 × (100%-10%) × (100%-20%) × (100%-5%) = $10 × 0.9 × 0.8 × 0.95로 계산하며 결과적으로 $6.84입니다.

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

참고

보너스 아이템이 포함된 프로모션을 생성하려면 먼저 해당 아이템을 구성한 다음 프로모션 설정 단계로 진행해야 합니다.

관리자 페이지의 프로젝트에서 아이템을 수동으로 생성하려면 아이템 카탈로그 > 모든 아이템으로 이동하십시오. 아이템 생성 방법에 대한 자세한 내용은 아이템 카탈로그 참조 문서 섹션에서 확인할 수 있습니다.

관리자 페이지에서 설정

프로모션 코드가 포함된 새 캠페인을 생성하는 방법:

  1. 관리자 페이지의 프로젝트에서, LiveOps > 프로모션 섹션으로 이동합니다.
  2. 프로모션 탭에서 프로모션 생성을 클릭합니다.
  1. 프로모션 이름을 지정합니다.
  2. 프로모션 유형 드롭다운 목록에서 프로모션 코드를 선택합니다.
  3. 외부 ID 입력란에서, API 호출을 통해 프로모션을 관리하는 데 사용되는 프로모션 ID를 지정합니다.
  4. 프로모션 코드 사용 시 특정 아이템 또는 전체 장바구니에 할인을 적용하는 방법:

    1. 구매 시 할인 토글을 켜기로 설정합니다.
    1. 할인 금액 입력란에 할인율을 지정합니다.

  1. 프로모션 코드 사용 시 특정 상품에 할인을 적용하는 방법:

    1. 선택한 아이템에 대한 할인 토글을 켜기로 설정합니다.
    1. 할인 금액 입력란에 할인율을 지정합니다.
    1. 아이템 유형 드롭다운 목록에서 프로모션 코드 사용 시 할인이 적용될 아이템 유형을 선택합니다.
    1. 아이템을 선택합니다.

  1. 프로모션 코드 사용 시 보너스 아이템 제공:

    1. 보너스 아이템 토글을 켜기로 설정합니다.
    1. 보너스 아이템 선택 드롭다운 목록에서 프로모션 코드 사용 시 사용자에게 제공할 아이템 유형을 선택합니다.
    1. 프로모션 코드 사용 시 제공할 아이템을 선택합니다.
    1. 가상 아이템의 경우, 각 아이템의 수량을 지정합니다.
    1. 게임 키의 경우, 플랫폼이 결정되는 시점을 명시합니다:
      • 특정 플랫폼(예: Steam)을 사전 할당하려면 DRM 유형 선택 드롭다운 목록에서 코드 생성 시 DRM 선택을 선택하십시오. 그런 다음 DRM 드롭다운 목록에서 플랫폼을 선택하십시오.
      • 사용자가 선택할 수 있도록 하려면 DRM 선택 유형 드롭다운 목록에서 플레이어가 사용 시 DRM 선택을 선택하십시오.
    1. 다음을 클릭합니다.

참고

주문 또는 특정 아이템에 대한 할인은 정수여야 하며 99%를 초과할 수 없습니다. 특정 아이템이나 보너스 아이템에 대한 할인을 설정할 때는 다음 사항을 고려하십시오:

  • 아이템 유형은 해당 유형의 아이템을 프로젝트에서 하나 이상 생성한 경우에만 선택할 수 있습니다.
  • 다양한 유형의 아이템을 구성할 수 있습니다. 아이템 유형을 전환하려면 아이템 유형 선택 입력란을 사용하십시오.
  1. 프로모션 코드 사용 제한 설정:

    1. 캠페인 내 모든 사용자의 프로모션 코드 사용 총 횟수를 제한하려면 사용 총횟수 제한 토글을 켜기로 설정하고 최대 사용 횟수를 지정합니다.
    1. 캠페인 내 단일 사용자가 교환 가능한 프로모션 코드 수를 제한하려면, 사용자당 사용 총횟수 제한 토글을 켜기로 설정하고 사용자당 최대 사용 횟수를 지정합니다.
    1. 모든 사용자의 고유 프로모션 코드를 사용하는 횟수를 제한하려면, 고유 프로모션 코드 사용 횟수 제한 토글을 켜기로 설정하고 프로모션 코드의 최대 사용 횟수를 지정합니다.
    1. 다음을 클릭합니다.

  1. 시간대, 시작 날짜 및 종료 날짜 등 캠페인 유효 기간을 지정합니다. 종료 날짜 없이 캠페인을 생성하려면 종료 날짜 없음 상자를 선택합니다.
  2. 다음을 클릭합니다.
  3. 캠페인 설정을 검토합니다.
  4. 저장하고 나가기를 클릭합니다.

캠페인에 프로모션 코드를 추가하는 방법:

  1. 관리자 페이지의 프로젝트에서, LiveOps > 프로모션 섹션으로 이동합니다.
  2. 프로모션 코드 프로모션이 있는 행에서 •••를 클릭하고 드롭다운 목록에서 프로모션 편집을 선택합니다.
  1. 코드 탭으로 이동합니다.
  2. 코드를 자동으로 생성하는 방법:
    1. 코드 문자열 양식 드롭다운 목록에서 자동 생성을 선택합니다.
    1. 생성할 코드 수량을 지정하고 생성을 클릭합니다.
  1. 코드를 수동으로 추가하는 방법:
    1. 코드 문자열 양식 드롭다운 목록에서 수동 입력을 선택합니다.
    1. 프로모션 코드를 입력하고 생성을 클릭합니다.
    1. 코드를 필요한 수량만큼 추가하려면 이전 단계를 반복합니다.
  1. 코드가 포함된 CSV 파일을 다운로드합니다(선택 사항).
참고

프로모션 코드는 대소문자를 구분합니다. 예를 들어, winter123WINTER123은 서로 다른 프로모션 코드로 간주합니다.

캠페인에 새 코드를 추가하는 횟수는 무제한입니다. 단, 추가된 코드의 총 수량은 50,000개를 초과할 수 없습니다.

직접 생성한 코드를 대량으로 업로드하려면 igs@xsolla.com으로 문의해 주세요.

캠페인을 활성화해야 사용자가 이용할 수 있습니다. 활성화 방법:

  1. 관리자 페이지의 프로젝트에서, LiveOps > 프로모션 섹션으로 이동합니다.
  2. 프로모션 코드 프로모션이 있는 행에서 •••를 클릭하고 드롭다운 목록에서 프로모션 편집을 선택합니다.
  3. 오른쪽 상단 모서리의 드롭다운 목록에서 프로모션 활성화를 선택합니다.

API를 통한 설정

참고
API를 통해 프로모션을 구성할 때, 소수점 할인 금액을 지정할 수 있습니다.
알림
프로모션 업데이트를 위해 API 호출을 사용할 때 필요한 매개 변수 목록이 프로모션 검색을 위해 API 호출에서 반환된 매개 변수 목록과 일치하지 않습니다. 프로모션을 업데이트하기 위해 API 메서드를 호출할 때 다음을 전달해야 합니다:
  • 필수 매개변수
  • 변경하려는 매개 변수
  • 프로모션 검색 호출이 반환하는 다른 모든 매개 변수

API를 통해 프로모션 코드를 포함한 캠페인을 설정하고 관리하려면 다음 호출을 사용합니다.

작업API 호출
프로모션 코드로 프로모션 생성.프로모션 코드 프로모션 생성.
프로모션 코드로 프로모션 활성화.프로모션 코드 프로모션 활성화.
프로모션을 편집합니다.새로운 프로모션 옵션으로 프로모션 코드 프로모션 업데이트. 활성 상태의 프로모션에도 프로모션 편집을 사용할 수 있습니다.
프로모션 비활성화.프로모션 코드 프로모션 비활성화.
무기한 프로모션을 설정합니다.프로모션 코드 프로모션 생성 또는 프로모션 코드 프로모션 업데이트. 열거한 호출에 “date_end”:null 매개 변수를 전달합니다.
프로모션을 삭제합니다.프로모션 코드 프로모션 삭제.
참고
활성 프로모션을 비활성화하거나 삭제하면 사용자에게 더 이상 표시되지 않습니다.

애플리케이션 또는 웹 사이트에서 프로모션 코드 사용 기능 설정

UI에서의 프로모션 코드 사용

  1. 애플리케이션 UI(카탈로그 또는 장바구니)에 다음 요소를 구현하십시오:

    • 프로모션 코드 입력란
    • 프로모션 코드 보상 및 할인을 표시하는 UI 요소
    • 프로모션 코드 보상 선택 양식(해당하는 경우)
    • 프로모션 코드를 적용하는 버튼
  2. 다음 클라이언트 측 API 호출을 사용하여 프로모션 코드 로직을 구현합니다.

참고
엑솔라 API를 호출하기 위해 게임 엔진 및 플랫폼에 이미 만들어진 SDK 메서드를 사용할 수 있습니다.
작업API 호출
프로모션 코드가 올바른지 확인.프로모션 코드 확인.
게임 키가 프로모션 코드 보너스로 제공될 경우 사용자에게 표시할 게임 배포 플랫폼 목록을 가져옵니다.

프로모션 코드 보상 가져오기.

응답이 is_selectable=true를 반환하는 경우, type=unit에 해당하는 아이템은 unit_items 개체의 요소들에 대한 선택 양식을 표시해야 합니다. 이 양식에서 사용자는 각 unit 유형별로 하나의 요소만 선택할 수 있습니다.

게임 키에 해당하는 type=unit 매개 변수가 전달됩니다. 이 경우 사용자는 게임 플랫폼을 선택해야 합니다.

프로모션 코드의 할인 및 보너스 아이템을 반영한 업데이트된 카탈로그를 표시합니다.카탈로그 하위 섹션의 호출을 사용하십시오. 프로모션 코드는 promo_code 요청 매개 변수로 전달해야 합니다.
특정 아이템을 장바구니에 담지 않고 바로 구매하고 프로모션 코드를 사용하십시오.

지정된 아이템으로 주문 생성.

프로모션 코드를 promo_code 요청 매개 변수에 전달해야 합니다.

프로모션 코드를 적용하고 장바구니 내용물과 총 비용을 업데이트합니다(할인 적용 및 보너스 아이템 추가).

프로모션 코드 사용.

프로모션 코드를 coupon_code 요청 매개 변수에 전달해야 합니다.

참고
캠페인 내에서 사용자가 프로모션 코드를 추가 적용 가능한 횟수를 확인하려면, 지정된 사용자의 프로모션 코드 제한 가져오기 서버 측 API 호출을 사용합니다.
  1. 프로모션 코드 사용 시 아이템이 사용자에게 올바르게 제공되도록 합니다.
  1. 이미 애플리케이션이나 웹사이트에서 인게임 스토어를 구현한 경우 추가 설정이 필요하지 않습니다. 프로모션 코드에 연결된 아이템은 일반 구매와 동일한 방식으로 사용자에게 제공됩니다.
참고
게임 키는 이메일 또는 자격 시스템을 통해 사용자에게 발송됩니다.

엑솔라로 생성된 웹 사이트에서의 프로모션 코드 사용

알림
쿠폰 및 프로모션 코드 사용 기능은 웹샵 솔루션 템플릿을 사용하여 생성한 웹사이트에만 추가할 수 있습니다.

웹사이트에 코드 입력란을 표시하는 방법:

  1. 관리자 페이지에서 프로젝트를 열고 스토어프런트 > 웹 사이트 섹션으로 이동합니다.
  2. 사이트 섹션에서 사이트를 선택하고 웹 사이트 빌더 열기를 클릭합니다.
  3. 빌더의 기본 영역에서 새 블록을 추가할 위치를 선택하고 블록 추가를 클릭합니다.
  4. 프로모션 코드 블록을 선택합니다.
  5. 블록 외관을 사용자 정의합니다(선택 사항).
    • 블록의 헤더와 설명 텍스트를 편집합니다.
    • 블록에 사용자 정의 배경을 설정합니다.
    • 버튼 스타일을 변경합니다.
    • 쿠폰 사용 버튼의 텍스트를 편집합니다.
  6. 변경 사항을 적용하려면 웹사이트를 게시합니다.

    1. 사이트 빌더의 오른쪽 상단 모서리에서 게시를 클릭합니다.
    1. 게시하려는 페이지 옆의 확인란을 선택합니다.
    1. 게시를 클릭합니다.

참고

사이트 게시를 사용할 수 없는 경우 다음과 같은 모든 조건이 충족되었는지 확인합니다.

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
마지막 업데이트: 2026년 2월 13일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!
피드백을 보내는 중 문제가 발생했습니다
잠시 후 다시 시도하거나 doc_feedback@xsolla.com으로 연락해 주세요.