{"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":"업셀링은 사용자에게 부가 가치가 있는 아이템의 구매를 제안하는 판매 방식입니다. 예를 들어 다른 사용자 사이에서 수요가 매우 높은 아이템일 수 있습니다. 업셀링 아이템에 대한 지역 제한도 구성할 수 있습니다. 자세한 내용은 [업셀링](/ko/liveops/promotion-tools/upsell/) 섹션을 참조해 주세요.\n\n업셀링용으로 구성된 아이템 목록과 업셀링 상태(활성화 또는 비활성화)는 [프로젝트에서 업셀링 정보 가져오기](/ko/api/liveops/upsell-admin/get-upsell-configurations-for-project-admin) API 메서드에서 반환합니다. 클라이언트 측에서는 [프로젝트에서 업셀링 아이템 가져오기](/ko/api/liveops/upsell-client/get-upsell-for-project-client) API 메서드가 아이템 목록을 반환하며, 구매 흐름의 적절한 지점에서 사용자에게 표시됩니다.\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) 그룹에 있는 API 호출을 사용하여 아이템을 생성합니다.\n2. [업셀링 생성](/ko/api/liveops/upsell-admin/post-upsell) API 호출을 사용하여 업셀링을 설정합니다. 필수 아이템의 SKU를 `items` 배열로 전달합니다.\n3. [프로젝트의 업셀링 활성화/비활성화](/ko/api/liveops/upsell-admin/put-upsell-toggle-active-inactive) API 호출을 사용하여 프로젝트의 업셀링을 활성화합니다.\n4. 구매 흐름의 적절한 지점에서 [프로젝트에서 업셀링 아이템 목록 가져오기](/ko/api/liveops/upsell-client/get-upsell-for-project-client) API 호출을 사용하여 사용자에게 업셀링 제안을 표시합니다.\n5. 주문 결제를 위한 결제 UI가 열리도록 구현합니다. 예를 들어 [특정 장바구니의 모든 아이템으로 주문 생성](/ko/api/catalog/payment-client-side/create-order-by-cart-id) API 호출을 사용할 수 있습니다. 응답으로 결제 UI를 여는 토큰이 반환됩니다.\n6. 예를 들어 [웹훅](/ko/webhooks/overview)을 사용하여 주문 상태 추적을 구성하고, 결제가 완료된 아이템의 데이터를 신속하게 받아 사용자에게 지급합니다.\n\n![업셀링 시나리오](https://cdn.xsolla.net/developers/current/images/api_docs/Upsell.svg)"},"itemId":"upsell-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/upsell-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}