설명서CommerceLive Search 안내서

경계 및 제한

Last update: Thu Jan 29 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 개발자

사이트 검색과 관련하여 Adobe Commerce은 옵션을 제공합니다. Live Search과(와) Catalog Service이(가) 귀하의 비즈니스 요구 사항을 충족하는지 확인하려면 다음 경계 및 제한을 검토하십시오. 콘텐츠 검색, BYOA(bring-your-own-algorithm) 또는 속성 기반 머천다이징과 같은 고급 검색 기능이 필요한 경우 서드파티 검색 솔루션을 고려하십시오.

일반

  • 검색 어댑터는 ​ 4.0.0부터 ​사용되지 않음Live Search됩니다. PLP(제품 목록 페이지) 위젯은 앞으로 모든 Live Search 구현에 대해 지원되는 솔루션입니다. 검색 어댑터는 보안 관련 업데이트만 받습니다. PLP 위젯으로 마이그레이션하는 방법에 대한 자세한 내용은 마이그레이션 안내서를 참조하십시오.
  • 이(가) 설치되어 있고 상점 바닥글의 고급 검색 링크가 제거되면 ​고급 검색Live Search 모듈이 비활성화됩니다.
  • ​ 필드 및 제품 목록 페이지 위젯에서는 ​계층 가격 책정Live Search이 지원되지 않습니다.
  • 제품 가격에는 부가가치세(VAT)가 포함되어 있지만 Live Search에서는 VAT를 별도의 값으로 표시할 수 없습니다.
  • 컨텐츠 검색(CMS 페이지 및 블록)은 지원되지 않습니다.
  • 페이지 번호를 지정할 수 있는 최대 결과 수는 10,000개입니다. 카테고리 또는 검색 결과에 많은 수의 제품이 포함되어 있는 경우 쇼핑객이 페이지 매김을 사용할 필요가 없도록 하려면 제품을 필터링할 수 있는 의미 있는 방법을 제공하십시오.
  • 설명 및 사용자 지정 속성을 포함하여 속성당 1MB의 하드 제한이 있습니다.
  • 검색 어댑터는 사용자 지정 소스 모델로 만들어져 패싯으로 사용되는 제품 속성을 지원하지 않습니다. 이 기능을 지원하려면 제품 목록 페이지 위젯을 사용해야 합니다.
  • 사용자 지정 제품 유형은 지원되지 않습니다.
  • "is_user_defined": false을(를) 사용하여 프로그래밍 방식으로 만든 사용자 지정 특성은 지원되지 않습니다.
  • 개발자 설명서에 설명된 대로 일부 제한 사항이 있는 "다음으로 시작" 또는 "포함" 조건을 사용하여 결과를 필터링할 수 있습니다.
  • 지난 해 내에서만 성과 지표를 추적할 수 있습니다.
  • 검색 쿼리에 여러 단어가 포함되어 있는 경우 단어 사이에 공백이 있으면 해당 단어가 별도의 검색어로 처리됩니다. 여러 단어 검색 쿼리를 처리하려면 동의어를 사용하십시오.
  • Live Search은(는) 기본적으로 검색어 리디렉션을 지원하지 않습니다. Fastly 또는 다른 사용자 지정 구성을 사용하여 리디렉션을 구현합니다.

색인화

  • 스토어 보기당 최대 총 450개의 제품 특성을 Live Search 인덱스. 이는 다음과 같이 배포됩니다.

    • 정렬 가능한 속성 50개
    • 필터링 가능한 특성 200개
    • 검색 가능한 속성 200개

  • Live Search은(는) Adobe Commerce 데이터베이스의 제품만 인덱싱합니다.

  • CMS 페이지는 색인화되지 않습니다.

  • SKU, 이름 및 카테고리 속성은 기본적으로 검색할 수 있으며 검색에서 제외할 수 없습니다. 해당 범주에 포함시키려는 제품이 아닌 경우 해당 범주에서 제품 할당을 취소해야 합니다.

패싯

  • 정의된 필터링 가능한 속성 집합에서 최대 100개의 속성을 패싯으로 구성할 수 있습니다.
  • Facet 내에서 최대 100개의 버킷이 반환될 수 있습니다. 100개가 넘는 버킷을 반환해야 하는 경우 지원 티켓을 만드십시오. 그러면 Adobe에서 성능에 대한 영향을 분석하고 환경에 대한 이 제한을 늘릴 수 있는지 확인할 수 있습니다.
  • 동적 패싯은 큰 인덱스와 순서가 높은 인덱스에서 성능 문제를 일으킬 수 있습니다. 동적 패싯을 만들어 성능 저하 또는 페이지가 시간 초과 오류와 함께 로드되지 않은 것을 발견한 경우 패싯을 고정으로 변경하여 성능 문제가 해결되는지 확인하십시오.
  • 재고 상태(quantity_and_stock_status)는 패싯으로 지원되지 않습니다. inStock: 'true'을(를) 사용하여 재고 제품을 필터링할 수 있습니다. 이는 LiveSearchAdapter 관리자의 "재고 부족 제품 표시"가 "True"로 설정된 경우 Commerce 모듈에서 즉시 지원됩니다.
  • 날짜 유형 속성은 패싯으로 지원되지 않습니다.
  • 해당 속성이 Facet으로 추가된 후 속성 메타데이터에 수행된 모든 변경 사항은 Facet에 반영되지 않습니다.
  • 최대 50개의 정렬 가능한 속성과 200개의 검색 가능한 속성을 가질 수 있습니다.

쿼리

  • Live Search은(는) 쿼리에 대해 고유한 GraphQL 끝점을 사용하여 동적 팩팅 및 귀하가 입력한 대로 검색과 같은 기능을 지원합니다. GraphQL API와 비슷하지만 몇 가지 차이점이 있으며 일부 필드가 완전히 호환되지 않을 수 있습니다.
  • 검색 쿼리에서 반환할 수 있는 최대 결과 수는 10,000개입니다.
  • 페이지당 최대 결과 수는 500개입니다.
  • 날짜 유형 특성을 사용하여 결과를 필터링할 수 없습니다.
NOTE
위치별로 정렬하려면 유효한 categoryPath 또는 categoryIds 필터가 활성화되어 있어야 합니다. 자세히 알아보기

머천다이징 검색

  • 스토어 보기당 최대 검색 머천다이징 규칙 수는 50개입니다.
  • 규칙당 최대 조건 수는 10개입니다.
  • 규칙당 최대 이벤트 수는 25개입니다.
  • 기본 정렬 순서 "정렬 기준: 가장 관련성"을 선택하면 규칙 및 수동 등급 제품이 검색 결과에 적용됩니다. 쇼핑객이 정렬 순서를 이름별 또는 가격별 정렬과 같이 변경하는 경우, 규칙 및 수동 순위는 더 이상 적용되지 않습니다.
  • 페이지가 매겨진 응답에서 예측할 수 없는 결과를 방지하려면 고정된 제품의 수가 요청된 페이지 크기를 초과하지 않아야 합니다.

동의어

  • Live Search은(는) 스토어 보기당 최대 200개의 동의어를 관리할 수 있습니다.

카테고리 머천다이징

  • 각 스토어 보기에 대해 카테고리당 하나의 규칙을 만들 수 있습니다.
  • 규칙당 최대 조건 수는 10개입니다.
  • 규칙당 최대 이벤트 수는 25개입니다.
  • 특정 카테고리가 상점 첫 화면에서 열리고 해당 카테고리에 대한 규칙이 있는 경우 규칙이 적용됩니다. 카테고리 머천다이징 규칙의 경우 기본 정렬 순서는 "정렬 기준: 위치"입니다. 쇼핑객이 정렬 순서를 변경하면 모든 숨겨진 제품, 고정된 제품 및 숨겨진 제품이 더 이상 정렬되지 않습니다.

B2B 및 범주 권한

  • 기본 공유 카탈로그에 추가되지 않은 제품은 표시되지 않습니다.

  • 범주 권한을 사용하여 고객 그룹을 제한하려면 다음을 수행하십시오.

    • 제품을 루트 범주에 할당해야 합니다. (참고: SaaS 데이터 내보내기 확장을 버전 103.4.0+로 업데이트하여 이 제한을 제거할 수 있습니다. 데이터 내보내기 확장 관리를 참조하십시오.
    • "로그인되지 않은" 고객 그룹에는 "허용" 검색 권한이 부여되어야 합니다.
    • 제품을 "로그인되지 않음" 고객 그룹으로 제한하려면 각 범주로 이동하여 각 고객 그룹에 대한 권한을 설정합니다.

  • PWA Studio에서 PLP 위젯을 사용하는 B2B에 대한 기본 지원은 현재 지원되지 않습니다. 그러나 API를 사용하여 이 기능을 구현할 수 있습니다.

  • Live Search의 범주 패싯에 특정 고객 그룹에 표시할 수 없는 범주가 표시될 수 있습니다.

  • Live Search에서는 최대 1,000개의 고객 그룹을 지원할 수 있습니다.

Storefront popover

  • popover은(는) Luma 테마 또는 Luma​을(를) 기반으로 하는 사용자 지정된 테마를 사용하는 스토어에만 사용할 수 있습니다. 검색 결과 페이지의 탐색 표시에는 Luma 스타일이 없습니다.
  • popover은(는) Blank 테마를 지원하지 않습니다.
  • popover은(는) 빠른 주문 양식에서 지원되지 않습니다.
  • 위시리스트 및 제품 비교는 지원되지 않습니다.
  • 페루 솔(PEN)의 통화 기호는 지원되지 않습니다.

문제 해결

Live Search의 일반적인 문제를 해결하는 데 대한 도움말을 보려면 다음 기술 자료를 참조하십시오.

  • Live Search 카탈로그가 동기화되지 않음 - Adobe Commerce 스토어와 Live Search 서비스 간에 제품 카탈로그 데이터가 올바르게 동기화되지 않는 경우 솔루션을 제공합니다. 이 문서에서는 동기화 상태를 확인하고, 동기화 오류를 식별하며, 데이터 동기화 문제를 해결하는 방법에 대해 설명합니다.
  • Live Search 대시보드 및 검색 결과 순위가 잘못됨 - 실시간 검색 대시보드에 표시된 검색 결과 또는 성능 지표가 예상대로 표시되지 않는 문제를 해결합니다. 이 문서에서는 순위 불일치 및 대시보드 데이터 불일치를 해결하는 방법에 대해 설명합니다.
  • Live Search 패싯이 알파벳순으로 정렬되지 않음 - 패싯 값이 알파벳순이 아닌 예기치 않은 순서로 표시되는 문제를 해결합니다. 이 문서에서는 상점 첫 화면에서 패싯 정렬 동작을 구성하고 수정하는 단계를 제공합니다.

추가 지원이 필요한 경우 지원에 문의하십시오.

recommendation-more-help
8eedb3c4-09d2-4e4f-917b-524833fc6b4f