서빙 컨트롤 정보

서빙 컨트롤을 서빙 구성에 적용하여 검색에서 검색어를 처리하고 결과를 반환하는 방법을 맞춤설정할 수 있습니다. 서빙 컨트롤은 컨트롤-작업 쌍으로 구성된 규칙입니다. 즉, 컨트롤은 서빙 컨트롤이 실행되는 시점을 지정하고 작업은 서빙 컨트롤이 적용할 동작을 지정합니다.

Search for Retail 콘솔에서 또는 API Control.create 메서드를 사용하여 서빙 컨트롤을 만들 수 있습니다.

그런 다음 생성한 검색 서빙 구성에 새 서빙 컨트롤을 연결할 수 있습니다. 서빙 시 요청의 활성 서빙 구성에 대한 컨트롤만 고려됩니다.

Search for Retail 콘솔에서 서빙 컨트롤을 만드는 방법에 대한 자세한 내용은 서빙 컨트롤 만들기를 참조하세요.

다음과 같은 서빙 컨트롤을 사용할 수 있습니다.

  • 부스트/하강: 반환된 결과 목록의 순위와 순서에 영향을 미칩니다. 검색 및 추천에 사용할 수 있습니다.
  • 필터: 반환된 결과 목록에서 필터를 통과하지 않은 결과를 삭제합니다. 검색에만 사용 가능합니다.
  • 리디렉션: 검색 쿼리에 따라 사용자를 특정 페이지로 리디렉션합니다. 검색에만 사용 가능합니다.
  • 링퀴스틱: 검색 쿼리의 언어적 요소를 맞춤설정합니다. 검색에만 사용 가능합니다. 여러 가지 유형의 언어적 컨트롤을 사용할 수 있습니다.
    • 동의어: 검색 쿼리에서 동의어로 간주되는 범위를 확장합니다.
    • 단방향 동의어: 특정 검색어의 동의어를 단방향으로 확장합니다.
    • 무시: 특정 검색어가 검색에 사용되지 않도록 방지합니다.
    • 연관 금지: A 검색어가 표시되었을 때 B 검색어가 검색에 사용되지 않게 하는 컨트롤입니다.
    • 교체: 검색 쿼리에서 검색어를 바꿉니다.

컨트롤 조건

컨트롤 조건은 제공 컨트롤이 실행되는 시기를 지정합니다.

컨트롤 조건 필드는 검색어, 기간 또는 둘 다일 수 있습니다. 일부 컨트롤 유형은 여러 조건 필드를 허용하거나 허용하지 않습니다.

사용 가능한 컨트롤 필드는 다음과 같습니다.

  • 검색어(Query terms): 검색 쿼리에 검색어가 표시되면 트리거됩니다.
    • 전체 일치를 위해서는 전체 검색 쿼리와 검색어가 일치해야 합니다.
    • 여러 검색어를 지정할 수 있습니다. 검색어 중 하나가 검색 쿼리에 표시되면 트리거됩니다.
  • 활성 시간 범위: 검색 쿼리 날짜가 시간 범위에 속할 때 트리거됩니다.
    • 여러 시간 범위를 지정할 수 있습니다. 쿼리 날짜가 시간 범위(포함) 내에 있는 경우 트리거됩니다.

지정한 조건 필드에 따라 컨트롤 적용 여부가 결정됩니다.

  • 여러 조건 필드는 AND를 사용하여 결합합니다. 즉, 시간 범위와 검색어를 모두 지정한 경우 두 조건 필드가 모두 트리거되어야 컨트롤이 적용됩니다.
  • 여러 조건의 하위 필드는 OR을 사용하여 결합됩니다. 즉, 검색어가 여러 개인 경우 검색어 하나가 일치하면 검색어가 트리거됩니다. 여러 기간이 있는 경우 하나의 시간 범위가 일치하면 시간 범위가 트리거됩니다.
  • 조건 필드 없음은 컨트롤이 항상 적용됨을 의미합니다. 그러나 일부 컨트롤에는 필드를 정의해야 합니다.

컨트롤 설정에 대한 자세한 내용은 Controls.condition API 참조를 확인하세요.

컨트롤 작업

컨트롤 작업은 검색 중에 조건이 충족되면 제공 컨트롤이 적용할 동작을 지정합니다.

지정할 수 있는 작업의 유형은 만드는 제공 컨트롤의 유형에 따라 다릅니다. 예를 들어 부스트/하강 컨트롤의 작업은 지정한 필터에 대한 제품에 부스트/하강 값을 적용하며, 단방향 동의어 컨트롤의 작업은 지정한 연결된 검색어를 적용합니다.

부스트/하강 컨트롤

부스트/하강 컨트롤을 사용하면 특정 검색결과를 더 높은 순위로 또는 더 낮은 순위로 표시할 수 있습니다.

검색 또는 추천에 대해 부스트/하강 컨트롤을 만들 수 있습니다. 추천의 부스트/하강은 공개 미리보기로 제공됩니다.

부스트/하강 컨트롤을 만들 때 필터 표현식을 사용하여 Product 필드를 기준으로 조건을 지정할 수 있습니다.

그러면 -1.0과 1.0 사이의 boost 값을 적용하여 해당 조건과 일치하는 제품 결과를 얼마나 올리거나 내릴지 나타낼 수 있습니다. 양수 값은 결과를 높이고 음수 값은 결과를 내립니다.

부스트 강도를 높게 설정하면 해당 항목에 대한 강력한 프로모션이 되겠지만, 부스트를 적용한 항목이 항상 최상위 결과가 되는 것은 아닙니다. 검색 쿼리와 관련성이 높은 검색결과는 여전히 선호도는 높지만 관련성 없는 항목보다 우선합니다. 마찬가지로 부스트 강도를 -1.0으로 설정하면 해당 항목의 순위가 크게 낮아지지만 관련성이 매우 높은 결과라면 계속 표시될 수 있습니다.

부스트/하강 사용의 예시로, 저렴한 제품의 우선순위를 높게 지정하고 비싼 제품의 우선순위를 낮게 지정할 수 있습니다.

검색과 추천 부스트/하강 컨트롤 간의 컨트롤 조건은 다릅니다.

  • 검색: 컨트롤 조건으로 검색어 및 적용 가능한 기간을 설정할 수 있습니다.
  • 추천: 컨트롤 조건을 사용할 수 없습니다. 컨트롤은 항상 적용됩니다.

컨트롤 작업으로 부스트 또는 하강할 제품의 필터를 지정하고 부스트/하강 값을 설정합니다.

부스트/하강 컨트롤을 만들려면 새 제공 컨트롤 만들기를 참조하세요.

부스트/하강 컨트롤 설정에 대한 자세한 내용은 Controls.BoostAction API 참조를 확인하세요.

필터 컨트롤

필터 컨트롤을 사용하면 특정 검색 요청을 기반으로 사전 정의된 필터를 동적으로 추가할 수 있습니다.

Product 필드를 기준으로 필터 표현식을 사용할 수 있습니다. 필터 표현식 구문은 필터 및 순서 결과를 참조하세요.

컨트롤 조건으로 검색어 및 적용 가능한 기간을 설정할 수 있습니다. 컨트롤 작업으로 쿼리 시 적용할 필터를 지정합니다.

예를 들어 '파란색 신발' 쿼리를 입력하면 필터 컨트롤을 사용하여 파란색으로 검색결과를 자동으로 필터링할 수 있습니다. 필터 컨트롤을 사용하여 특정 결과가 쇼핑객에게 반환되지 않도록 할 수도 있습니다.

필터 컨트롤을 만들려면 새 제공 컨트롤 만들기를 참조하세요.

무시 컨트롤 설정에 대한 자세한 내용은 Controls.FilterAction API 참조를 확인하세요.

리디렉션 컨트롤

리디렉션 컨트롤을 사용하여 검색결과만 표시하는 대신 쇼핑객의 인텐트에 따라 다른 페이지로 리디렉션할 수 있습니다.

컨트롤 조건으로 검색어 및 적용 가능한 기간을 설정할 수 있습니다. 컨트롤 작업으로는 조건이 일치하는 경우 리디렉션할 리디렉션 URI를 지정합니다.

예를 들어 'gShoe' 제품 프로모션 중에 '런닝화' 또는 '스포츠 신발'이 포함된 쿼리가 'gShoe' 제품 페이지로 리디렉션되도록 리디렉션 컨트롤을 만들 수 있습니다.

리디렉션 컨트롤을 만들려면 새 제공 컨트롤 만들기를 참조하세요.

리디렉션 컨트롤 설정에 대한 자세한 내용은 Controls.RedirectAction API 참조를 확인하세요.

링귀스틱 컨트롤

단어가 기본적으로 처리되는 방식을 추가하거나 새로운 방식으로 재정의할 수 있습니다.

예를 들어 판매자는 "런닝화"라는 용어가 포함된 쿼리를 "스포츠 신발"을 포함하도록 확장하여 검색결과에 두 키워드가 모두 포함되게 하고 싶을 수 있습니다. 링귀스틱 컨트롤을 사용하면 '런닝화'가 검색어로 입력되었을 때의 동의어 컨트롤을 생성할 수 있으며, 그 결과 해당 검색결과에는 '스포츠 신발'이 동의어로 포함되게 됩니다. 사이트의 쇼핑객이 '런닝화'를 쿼리로 입력하면 검색은 사용자가 생성한 링퀴스틱 컨트롤에서 일치하는 항목을 찾아 '스포츠 신발'을 포함하도록 검색을 확장하여 검색결과를 쇼핑객에게 반환합니다.

양방향 동의어 컨트롤

양방향 동의어 컨트롤을 사용하면 검색을 하는 동안 여러 검색어를 같은 용어로 취급하도록 검색어들을 연결할 수 있습니다.

컨트롤 조건으로 검색어 및 적용 가능한 기간을 설정할 수 있습니다. 별도의 컨트롤 작업을 설정할 필요는 없습니다. 지정한 용어가 검색어로 사용되는 경우 동의어로 지정한 다른 용어를 사용하는 것이 컨트롤 작업입니다.

예를 들어 '행주'와 '주방 타월'을 동의어로 연결하는 양방향 동의어 컨트롤을 설정할 수 있습니다. 사이트의 쇼핑객이 검색어로 '주방 타월'을 입력하면 검색은 검색어를 확장하여 '행주' 및 '주방 타월'의 결과를 포함할 수 있습니다.

동의어 컨트롤을 만들려면 새 서빙 컨트롤 만들기를 참조하세요.

동의어는 원래 검색어를 변경하지 않습니다. 예를 들어 양방향 동의어 'A<==>B'는 다음과 같은 영향을 미칩니다.

  • 검색어 'A'의 경우 반환된 결과는 결과 집합 A(동의어 규칙이 적용되지 않은 경우) + 결과 집합 B의 일부여야 하지만 결과 집합 A + 결과 집합 B의 합보다 적을 수 있습니다.

  • 검색어 'B'의 경우 반환된 결과는 결과 집합 B + 결과 집합 A의 일부여야 하지만 결과 집합 A + 결과 집합 B보다 적을 수 있습니다.

양방향 동의어 컨트롤 설정에 대한 자세한 내용은 Controls.TwowaySynonymsAction API 참조를 확인하세요.

단방향 동의어 컨트롤

단방향 동의어는 링크 용어를 단방향으로 함께 컨트롤합니다.

컨트롤 조건으로 검색어 및 적용 가능한 기간을 설정할 수 있습니다. 컨트롤 작업으로는 단방향 동의어로 사용할 용어를 지정합니다.

예를 들어 "장미"라는 검색어에 "분홍색"이 포함되도록 검색을 확장하는 단방향 동의어 컨트롤을 설정할 수 있습니다. 단방향 동의어이므로 "분홍색"이라는 검색어는 "장미"라는 용어로 확장되지 않습니다.

단방향 동의어 컨트롤을 만들려면 새 제공 컨트롤 만들기를 참조하세요.

양방향 동의어와 마찬가지로 원래 검색어가 실행되고 동의어가 검색어 쿼리에 대한 힌트로 제공됩니다. 완전히 다른 단어의 동의어로 인해 결과에 포함되는 동의어 용어 수가 적을 수 있습니다. 예를 들어 'dog=>cat' 동의어 규칙은 계속 대부분의 개와 일부 고양이를 반환하지만 'rose=>pink' 예시는 분홍색 장미를 강조하여 분홍색 항목을 반환해야 합니다.

단방향 동의어 컨트롤 설정에 대한 자세한 내용은 Controls.OnewaySynonymsAction API 참조를 확인하세요.

무시 컨트롤

무시 컨트롤을 사용하면 검색을 하는 동안 특정 검색어를 사용하지 못합니다.

무시 컨트롤은 부정 연산자가 아닙니다. 소매업용 Vertex AI Search에서 해당 검색어에 대한 결과를 제공하지 않는다고 보장하지 않습니다. 이를 완전히 방지하려면 필터 컨트롤을 사용하세요. 단일 단어 검색어에 적용된 무시 컨트롤에서 계속 결과를 반환할 수 있습니다. 일부 제품과 일치하는 Google 정의 동의어 또는 검색어 확장이 있을 수 있기 때문입니다.

예를 들어 '오일'이라는 단어에 대한 무시 컨트롤은 '유화 물감' 검색어에 유화 물감을 계속 반환합니다. 검색어는 '물감'으로 전달되며 일치하는 유화 물감이 많을 수 있지만 검색어가 '물감'이므로 결과 집합이 더 커집니다. '유화 물감'이 사이트에서 인기 있는 검색어이고 다양한 유형의 물감을 판매하지만 유성 페인트는 많지 않은 경우에 이 유형의 컨트롤이 유용할 수 있습니다.

무시 컨트롤이 검색에서 해당 검색어의 어떤 결과도 제공하지 않는다는 보장은 없습니다. 이를 완전히 방지하려면 필터 컨트롤을 사용하세요.

컨트롤 조건으로 검색어 및 적용 가능한 기간을 설정할 수 있습니다. 별도의 컨트롤 작업을 설정할 필요는 없습니다. 지정한 용어가 쿼리로 사용되는 경우 해당 용어를 무시하는 것이 컨트롤 작업입니다.

예를 들어 불쾌감을 주는 언어를 사용하는 검색어를 무시하는 컨트롤을 만들 수 있습니다.

무시 컨트롤을 만들려면 새 제공 컨트롤 만들기를 참조하세요.

무시 컨트롤 설정에 대한 자세한 내용은 Controls.IgnoreAction API 참조를 확인하세요.

연관 금지 컨트롤

"연관 금지" 컨트롤을 사용하면 지정한 검색어들을 사용해 검색할 때 해당 검색어들이 함께 쿼리되는 것을 방지할 수 있습니다.

컨트롤 조건으로 검색어 및 적용 가능한 기간을 설정할 수 있습니다. 컨트롤 작업으로는 검색어와 연결해서는 안되는 용어를 지정하세요.

예를 들어 브랜드 이름(예: 'gShoe')이 쿼리에서 '저렴한' 또는 '저품질'과 함께 그룹화되지 않도록 방지하는 컨트롤을 만들면, 쇼핑객이 '저품질의 저렴한 gShoe'를 검색하였을 때 검색에서 'gShoe'에 대한 검색만 수행하게 할 수 있습니다.

만일 검색어에 대한 관련성 있는 결과에 '연관 금지'로 지정된 검색어가 포함된 경우, 해당 관련성 있는 결과는 여전히 반환될 수 있습니다. 이를 완전히 방지하려면 필터 컨트롤을 사용하세요.

연관 금지 컨트롤을 만들려면 새 제공 컨트롤 만들기를 참조하세요.

연관 금지 컨트롤 설정에 대한 자세한 내용은 Controls.DoNotAssociateAction API 참조를 확인하세요.

교체 컨트롤

교체 컨트롤은 하나 이상의 지정된 검색어를 지정한 다른 용어로 바꿉니다. 여러 용어를 하나의 용어로 매핑하도록 지정할 수 있지만 그 반대의 경우는 불가능합니다.

컨트롤 조건으로 검색어 및 적용 가능한 기간을 설정할 수 있습니다. 컨트롤 작업으로는 교체할 용어를 지정합니다.

예를 들어 제품의 닉네임을 제품 설명에 더 일반적으로 사용되는 전체 브랜드 이름으로 교체하는 컨트롤을 만들 수 있습니다.

Search for Retail 콘솔에서 대체 컨트롤을 만들려면 새 서빙 컨트롤 만들기를 참조하세요.

대체 컨트롤 설정에 대한 자세한 내용은 Controls.ReplacementAction API 참조를 확인하세요.