{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/ko/api/liveops/index.yaml","sidebar":"sidebar-@l10n/ko/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/ko/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/ko/api/liveops","seo":{"title":"개요","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"프로모션은 신규 사용자를 유치하고 매출을 높이기 위해 고안된 마케팅 도구입니다. 엑솔라 API를 사용하여 다음과 같은 프로모션을 설정할 수 있습니다.\n\n* 할인 - 선택한 아이템의 가격을 인하.\n* 보너스 - 구매 시 사용자에게 제공되는 아이템.\n* 쿠폰 - 사용 시 하나 이상의 보너스 아이템을 받을 수 있는 코드.\n* 프로모션 코드 - 사용자가 보너스 아이템을 받거나, 특정 상품에 대해 할인을 받거나, 장바구니 전체에 대해 할인을 받을 수 있게 해주는 코드. 사용자가 입력한 후에 사용 가능한 쿠폰과 달리, 프로모션 코드는 구매를 진행할 때(결제 시)에 사용됩니다.\n* 특별 혜택 - 고유한 혜택 코드를 입력한 사용자에게만 카탈로그에 표시되는 숨겨진 아이템. 코드를 입력하지 않으면 해당 아이템은 표시되지 않습니다.\n\n할인 프로모션을 구성하는 예시 절차:\n1. [가상 아이템 및 인게임 재화](/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [번들](/ko/api/catalog/bundles-admin/admin-create-bundle) 또는 [게임 키](/ko/api/catalog/game-keys-admin) 그룹의 **관리자** 하위 섹션의 호출을 사용하여 아이템을 생성합니다.\n2. [아이템 할인 프로모션 생성](/ko/api/liveops/promotions-discounts/create-item-promotion/) 호출을 사용하여 프로모션을 생성합니다. `items` 배열에서 필요한 아이템 SKU를 전달합니다.\n3. 프로모션 유효 기간을 설정합니다. 이를 위해 [아이템 할인 프로모션 생성](/ko/api/liveops/promotions-discounts/create-item-promotion/) 또는 [아이템 프로모션 업데이트](/ko/api/liveops/promotions-discounts/update-item-promotion/) 메소드를 호출하고, `promotion_periods` 필드를 객체 배열로 전달합니다. 여기서  `date_from`은 유효 기간의 시작일을, `date_until`은 종료일을 정의합니다.\n4. [아이템 프로모션 업데이트](/ko/api/liveops/promotions-discounts/update-item-promotion/) 호출을 사용하여 프로모션을 활성화합니다. `\"is_enabled\": true` 매개 변수를 전달합니다.\n5. 할인 가격을 포함하여 아이템 가격 정보를 가져오려면, [일반 > 카탈로그](/ko/api/catalog/tag/common-catalog/), [가상 아이템 및 인게임 재화 > 카탈로그](/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items/), [번들 > 카탈로그](/ko/api/catalog/bundles-catalog/get-bundle-list/) 하위 섹션에서 아이템 카탈로그를 가져오는 클라이언트 API 메소드를 호출합니다.\n\n![프로모션 구성 예시](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)\n\n프로모션 구성에 대한 자세한 내용은 참조 문서를 참조하십시오.\n* [할인](https://developers.xsolla.com/ko/liveops/promotion-tools/discounts/)\n* [보너스](https://developers.xsolla.com/ko/liveops/promotion-tools/bonuses/)\n* [쿠폰](https://developers.xsolla.com/ko/liveops/promotion-tools/coupons/)\n* [프로모션 코드](https://developers.xsolla.com/ko/liveops/promotion-tools/promo-codes/)\n* [고유 카탈로그 혜택](https://developers.xsolla.com/ko/liveops/promotion-tools/unique-offer/)"},"itemId":"promotions-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.217.32"},"lang":"ko","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ko/api/liveops/promotions-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}