{"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":"사용자 맞춤 설정을 통해 특정 인증된 사용자에게만 아이템 카탈로그를 표시하고 프로모션을 적용할 조건을 지정할 수 있습니다. 조건은 사용자 특성에 기반하여 정의되며, 특정 사용자에게 가장 관련성 있는 아이템과 프로모션을 제공할 수 있습니다.\n\n다음과 같은 사용자 맞춤 설정 유형이 가능합니다:\n\n* [엑솔라 측 사용자 맞춤 설정](/ko/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side). 사용자 맞춤 설정 규칙과 로직은 엑솔라 측에서 구성되고 저장됩니다. 사용자 특성을 전달하면 엑솔라가 이를 사용하여 개인 설정된 카탈로그를 생성합니다.\n* [파트너 측 사용자 맞춤 설정](/ko/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side). 사용자 맞춤 설정 규칙과 로직을 파트너 측에서 구성하고 특정 사용자에 대한 최종 카탈로그 페이로드를 엑솔라에 전송합니다.\n\n<div class=\"note\">\n  <b>참고</b><br><br>\n  하나의 사용자 맞춤 설정 유형만 사용할 수 있습니다. 변경하려면\n  <a href=\"/ko/liveops/promotion-tools/personalization/#guides_personalization_change\">지침</a>을 따르십시오.\n</div>\n\n엑솔라 API를 사용하여 엑솔라 측에서 사용자 맞춤 설정을 구성하는 방법:\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) 그룹의 **Admin** 하위 섹션의 API 호출을 사용하여 아이템을 생성합니다.\n2. [엑솔라 로그인 API를 사용하여 사용자 특성을 설정](/ko/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes)하고, 게임 내에서 변경이 발생할 때마다 엑솔라에 데이터를 업데이트하여 동기화 상태를 유지합니다.\n3. 아이템 또는 프로모션에 대한 사용자 맞춤 설정을 구성합니다:\n    * 아이템 카탈로그를 개인 설정하려면 [카탈로그 필터 규칙 생성](/ko/api/liveops/personalized-catalog/create-filter-rule) API 호출을 사용하여 카탈로그 표시 규칙을 정의합니다:\n        * [attribute_conditions](/ko/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions) 목록에서 사용자 특성에 기반하여 아이템 가용성을 결정하는 조건을 지정합니다.\n        * [items](/ko/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items) 목록에서 사용자의 특성이 지정된 조건과 일치할 경우 표시되어야 하는 아이템 목록을 제공합니다.\n    * 개인 설정한 프로모션을 구성하려면 [필요한 프로모션 유형에 대한 생성 및 업데이트 API 호출](/ko/api/liveops/promotions-discounts/create-item-promotion)을 사용합니다. [attribute_conditions](/ko/api/liveops/promotions-discounts/create-item-promotion) 목록에서 사용자 특성에 기반하여 프로모션 가용성을 결정하는 조건을 지정합니다.\n\n4. 사용자 특성을 포함한 [사용자 JWT](/ko/api/login/getting-user-token?#getting-user-token)를 [카탈로그 검색 API 호출](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items)에 전달하여 개인 설정된 카탈로그를 받습니다.\n\n**아이템 카탈로그에 대한 엑솔라 측 사용자 맞춤 설정 구성 및 적용 순서:**\n\n![아이템 카탈로그에 대한 사용자 맞춤 설정](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-catalog.png)\n\n**프로모션에 대한 엑솔라 측 사용자 맞춤 설정 구성 및 적용 순서:**\n\n![프로모션에 대한 사용자 맞춤 설정](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-liveops.png)\n\n<div class=\"note\">\n<b>참고</b><br><br>\n상세 정보는 다음에서 제공됩니다:\n<ul>\n  <li><a href=\"/ko/liveops/promotion-tools/personalization/\">엑솔라 측 및 파트너 측 사용자 맞춤 설정 구성 가이드</a></li>\n  <li><a href=\"/ko/doc/shop-builder/tutorials/personalization-tutorial/\">엑솔라 측 아이템 카탈로그 사용자 맞춤 설정에 대한 단계별 튜토리얼</a></li>\n</ul>\n</div>"},"itemId":"personalized-catalog","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/personalized-catalog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}