서빙 컨트롤 만들기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 제품을 선택한 다음 컨트롤 유형 부스팅/하강을 선택합니다.

5. 부스트/하강 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어에 기준(예: contains 또는 not in range)을 지정하여 이 제어를 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 이 컨트롤로 트리거할 부스트/하강 작업을 정의합니다. 이러한 작업은 색상과 같은 카탈로그 속성, 포함과 같은 기준,빨간색과 같은 값으로 정의됩니다.

   4. add_box속성 추가를 클릭하여 속성을 추가합니다.

6. 슬라이더를 사용하여 부스트/하강 값을 설정합니다. 음수는 숨기고 양수는 부스트합니다.

7. 제출을 클릭하여 승인자에게 제어 요청을 제출합니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

5. 제품 선택 섹션에서 검색을 선택합니다.

6. 컨트롤 유형으로 부스팅/하강 컨트롤을 선택합니다. 계속을 클릭합니다.

7. 트리거 섹션에서 이 컨트롤을 트리거하는 사용자 동작 유형을 선택합니다.

   • 카테고리 찾아보기: 이 규칙은 사용자가 사이트에서 카테고리를 탐색할 때 트리거됩니다(search.request.query가 비어 있음).

   • 검색: 이 규칙은 사용자가 사이트를 검색할 때 트리거됩니다(search.request.query가 비어있지 않음). 카테고리를 탐색하거나 쿼리를 검색할 때 이 컨트롤을 트리거하도록 설정하려면 다음 단계를 건너뜁니다.

8. 선택사항: 특정 카테고리를 탐색하거나 특정 쿼리를 검색하는지에 따라 이 컨트롤을 트리거할 수 있는 특정 카테고리 또는 쿼리를 설정합니다.

   • 카테고리 찾아보기를 선택한 경우: 카테고리 필드에서 탐색할 때 이 컨트롤을 트리거할 카테고리를 입력합니다.

   • 검색을 선택한 경우 쿼리 추가 버튼을 클릭하여 필터링할 쿼리 검색어 (예: running shoes)를 추가합니다. 각 검색어에 대해 부분 일치 또는 전체 일치를 선택합니다.

9. 선택사항: 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 시간 범위를 하나 이상 추가합니다.

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

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

    필터링 및 순서 지정에 설명된 필터 표현식 문법을 사용합니다. 예를 들어 'product1' 및 'product2'의 빨간색 버전과 파란색 버전((id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue")))을 지정하려면 다음 안내를 따르세요.

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

13. 서빙 구성 섹션에서 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

이제 컨트롤 페이지의 서빙 컨트롤 탭에 새 컨트롤이 표시됩니다.

curl

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

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

사용자가 사이트에서 카테고리를 탐색하거나(search.request.query가 비어 있음) 사용자가 사이트를 검색하는 경우(search.request.query가 비어있지 않음) 부스트/하강 컨트롤이 트리거될 수 있습니다.

다음 예시에서는 browse-triggered 컨트롤의 필드를 보여줍니다. 여기서 searchSolutionUseCase는 SEARCH_SOLUTION_USE_CASE_BROWSE로 설정됩니다.

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" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "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"

다음 예시에서는 search-triggered 컨트롤의 필드를 보여줍니다. 여기서 searchSolutionUseCase는 SEARCH_SOLUTION_USE_CASE_SEARCH로 설정됩니다.

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" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_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 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 탐색 제품을 선택한 다음 컨트롤 유형 부스트/하강을 선택합니다.

5. 부스트/하강 컨트롤을 구성합니다.

   1. 트리거에서 컨트롤을 트리거할 페이지 카테고리를 입력합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤은 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 이 컨트롤로 트리거할 부스트/하강 작업을 정의합니다. 이러한 작업은 색상과 같은 카탈로그 속성, 포함과 같은 기준,빨간색과 같은 값으로 정의됩니다.

   4. add_box속성 추가를 클릭하여 속성을 추가합니다.

6. 슬라이더를 사용하여 부스트/하강 값을 설정합니다. 음수는 묻기, 양수는 부스트입니다.

7. 제출을 클릭하여 승인자에게 제어 요청을 제출합니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. (선택사항) 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

5. 제품 선택 섹션에서 추천을 선택합니다.

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

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

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

   추천 필터링에 설명된 필터 표현식 문법을 사용합니다.

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

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

10. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다.

11. 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

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

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_RECOMMENDATION" ],
                "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 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 또는 탐색 제품을 선택한 다음 컨트롤 유형 필터를 선택합니다.

5. 필터 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어 또는 페이지 카테고리에 기준(예: 포함 또는 범위 외)을 지정하여 이 컨트롤을 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 이 컨트롤로 트리거할 필터 작업을 정의합니다. 이러한 작업은 색상과 같은 카탈로그 속성, 포함과 같은 기준,빨간색과 같은 값으로 정의됩니다.

   4. add_box속성 추가를 클릭하여 속성을 추가합니다.

6. 제출을 클릭하여 승인자에게 제어 요청을 제출합니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

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

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

7. 이 컨트롤을 트리거하는 사용자 동작 유형을 선택합니다.

   • 카테고리 찾아보기: 이 규칙은 사용자가 사이트에서 카테고리를 탐색할 때 트리거됩니다(search.request.query가 비어 있음).

   • 검색: 이 규칙은 사용자가 사이트를 검색할 때 트리거됩니다(search.request.query가 비어있지 않음).

8. 선택사항: 탐색한 카테고리나 검색한 쿼리에 따라 규칙을 트리거하는 제어 조건을 설정합니다. 사용 가능한 옵션은 카테고리 찾아보기 또는 검색을 선택했는지에 따라 다릅니다.

   • 카테고리 찾아보기를 선택한 경우: 카테고리 필드에서 탐색할 때 이 컨트롤을 트리거할 카테고리를 입력합니다.

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

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

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

9. 선택사항: 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 시간 범위를 하나 이상 추가합니다.

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

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

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

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

12. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다.

13. 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

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

curl

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

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

필터 컨트롤은 사용자가 사이트에서 카테고리를 탐색할 때(search.request.query가 비어 있음) 또는 사용자가 사이트를 검색할 때(search.request.query가 비어 있지 않음) 트리거될 수 있습니다.

다음 예시에서는 browse-triggered 컨트롤의 필드를 보여줍니다. 여기서 searchSolutionUseCase는 SEARCH_SOLUTION_USE_CASE_BROWSE로 설정됩니다.

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" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "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"

다음 예시에서는 search-triggered 컨트롤의 필드를 보여줍니다. 여기서 searchSolutionUseCase는 SEARCH_SOLUTION_USE_CASE_SEARCH로 설정됩니다.

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" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "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 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 제품을 선택한 다음 컨트롤 유형 리디렉션을 선택합니다.

5. 리디렉션 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어에 기준(예: contains 또는 not in range)을 지정하여 이 제어를 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 리디렉션 URL을 입력하여 이 컨트롤로 트리거할 리디렉션 작업을 정의합니다.

6. 제출을 클릭하여 승인자에게 제어 요청을 제출합니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

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

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

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

8. 이 컨트롤을 트리거하는 사용자 동작 유형을 선택합니다.

   • 카테고리 찾아보기: 이 규칙은 사용자가 사이트에서 카테고리를 탐색할 때 트리거됩니다(search.request.query가 비어 있음).

   • 검색: 이 규칙은 사용자가 사이트를 검색할 때 트리거됩니다(search.request.query가 비어있지 않음).

9. 탐색한 카테고리나 검색한 쿼리에 따라 규칙을 트리거하는 제어 조건을 설정합니다. 사용 가능한 옵션은 카테고리 찾아보기 또는 검색을 선택했는지에 따라 다릅니다.

   • 카테고리 찾아보기를 선택한 경우: 카테고리 필드에서 탐색할 때 이 컨트롤을 트리거할 카테고리를 입력합니다.

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

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

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

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

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

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

13. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다.

14. 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

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

curl

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

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

리디렉션 컨트롤은 사용자가 사이트에서 카테고리를 탐색할 때(search.request.query가 비어 있음) 또는 사용자가 사이트를 검색할 때(search.request.query가 비어 있지 않음) 트리거될 수 있습니다.

다음 예시에서는 browse-triggered 컨트롤의 필드를 보여줍니다. 여기서 searchSolutionUseCase는 SEARCH_SOLUTION_USE_CASE_BROWSE로 설정됩니다.

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" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "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"

다음 예시에서는 search-triggered 컨트롤의 필드를 보여줍니다. 여기서 searchSolutionUseCase는 SEARCH_SOLUTION_USE_CASE_SEARCH로 설정됩니다.

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" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_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 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 제품을 선택한 다음 컨트롤 유형 동의어를 선택합니다.

5. 양방향 동의어 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어에 기준(예: contains 또는 not in range)을 지정하여 이 제어를 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 이 컨트롤로 트리거할 동의어 유형을 정의합니다. 양방향을 선택합니다. 동의어 유형에 관한 자세한 내용은 동의어 섹션을 참고하세요.

6. 제출을 클릭합니다. 그러면 세부적인 양방향 동의어 구성 화면이 표시됩니다.

7. 양방향 동의어 작업 아래의 필드에 동의어를 입력합니다. 이 작업은 검색 결과에서 동일하게 처리되도록 검색어를 양방향으로 연결합니다. 따라서 빨간색 소파 검색어는 빨간색 마룬 소파로 검색되지만 마룬 소파 검색어는 진홍색이나 분홍색과 같은 모든 유형의 빨간색 소파를 포함하도록 확장됩니다.

8. 제출을 다시 클릭하여 관리 요청을 승인자에게 전송합니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

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

4. 환경설정 섹션이 표시됩니다.

5. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

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

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

8. 선택사항: 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 시간 범위를 하나 이상 추가합니다.

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

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

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

11. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다.

12. 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

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

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 메서드를 사용합니다. 서빙 구성에 인라인으로 컨트롤 추가를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 제품을 선택한 다음 컨트롤 유형 동의어를 선택합니다.

5. 단방향 동의어 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어에 기준(예: contains 또는 not in range)을 지정하여 이 제어를 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 이 컨트롤로 트리거할 동의어 유형을 정의합니다. 단방향을 선택합니다. 동의어 유형에 관한 자세한 내용은 동의어 섹션을 참고하세요.

6. 제출을 클릭합니다. 그러면 세부적인 단방향 동의어 구성 화면으로 이동합니다.

7. 단방향 동의어 작업 아래의 필드에 동의어를 입력합니다. 이 작업은 검색 결과에서 동일하게 처리되도록 단어를 단방향으로 연결합니다. 따라서 빨간색 소파 검색어에는 진홍색 소파가 포함되지만 진홍색 소파 검색어에는 다른 유형의 빨간색 소파가 반환되지 않으므로 결과가 진홍색 소파로만 제한됩니다.

8. 제출을 다시 클릭하여 승인자에게 제어 요청을 보냅니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

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

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

7. 선택사항: 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 시간 범위를 하나 이상 추가합니다.

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

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

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

11. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다.

12. 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

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

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 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 제품을 선택한 다음 컨트롤 유형 연결하지 않음을 선택합니다.

5. 연결 금지 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어에 기준(예: contains 또는 not in range)을 지정하여 이 제어를 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 연결하지 않을 작업에서 이전 트리거 섹션에 입력한 검색어와 연결해서는 안 되는 검색어를 지정합니다. 검색어 및 연결 해제된 검색어 필드에 각각 입력합니다.

6. 제출을 클릭하여 승인자에게 제어 요청을 보냅니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

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

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

7. 선택사항: 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 시간 범위를 하나 이상 추가합니다.

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

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

10. 연결 해제된 검색어 필드에 검색 결과와 연결 해제할 검색어와 지정한 검색어를 입력합니다.

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

11. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다.

12. 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

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

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 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 제품을 선택한 다음 컨트롤 유형 무시를 선택합니다.

5. 무시 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어에 기준(예: contains 또는 not in range)을 지정하여 이 제어를 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 작업 무시에 무시하려는 검색어를 입력합니다.

6. 제출을 클릭하여 승인자에게 제어 요청을 제출합니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

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

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

7. 선택사항: 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 시간 범위를 하나 이상 추가합니다.

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

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

10. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다.

11. 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

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

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 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 제품을 선택한 다음 컨트롤 유형 대체를 선택합니다.

5. 대체 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어에 기준(예: contains 또는 not in range)을 지정하여 이 제어를 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 대체 작업에서 첫 번째 필드에 대체할 검색어를 정의하고 두 번째 필드에 대체 검색어를 정의합니다.

6. 제출을 클릭하여 승인자에게 제어 요청을 보냅니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

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

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

7. 선택사항: 기간 추가 버튼을 클릭하여 이 컨트롤을 적용할 수 있는 시간 범위를 하나 이상 추가합니다.

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

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

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

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

11. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다.

12. 컨트롤을 적용할 서빙 구성을 선택합니다.

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

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

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

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 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

상품 판매 콘솔

1. 관리자가 제공한 URL을 클릭합니다. Sign in을 클릭합니다.

   그러면 상품화 콘솔의 컨트롤 페이지로 이동합니다.

2. add_box컨트롤 만들기를 클릭합니다.

3. 최종 사용자의 목표와 필요한 시간을 정의합니다. 모든 질문에 답변해야 합니다. 다음을 클릭합니다.

4. 컨트롤을 선택합니다. 컨트롤 이름을 입력하고 검색 제품을 선택한 다음 컨트롤 유형 고정을 선택합니다.

5. 고정 컨트롤을 구성합니다.

   1. 트리거에서 관련 검색어에 기준(예: contains 또는 not in range)을 지정하여 이 제어를 트리거하는 카탈로그 속성을 정의합니다. 카탈로그 속성이 구성되지 않은 경우 이 컨트롤이 항상 적용됩니다.

   2. 기간을 입력하여 해당 기간을 정의합니다. 지정된 기간 중 하나라도 충족되면 카탈로그 속성이 지정된 기간 동안 쿼리와 일치합니다. add_box기간 추가를 사용하여 기간을 추가합니다.

   3. 이 컨트롤로 트리거할 고정 작업을 정의합니다. 이러한 작업은 제품 ID 및 핀 위치 (120 이하의 숫자, 일반적인 페이지 크기)로 정의됩니다. add_box제품 추가를 클릭하여 최대 10개까지 추가할 수 있습니다.

6. 제출을 클릭하여 승인자에게 제어 요청을 제출합니다. 제출된 요청의 상태는 Merchandising Console에서 확인할 수 있습니다. 마음이 바뀌면 관리 요청을 삭제할 수 있습니다.

Cloud 콘솔

1. Search for Commerce 콘솔의 컨트롤 페이지로 이동합니다.
   
   컨트롤 페이지로 이동

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

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

3. 환경설정 섹션의 컨트롤 이름 필드에 새 컨트롤의 이름을 입력합니다.

4. 선택사항: 자동으로 생성된 컨트롤 ID를 변경하려면 수정을 클릭하고 새 컨트롤 ID를 입력합니다.

5. 제품 선택 섹션에서 검색 또는 둘러보기를 선택합니다.

6. 컨트롤 유형으로 고정 컨트롤을 선택합니다. 계속을 클릭합니다.

7. 트리거 섹션에서 이 컨트롤을 트리거하는 사용자 동작을 선택합니다.

   • 카테고리 탐색: 탐색 요청에는 search.request.query가 비어 있는 것 외에도 page_categories 필드가 채워져 있어야 합니다.

   • 검색: 검색 요청에는 search.request.query만 채워야 합니다.

     기본적으로 탐색한 모든 카테고리와 검색한 모든 검색어가 이 컨트롤을 트리거합니다.

8. 선택사항: 탐색한 특정 카테고리나 검색한 쿼리에 따라 규칙을 트리거하는 조건을 설정합니다.

   • 카테고리 찾아보기: 카테고리 입력란에 컨트롤을 트리거하는 카테고리를 입력합니다.

   • 검색: 필터링할 검색어 (예: running shoes)를 추가하려면 검색어 추가를 클릭합니다. 각 검색어에 대해 부분 일치 또는 전체 일치를 선택합니다.

9. 선택사항: 기간 추가 또는 기간 추가를 클릭하여 이 컨트롤을 적용할 수 있는 기간을 하나 이상 추가합니다.

10. 계속을 클릭하여 작업 섹션으로 이동합니다. 고정 위치의 경우 슬라이더를 사용하여 제품을 고정할 위치를 지정합니다. 고정 값 슬라이더는 0, 음수 또는 정수가 아닌 값을 허용하지 않습니다.

    상거래용 Vertex AI Search에서는 단일 컨트롤의 핀 맵에 10개의 핀을 허용합니다. 위치는 1과 120 (최대 요청 페이지 크기) 사이의 값이 될 수 있습니다.

11. 계속을 클릭하여 서빙 구성 섹션으로 이동합니다. 컨트롤을 적용할 서빙 구성을 선택하고 컨트롤 설정을 제출합니다.

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

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

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" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

pin_position은 [1,10] 사이의 정수여야 하며 product_id은 카탈로그에 있어야 합니다. 핀 맵에서 허용되는 최대 요소 수는 컨트롤당 10개입니다.

그런 다음 고정 컨트롤을 서빙 구성에 연결합니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

이 경우 CONTROL_ID는 이전에 만든 고정 컨트롤 id여야 합니다.

서빙 구성에 컨트롤을 추가하려면 ServingConfig.addControl 메서드를 사용하세요.

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

• 이 메서드의 예시는 서빙 구성 관리를 참조하세요.

Cloud 콘솔

1. Search for Commerce 콘솔의 평가 페이지로 이동합니다.
   
   평가 페이지로 이동

2. 검색 탭으로 이동합니다.

3. 검색어 필드에 테스트 검색어를 입력합니다.

4. 검색 미리보기를 클릭합니다.

5. 결과를 확인하여 선택한 제품이 고정되었는지 확인합니다.

curl

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"