# 개인 맞춤형 카탈로그

사용자 맞춤 설정을 통해 특정 인증된 사용자에게만 아이템 카탈로그를 표시하고 프로모션을 적용할 조건을 지정할 수 있습니다. 조건은 사용자 특성에 기반하여 정의되며, 특정 사용자에게 가장 관련성 있는 아이템과 프로모션을 제공할 수 있습니다.

다음과 같은 사용자 맞춤 설정 유형이 가능합니다:

* [엑솔라 측 사용자 맞춤 설정](/ko/liveops/promotion-tools/personalization/#guides_personalization_on_xsolla_side). 사용자 맞춤 설정 규칙과 로직은 엑솔라 측에서 구성되고 저장됩니다. 사용자 특성을 전달하면 엑솔라가 이를 사용하여 개인 설정된 카탈로그를 생성합니다.
* [파트너 측 사용자 맞춤 설정](/ko/liveops/promotion-tools/personalization/#guides_personalization_on_partner_side). 사용자 맞춤 설정 규칙과 로직을 파트너 측에서 구성하고 특정 사용자에 대한 최종 카탈로그 페이로드를 엑솔라에 전송합니다.

<div class="note">
  <b>참고</b><br><br>
  하나의 사용자 맞춤 설정 유형만 사용할 수 있습니다. 변경하려면
  <a href="/ko/liveops/promotion-tools/personalization/#guides_personalization_change">지침</a>을 따르십시오.
</div>

엑솔라 API를 사용하여 엑솔라 측에서 사용자 맞춤 설정을 구성하는 방법:

1. [가상 아이템 및 인게임 재화](/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 호출을 사용하여 아이템을 생성합니다.
2. [엑솔라 로그인 API를 사용하여 사용자 특성을 설정](/ko/liveops/promotion-tools/personalization/#web_shop_guide_personalization_setting_attributes)하고, 게임 내에서 변경이 발생할 때마다 엑솔라에 데이터를 업데이트하여 동기화 상태를 유지합니다.
3. 아이템 또는 프로모션에 대한 사용자 맞춤 설정을 구성합니다:
    * 아이템 카탈로그를 개인 설정하려면 [카탈로그 필터 규칙 생성](/ko/api/liveops/personalized-catalog/create-filter-rule) API 호출을 사용하여 카탈로그 표시 규칙을 정의합니다:
        * [attribute_conditions](/ko/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=attribute_conditions) 목록에서 사용자 특성에 기반하여 아이템 가용성을 결정하는 조건을 지정합니다.
        * [items](/ko/api/liveops/personalized-catalog/create-filter-rule#personalized-catalog/create-filter-rule/t=request&path=items) 목록에서 사용자의 특성이 지정된 조건과 일치할 경우 표시되어야 하는 아이템 목록을 제공합니다.
    * 개인 설정한 프로모션을 구성하려면 [필요한 프로모션 유형에 대한 생성 및 업데이트 API 호출](/ko/api/liveops/promotions-discounts/create-item-promotion)을 사용합니다. [attribute_conditions](/ko/api/liveops/promotions-discounts/create-item-promotion) 목록에서 사용자 특성에 기반하여 프로모션 가용성을 결정하는 조건을 지정합니다.

4. 사용자 특성을 포함한 [사용자 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)에 전달하여 개인 설정된 카탈로그를 받습니다.

**아이템 카탈로그에 대한 엑솔라 측 사용자 맞춤 설정 구성 및 적용 순서:**

![아이템 카탈로그에 대한 사용자 맞춤 설정](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-catalog.png)

**프로모션에 대한 엑솔라 측 사용자 맞춤 설정 구성 및 적용 순서:**

![프로모션에 대한 사용자 맞춤 설정](https://cdn.xsolla.net/developers/current/images/api_docs/personalization-liveops.png)

<div class="note">
<b>참고</b><br><br>
상세 정보는 다음에서 제공됩니다:
<ul>
  <li><a href="/ko/liveops/promotion-tools/personalization/">엑솔라 측 및 파트너 측 사용자 맞춤 설정 구성 가이드</a></li>
  <li><a href="/ko/doc/shop-builder/tutorials/personalization-tutorial/">엑솔라 측 아이템 카탈로그 사용자 맞춤 설정에 대한 단계별 튜토리얼</a></li>
</ul>
</div>