이 문서는 Recommendations AI, Retail Search, 새로운 Retail 콘솔에 대한 문서입니다.

컨트롤 만들기 및 관리

이 페이지에서는 컨트롤을 추가, 보기, 수정, 삭제하는 방법을 설명합니다.

  • 제공 컨트롤은 개별 Retail Search 제공 구성에 대해 정의하고 적용하는 규칙입니다. 제공 구성에 대한 자세한 내용은 제공 구성을 참조하세요.
  • 사이트 전체 컨트롤은 모든 Retail Search 결과에 적용됩니다.

제공 컨트롤

제공 컨트롤을 사용하면 제공 구성이 검색 결과를 제공하는 방식을 맞춤설정하는 규칙을 만들 수 있습니다.

Cloud Console에서 컨트롤을 트리거하는 조건과 조건이 트리거될 때 수행되는 작업으로 구성된 제공 컨트롤을 만들 수 있습니다. 그런 다음 생성한 Retail Search 제공 구성에 새 제공 컨트롤을 연결할 수 있습니다.

Retail Search 제공 구성은 컨트롤과 다대다 관계를 가집니다. 제공 구성에 여러 컨트롤을 추가할 수 있고 단일 컨트롤을 여러 제공 구성과 연결할 수 있습니다.

제공 구성은 적용 가능한 제어를 관리합니다. 제공 시 요청의 활성 제공 구성에 대한 컨트롤만 고려됩니다.

컨트롤을 만든 후 실시간 Retail Search 제공 구성으로 추가하거나 전환할 수 있습니다.

Controls.create 메서드를 사용하여 컨트롤 페이지 또는 인라인에서 언제든지 제공 컨트롤을 만들거나 수정할 수 있습니다. 콘솔에서 제공 구성 생성 프로세스 중에 선택적으로 제어를 만들 수 있습니다.

제공 컨트롤은 최대 1,000개까지 만들 수 있습니다. 제공 구성은 리디렉션 컨트롤 외에 모든 유형의 제공 컨트롤을 최대 100개까지 포함할 수 있으며, 이 경우 제공 구성당 한도는 1,000개입니다.

제공 컨트롤을 사용할 수 있는 항목은 다음과 같습니다.

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

이러한 컨트롤의 예시는 제공 컨트롤을 참조하세요.

리디렉션 제어 튜토리얼

이 튜토리얼에서는 리디렉션 제어를 사용하는 방법을 보여줍니다.


Cloud Shell 편집기에서 직접 이 태스크를 수행하는 방법에 대한 단계별 안내를 보려면 둘러보기를 클릭하세요.

둘러보기


다음 섹션에서는 둘러보기를 클릭할 때와 동일한 단계를 수행합니다.

새 제공 컨트롤 만들기

Google Cloud Console의 컨트롤 페이지 또는 Controls.create 메서드를 사용하여 인라인에서 새 제공 컨트롤을 만듭니다.

컨트롤은 유형에 따라 요구사항이 다릅니다. 만들려는 컨트롤 유형의 생성 절차로 이동합니다.

부스트/하강 컨트롤 만들기

이 컨트롤 유형에 관한 상세 설명은 부스트/하강 컨트롤을 참조하세요.

Console

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 제공 컨트롤 탭에서 컨트롤 만들기를 클릭합니다.

    컨트롤 만들기 창이 열립니다.

환경설정 섹션에서 다음을 수행합니다.

  1. 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

  2. (선택사항) 자동으로 생성된 제어 ID를 변경하려면 제어 이름 필드 아래에서 수정을 클릭하고 새 제어 ID를 입력합니다.

  3. 컨트롤 유형으로 부스팅/하강 컨트롤을 선택합니다.

  4. 계속을 클릭하여 트리거 섹션으로 이동하세요.

트리거 섹션에서 다음을 수행합니다.

  1. (선택사항) 쿼리 추가 버튼을 클릭하여 부스트 또는 하강된 검색어(예: running shoes)를 추가하고 각 검색어에 대해 다음 중 하나를 선택합니다.

    • 부분 일치: 이 컨트롤은 쿼리가 이 쿼리 검색어와 부분적으로 일치하는 경우에 적용됩니다.
    • 전체 일치: 이 컨트롤은 쿼리가 이 쿼리 검색어와 전체적으로 일치하는 경우에만 적용됩니다.

      이러한 용어 중 하나가 쿼리에 포함된 경우 컨트롤이 적용됩니다.

    이 조건 외에도 기간 조건을 지정하면 두 조건이 모두 충족되는 경우에만 컨트롤이 적용됩니다.

  2. (선택사항) 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

    이 기간 조건 외에 검색어 조건을 지정하면 두 조건이 모두 충족되는 경우에만 컨트롤이 적용됩니다.

  3. 계속을 클릭하여 작업 섹션으로 이동합니다.

작업 섹션에서 다음을 수행합니다.

  1. 부스트/하강 제품 필드에 제품 속성의 필터를 추가합니다.

    필터링 및 순서 지정에 문서화된 필터 표현식 구문을 사용합니다.

    예를 들어 'product1' 및 'product2'의 빨간색 버전과 파란색 버전((id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue")))을 지정하려면 다음 안내를 따르세요.

  2. 부스트/하강 값에서 슬라이더를 사용하여 부스트 강도를 설정합니다. 양수를 사용하면 결과가 상향 조정되고 음수를 사용하면 아래로 내려갑니다.

  3. 계속을 클릭하여 제공 구성 섹션으로 이동합니다.

구성 제공 섹션에서 다음을 수행합니다.

  1. 컨트롤을 적용할 제공 구성을 선택합니다.

  2. 컨트롤 설정을 제출합니다.

    새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

curl

요청 본문에 포함된 제어 ID와 Control의 인스턴스를 사용하여 Control.create 요청을 실행합니다.

필드 세부정보는 Controls API 참조Controls.create API 참조를 확인하세요.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용합니다. [제공 구성에 인라인으로 컨트롤 추가][addcontrol-inline]를 참조하세요.

필터 컨트롤 만들기

이 컨트롤 유형에 대한 상세 설명은 필터 컨트롤을 참조하세요.

Console

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 제공 컨트롤 탭에서 컨트롤 만들기를 클릭합니다.

    컨트롤 만들기 창이 열립니다.

환경설정 섹션에서 다음을 수행합니다.

  1. 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

  2. (선택사항) 자동으로 생성된 제어 ID를 변경하려면 제어 이름 필드 아래에서 수정을 클릭하고 새 제어 ID를 입력합니다.

  3. 컨트롤 유형으로 필터 컨트롤을 선택합니다.

  4. 계속을 클릭하여 트리거 섹션으로 이동하세요.

트리거 섹션에서 다음을 수행합니다.

  1. (선택사항) 쿼리 추가 버튼을 클릭하여 필터링할 검색어(예: running shoes)를 추가하고 각 검색어에 대해 다음 중 하나를 선택합니다.

    • 부분 일치: 이 컨트롤은 쿼리가 이 쿼리 검색어와 부분적으로 일치하는 경우에 적용됩니다.
    • 전체 일치: 이 컨트롤은 쿼리가 이 쿼리 검색어와 전체적으로 일치하는 경우에만 적용됩니다.

    이러한 용어 중 하나가 쿼리에 포함된 경우 컨트롤이 적용됩니다.

    이 조건 외에도 기간 조건을 지정하면 두 조건이 모두 충족되는 경우에만 컨트롤이 적용됩니다.

  2. (선택사항) 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

    이 기간 조건 외에 검색어 조건을 지정하면 두 조건이 모두 충족되는 경우에만 컨트롤이 적용됩니다.

  3. 계속을 클릭하여 작업 섹션으로 이동합니다.

작업 섹션에서 다음을 수행합니다.

  1. 필터 작업 필드에 제품 속성의 필터를 추가합니다.

    필터링 및 순서 지정에 문서화된 필터 표현식 구문을 사용합니다.

    예를 들어 'product1' 및 'product2'의 빨간색 버전과 파란색 버전((id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue")))을 지정하려면 다음 안내를 따르세요.

  2. 계속을 클릭하여 제공 구성 섹션으로 이동합니다.

구성 제공 섹션에서 다음을 수행합니다.

  1. 컨트롤을 적용할 제공 구성을 선택합니다.

  2. 컨트롤 설정을 제출합니다.

    새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

curl

요청 본문에 포함된 제어 ID와 Control의 인스턴스를 사용하여 Control.create 요청을 실행합니다.

필드 세부정보는 Controls API 참조Controls.create API 참조를 확인하세요.

이 예시에서는 다음에 대한 필드를 보여줍니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용합니다. [제공 구성에 인라인으로 컨트롤 추가][addcontrol-inline]를 참조하세요.

리디렉션 컨트롤 만들기

이 컨트롤 유형에 대한 상세 설명은 리디렉션 컨트롤을 참조하세요.

Console

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 제공 컨트롤 탭에서 컨트롤 만들기를 클릭합니다.

    컨트롤 만들기 창이 열립니다.

환경설정 섹션에서 다음을 수행합니다.

  1. 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

  2. (선택사항) 자동으로 생성된 제어 ID를 변경하려면 제어 이름 필드 아래에서 수정을 클릭하고 새 제어 ID를 입력합니다.

  3. 컨트롤 유형으로 리디렉션 컨트롤을 선택합니다.

  4. 계속을 클릭하여 트리거 섹션으로 이동하세요.

트리거 섹션에서 검색어 또는 기간 트리거를 하나 이상 만듭니다. 리디렉션 컨트롤에는 트리거가 하나 이상 필요합니다.

  1. 쿼리 추가 버튼을 클릭하여 필터링할 검색어(예: running shoes)를 추가하고 각 검색어에 대해 다음 중 하나를 선택합니다.

    • 부분 일치: 이 컨트롤은 쿼리가 이 쿼리 검색어와 부분적으로 일치하는 경우에 적용됩니다.
    • 전체 일치: 이 컨트롤은 쿼리가 이 쿼리 검색어와 전체적으로 일치하는 경우에만 적용됩니다.

    이러한 용어 중 하나가 쿼리에 포함된 경우 컨트롤이 적용됩니다.

    이 조건 외에도 기간 조건을 지정하면 두 조건이 모두 충족되는 경우에만 컨트롤이 적용됩니다.

  2. 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

    이 기간 조건 외에 검색어 조건을 지정하면 두 조건이 모두 충족되는 경우에만 컨트롤이 적용됩니다.

  3. 계속을 클릭하여 작업 섹션으로 이동합니다.

작업 섹션에서 다음을 수행합니다.

  1. 이 컨트롤이 트리거될 때 리디렉션할 URI를 입력합니다.

  2. 계속을 클릭하여 제공 구성 섹션으로 이동합니다.

구성 제공 섹션에서 다음을 수행합니다.

  1. 컨트롤을 적용할 제공 구성을 선택합니다.

  2. 컨트롤 설정을 제출합니다.

    새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

curl

요청 본문에 포함된 제어 ID와 Control의 인스턴스를 사용하여 Control.create 요청을 실행합니다.

필드 세부정보는 Controls API 참조Controls.create API 참조를 확인하세요.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": REDIRECT_URI,
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용합니다. [제공 구성에 인라인으로 컨트롤 추가][addcontrol-inline]를 참조하세요.

양방향 동의어 컨트롤 만들기

이 컨트롤 유형에 대한 상세 설명은 양방향 동의어 컨트롤을 참조하세요.

Console

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 제공 컨트롤 탭에서 컨트롤 만들기를 클릭합니다.

  3. 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

    컨트롤 만들기 창이 열립니다.

환경설정 섹션에서 다음을 수행합니다.

  1. (선택사항) 자동으로 생성된 제어 ID를 변경하려면 제어 이름 필드 아래에서 수정을 클릭하고 새 제어 ID를 입력합니다.

  2. 컨트롤 유형으로 양방향 동의어 컨트롤을 선택합니다.

  3. 계속을 클릭하여 트리거 섹션으로 이동하세요.

트리거 섹션에서 다음을 수행합니다.

  1. (선택사항) 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

  2. 계속을 클릭하여 작업 섹션으로 이동합니다.

작업 섹션에서 다음을 수행합니다.

  1. 동의어 필드에 서로 동의어로 사용할 2~100개의 검색어(예: shirttop)를 입력합니다.

    이러한 검색어 중 하나라도 쿼리에 포함되어 있으면 다른 검색어가 포함된 검색어의 동의어로 간주됩니다.

  2. 계속을 클릭하여 제공 구성 섹션으로 이동합니다.

구성 제공 섹션에서 다음을 수행합니다.

  1. 컨트롤을 적용할 제공 구성을 선택합니다.

  2. 컨트롤 설정을 제출합니다.

    새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

curl

요청 본문에 포함된 제어 ID와 Control의 인스턴스를 사용하여 Control.create 요청을 실행합니다.

필드 세부정보는 Controls API 참조Controls.create API 참조를 확인하세요.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용합니다. [제공 구성에 인라인으로 컨트롤 추가][addcontrol-inline]를 참조하세요.

단방향 동의어 컨트롤 만들기

이 컨트롤 유형에 대한 상세 설명은 단방향 동의어 컨트롤을 참조하세요.

Console

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 제공 컨트롤 탭에서 컨트롤 만들기를 클릭합니다.

    컨트롤 만들기 창이 열립니다.

환경설정 섹션에서 다음을 수행합니다.

  1. 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

  2. (선택사항) 자동으로 생성된 제어 ID를 변경하려면 제어 이름 필드 아래에서 수정을 클릭하고 새 제어 ID를 입력합니다.

  3. 제어 유형으로 단방향 동의어 컨트롤을 선택합니다.

  4. 계속을 클릭하여 트리거 섹션으로 이동하세요.

트리거 섹션에서 다음을 수행합니다.

  1. (선택사항) 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

  2. 계속을 클릭하여 작업 섹션으로 이동합니다.

작업 섹션에서 다음을 수행합니다.

  1. 검색어 필드에 동의어가 쿼리에 포함될 때 동의어가 연관되어야 할 검색어(예: shoes)를 입력합니다.

  2. 동의어 필드에 지정한 검색어의 동의어로 사용할 검색어를 입력합니다(예: sneakerssandals를 검색어 shoes의 단방향 동의어로 사용).

  3. 계속을 클릭하여 제공 구성 섹션으로 이동합니다.

구성 제공 섹션에서 다음을 수행합니다.

  1. 컨트롤을 적용할 제공 구성을 선택합니다.

  2. 컨트롤 설정을 제출합니다.

    새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

curl

요청 본문에 포함된 제어 ID와 Control의 인스턴스를 사용하여 Control.create 요청을 실행합니다.

필드 세부정보는 Controls API 참조Controls.create API 참조를 확인하세요.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용합니다. [제공 구성에 인라인으로 컨트롤 추가][addcontrol-inline]를 참조하세요.

연관 금지 컨트롤 만들기

이 컨트롤 유형에 대한 상세 설명은 연관 금지 컨트롤을 참조하세요.

Console

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 제공 컨트롤 탭에서 컨트롤 만들기를 클릭합니다.

    컨트롤 만들기 창이 열립니다.

환경설정 섹션에서 다음을 수행합니다.

  1. 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

  2. (선택사항) 자동으로 생성된 제어 ID를 변경하려면 제어 이름 필드 아래에서 수정을 클릭하고 새 제어 ID를 입력합니다.

  3. 컨트롤 유형으로 컨트롤을 연관하지 않음을 선택합니다.

  4. 계속을 클릭하여 트리거 섹션으로 이동하세요.

트리거 섹션에서 다음을 수행합니다.

  1. (선택사항) 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

  2. 계속을 클릭하여 작업 섹션으로 이동합니다.

작업 섹션에서 다음을 수행합니다.

  1. 검색어 필드에 명시적으로 다른 쿼리와 구별할 검색어(예: gShoe)를 입력합니다.

  2. 연관되지 않은 검색어 검색 결과와 연관되어서는 안 되는 검색어와 필드에 지정한 검색어를 입력합니다.

    예를 들어 검색어 cheap와 검색어 gShoe를 연결 해제할 수 있습니다.

  3. 계속을 클릭하여 제공 구성 섹션으로 이동합니다.

구성 제공 섹션에서 다음을 수행합니다.

  1. 컨트롤을 적용할 제공 구성을 선택합니다.

  2. 컨트롤 설정을 제출합니다.

    새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

curl

요청 본문에 포함된 제어 ID와 Control의 인스턴스를 사용하여 Control.create 요청을 실행합니다.

필드 세부정보는 Controls API 참조Controls.create API 참조를 확인하세요.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용합니다. [제공 구성에 인라인으로 컨트롤 추가][addcontrol-inline]를 참조하세요.

무시 컨트롤 만들기

이 컨트롤 유형에 대한 상세 설명은 무시 컨트롤을 참조하세요.

Console

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 제공 컨트롤 탭에서 컨트롤 만들기를 클릭합니다.

    컨트롤 만들기 창이 열립니다.

환경설정 섹션에서 다음을 수행합니다.

  1. 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

  2. (선택사항) 자동으로 생성된 제어 ID를 변경하려면 제어 이름 필드 아래에서 수정을 클릭하고 새 제어 ID를 입력합니다.

  3. 컨트롤 유형으로 컨트롤을 연관하지 않음을 선택합니다.

  4. 계속을 클릭하여 트리거 섹션으로 이동하세요.

트리거 섹션에서 다음을 수행합니다.

  1. (선택사항) 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

  2. 계속을 클릭하여 작업 섹션으로 이동합니다.

작업 섹션에서 다음을 수행합니다.

  1. 검색어 무시 필드에 검색어가 입력될 때 검색에서 무시할 검색어를 입력합니다(예: shoddy).

  2. 계속을 클릭하여 제공 구성 섹션으로 이동합니다.

구성 제공 섹션에서 다음을 수행합니다.

  1. 컨트롤을 적용할 제공 구성을 선택합니다.

  2. 컨트롤 설정을 제출합니다.

    새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

curl

요청 본문에 포함된 제어 ID와 Control의 인스턴스를 사용하여 Control.create 요청을 실행합니다.

필드 세부정보는 Controls API 참조Controls.create API 참조를 확인하세요.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용합니다. [제공 구성에 인라인으로 컨트롤 추가][addcontrol-inline]를 참조하세요.

대체 컨트롤 만들기

이 컨트롤 유형에 대한 상세 설명은 대체 컨트롤을 참조하세요.

Console

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 제공 컨트롤 탭에서 컨트롤 만들기를 클릭합니다.

    컨트롤 만들기 창이 열립니다.

환경설정 섹션에서 다음을 수행합니다.

  1. 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

  2. (선택사항) 자동으로 생성된 제어 ID를 변경하려면 제어 이름 필드 아래에서 수정을 클릭하고 새 제어 ID를 입력합니다.

  3. 대체 컨트롤을 제어 유형으로 선택합니다.

  4. 계속을 클릭하여 트리거 섹션으로 이동하세요.

트리거 섹션에서 다음을 수행합니다.

  1. (선택사항) 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

  2. 계속을 클릭하여 작업 섹션으로 이동합니다.

작업 섹션에서 다음을 수행합니다.

  1. 검색어 필드에 대체 검색어로 대체할 검색어(예: gShoe)를 입력합니다.

  2. 대체 용어 필드에 지정한 검색어를 대체할 검색어를 입력합니다.

    예를 들어 검색어 gShoe를 대체 검색어 Google Shoe로 바꿀 수 있습니다.

  3. 계속을 클릭하여 제공 구성 섹션으로 이동합니다.

구성 제공 섹션에서 다음을 수행합니다.

  1. 컨트롤을 적용할 제공 구성을 선택합니다.

  2. 컨트롤 설정을 제출합니다.

    새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

curl

요청 본문에 포함된 제어 ID와 Control의 인스턴스를 사용하여 Control.create 요청을 실행합니다.

필드 세부정보는 Controls API 참조Controls.create API 참조를 확인하세요.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용합니다. [제공 구성에 인라인으로 컨트롤 추가][addcontrol-inline]를 참조하세요.

컨트롤 페이지의 제공 컨트롤 탭에 새 컨트롤이 나열됩니다.

제공 컨트롤 보기 및 수정

Retail 콘솔 또는 Retail API를 사용하여 제공 제어를 볼 수 있습니다.

Console에서 제공 컨트롤 보기 및 수정

컨트롤 페이지의 제공 컨트롤에 모든 제공 컨트롤과 관련 제공 구성이 나열됩니다. 컨트롤의 컨트롤 수정 아이콘을 클릭하여 컨트롤 수정 패널에서 설정 및 관련 제공 구성을 변경합니다. 컨트롤의 컨트롤 삭제 아이콘을 클릭하여 삭제합니다. 그러면 모든 제공 구성에서도 삭제됩니다.

또한 구성 제공 페이지에서 특정 제공 구성의 컨트롤을 확인하고 수정할 수 있습니다. 제공 구성을 클릭하여 해당 구성에 대한 모든 제공 컨트롤을 나열하는 세부정보 페이지를 봅니다. 컨트롤 수정 패널에서 설정을 변경하려면 컨트롤의 컨트롤 수정 아이콘을 클릭합니다. 컨트롤 삭제 아이콘을 클릭하여 제공 구성에서 컨트롤을 연결 해제합니다(컨트롤은 삭제되지 않음).

새로 생성되거나 업데이트된 컨트롤이 실시간 트래픽을 처리할 준비가 될 때까지 몇 분 정도 걸립니다. 콘솔 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다.

제공 컨트롤을 인라인으로 보기

단일 제공 컨트롤을 인라인으로 보려면 Control.get을 사용합니다.

이 메서드에 대한 자세한 내용은 Control.get API 참조를 확인하세요.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID'

여러 제공 컨트롤을 인라인으로 나열하려면 Controls.list를 사용합니다.

필요한 경우 pageSize 매개변수를 사용하여 반환할 최대 결과 수를 설정할 수 있습니다. 더 많은 결과를 사용할 수 있는 경우 list 응답에 페이지 토큰이 포함됩니다. list 요청의 pageToken 매개변수에 페이지 토큰을 전달하여 결과의 다음 페이지를 검색할 수 있습니다.

특정 제공 구성과 관련된 컨트롤만 나열하려면 filter 쿼리 매개변수를 사용하여 제공 구성 ID를 지정합니다.

이 메서드에 대한 자세한 내용은 Control.list API 참조를 확인하세요.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

제공 컨트롤을 인라인으로 패치

제공 컨트롤의 필드를 업데이트하려면 Controls.patch를 사용하고 요청 본문에 Control 인스턴스를 포함합니다. updateMask 매개변수로 업데이트하도록 필드를 지정하거나 지원되는 모든 필드를 업데이트하도록 필드를 설정하지 않습니다.

이 메서드에 대한 자세한 내용은 Controls.patch API 참조를 확인하세요.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

제공 구성에 인라인으로 컨트롤 추가

제공 구성에 컨트롤을 추가하려면 ServingConfig.addControl을 사용합니다.

이 메서드에 대한 자세한 내용은 ServingConfig.addControl API 참조를 확인하세요.

제공 구성 관리 주제에서 이 메서드의 예시를 참조하세요.

제공 구성에서 인라인으로 컨트롤 삭제

제공 구성에서 컨트롤을 삭제하려면 ServingConfig.removeControl을 사용합니다.

이 메서드에 대한 자세한 내용은 ServingConfig.addControl API 참조를 확인하세요.

제공 구성 관리 주제에서 이 메서드의 예시를 참조하세요.

제공 컨트롤 삭제

Controls.delete 메서드를 사용하여 콘솔 또는 인라인에서 제공 제어를 삭제할 수 있습니다.

Console에서 제공 컨트롤 삭제

제공 컨트롤을 삭제하여 사용 중인 모든 제공 구성에서 컨트롤을 삭제합니다.

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 삭제할 컨트롤의 테이블 행에서 삭제를 클릭합니다.

  3. 확인 창에서 삭제를 클릭하여 삭제를 완료합니다.

제공 컨트롤을 인라인으로 삭제

제공 컨트롤을 인라인으로 삭제하려면 Controls.delete를 사용합니다.

이 메서드에 대한 자세한 내용은 Controls.delete API 참조를 확인하세요.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/SERVING_CONTROL_ID'

사이트 전체 컨트롤

사이트 전체 컨트롤을 사용하면 모든 제공 구성에서 전역 설정을 관리할 수 있습니다.

속성 컨트롤

Cloud Console에서 카탈로그의 제품 속성에 사이트 전체 속성 컨트롤을 사용할 수 있습니다.

사용 가능한 사이트 전체 속성 컨트롤은 다음과 같습니다.

  • 색인 생성 가능: Retail Search는 이 속성을 사용하여 필터링하고 패싯을 생성할 수 있습니다.
  • 동적 패싯 생성: Retail Search는 패싯 클릭 및 조회 등의 과거 사용자 동작을 기반으로 이 속성을 동적 패싯으로 자동으로 사용할 수 있습니다. 속성에 동적 패싯 생성을 사용 설정하려면 해당 속성에 대해 색인 생성 가능을 true로 설정해야 합니다.
  • 검색 가능: 이 속성은 Retail Search 쿼리로 검색 가능하며 해당 속성에 대한 재현율을 높입니다. 이 컨트롤은 텍스트 속성에만 적용됩니다.

개별 속성에 대해 사이트 전체 속성 컨트롤을 사용 설정 또는 중지할 수 있습니다.

동적 패싯 생성은 사이트 전체 속성 제어로 사용할 수 있습니다. 기본적으로 동적 패싯 생성은 모든 커스텀 속성에 사용 설정됩니다.

카탈로그 수준 구성 모드에서 사이트 전체 속성 제어를 색인 생성 가능 및 검색 가능으로 설정할 수 있습니다.

속성 구성, 기본 설정, 허용되는 설정에 대한 자세한 내용은 속성 구성 주제를 참조하세요.

사이트 전체 속성 컨트롤 설정

Google Cloud Console의 컨트롤 페이지에서 사이트 전체 속성 컨트롤을 설정합니다.

기본 카탈로그 수준 구성 모드에서는 사이트 전체 속성 제어를 전역으로 설정할 수 있습니다. 이전에는 제품 수준 구성이 기본 모드였습니다. 아직 제품 수준 구성 모드를 사용 중이고 모드를 전환해야 하는 경우 Retail 지원팀에 문의하세요.

  1. Google Cloud Console의 Retail 컨트롤 페이지로 이동합니다.

    컨트롤 페이지로 이동

  2. 사이트 전체 컨트롤 탭으로 이동합니다.

    이 탭에는 사이트 전체 컨트롤을 설정할 수 있는 모든 제품 속성이 표 형식으로 표시됩니다.

  3. 컨트롤 수정을 클릭합니다.

  4. 컨트롤을 사용 설정 또는 사용 중지합니다.

    • True: 해당 속성의 컨트롤을 사용 설정합니다. 이렇게 하면 Retail API의 제품 수준 속성 구성이 재정의됩니다.
    • False: 해당 속성의 컨트롤을 사용 중지합니다. 이렇게 하면 Retail API의 제품 수준 속성 구성이 재정의됩니다.

      색인 생성 가능으로도 설정된 속성에 대해서만 동적 패싯 생성을 true로 설정할 수 있습니다.

  5. 컨트롤 저장을 클릭합니다.

    색인 생성 및 검색이 가능한 속성 구성 설정에 대한 변경사항은 12시간 이내 또는 다음 카탈로그 수집 즉시 적용됩니다. 동적 패싯 생성 구성이 변경되는 데 최대 2일이 걸립니다. 평가 페이지에서 변경사항이 적용되었는지 테스트할 수 있습니다. 평가 페이지에는 변경사항이 즉시 반영됩니다.