개요

Google 파트너는 예약 대기자 명단 통합을 통해 Google에 구조화된 메뉴 데이터를 제공하여 음식점의 Google 비즈니스 프로필의 메뉴 섹션과 Google 소비자 서비스 전반의 기타 진입점에서 사용할 수 있습니다.

메뉴 데이터는 일반 피드를 사용하여 인그레스됩니다. 시작하기 전에

  1. 계정 설정을 완료했는지 확인합니다.
  2. 일반 피드 업로드 프로세스 이해하기
  3. 일반 피드 업로드를 위해 계정을 구성하는 방법 알아보기

스키마

전체 메뉴 스키마는 여기에서 확인할 수 있습니다.

메뉴 피드 만들기 및 업로드하기

메뉴 피드를 만들고 업로드할 때는 다음 가이드라인과 규칙을 따르세요.
  • 레스토랑 세부정보를 제공하려면 판매자 피드에 설명된 데이터 사양을 따르세요. JSON 파일의 예시는 샘플 JSON을 참고하세요. 데이터 파일 이름은 업로드 간에 고유해야 합니다. 파일 이름에 타임스탬프를 포함하는 것이 좋습니다(예: menu1_1633621547.json).
  • 메뉴 피드의 파일 세트 설명자에서 name 필드를 google.food_menu로 설정합니다. 설명자 파일 콘텐츠의 예시는 설명자 파일 JSON 샘플을 참고하세요. 설명자 파일의 이름은 업로드 간에 고유해야 합니다. 파일 이름에 타임스탬프(예: descriptor_1633621547.filesetdesc.json)를 포함하는 것이 좋습니다. 설명자 파일은 메뉴 피드의 일부로 일반 SFTP 서버에 업로드해야 합니다.
  • 피드는 매일 일반 SFTP 서버에 전체 새로고침으로 업로드해야 합니다.
  • 일반 피드 sftp 사용에 설명된 대로 피드를 1,000개의 샤드 (파일)로 제한합니다.

피드 수집 상태는 파트너 포털의 피드 > 기록 섹션에서 확인할 수 있습니다. 피드 SFTP 서버 정보는 파트너 포털의 구성 > 피드 섹션에서 확인할 수 있습니다.

피드 SFTP 서버 선택

그림 1: 일반 SFTP 서버 정보

피드 수집 상태는 파트너 포털의 피드 > 기록 섹션에서 확인할 수 있습니다. 피드 SFTP 서버 정보는 파트너 포털의 구성 > 피드 섹션에서 확인할 수 있습니다.

메뉴 항목 옵션 작업

메뉴 항목 옵션은 MenuItemOption 프로토를 사용하여 지정할 수 있습니다.

단일 메뉴 항목에 필수 옵션이 여러 개 있는 파트너 (예: 크기 옵션과 우유 옵션이 있는 라떼)는 Google에 이러한 옵션을 가장 잘 표시하는 방법을 결정해야 합니다. Google에서는 다음을 권장합니다.

  • 메뉴 피드는 파트너의 주문 사이트 (또는 위치에 주문 사이트가 없는 경우 레스토랑의 매장 내 식사 메뉴)와 일치해야 합니다. 주문 사이트에 개별 가격이 표시되는 상품에는 MenuItem을 사용해야 합니다. 상품이 기본 가격과 여러 옵션으로 표시되는 경우 MenuItemOption을 사용해야 합니다.
  • 다음과 같이 옵션 목록을 길게 포함하지 마세요.
    • 닭고기 부리토
    • 치즈가 들어간 치킨 부리토
    • 살사가 들어간 치킨 부리토
    • 살사와 치즈가 들어간 치킨 부리토
    • 과카몰레가 들어간 치킨 부리토
    • 과카몰레와 살사가 들어간 치킨 부리토
  • 메뉴 항목 옵션은 요리에 옵션 중 하나를 선택해야 하는 경우에만 지원됩니다. 예를 들어 피자를 주문할 때 크기는 필수 옵션입니다. 부가기능용 메뉴 항목 옵션('아보카도 추가 옵션' 등)은 지원되지 않으며 피드에 포함해서는 안 됩니다.

메뉴 항목 옵션 가격은 해당 옵션이 선택된 항목의 전체 가격이어야 합니다. 가격은 메뉴 항목 또는 옵션에 설정해야 하며 둘 다에 설정할 수는 없습니다.

메뉴가 여러 개인 레스토랑

하나의 레스토랑 (엔티티)에는 하나의 메뉴만 있을 수 있습니다. 메뉴가 여러 개 (예: 점심 메뉴와 저녁 메뉴가 별도로 있음)인 레스토랑의 경우 모든 메뉴를 MenuSections이 있는 단일 메뉴로 결합할 수 있습니다(예: 점심 섹션과 저녁 섹션이 있는 메뉴 하나). 결과 메뉴의 구조는 다음과 같습니다.

  • 메뉴
    • 점심 섹션
      • 스프
        • Soup 1
        • 수프 2
      • 샌드위치
        • 샌드위치 1
        • 샌드위치 2
    • 저녁 식사 섹션
      • 시작 조건
        • Starter 1
        • Starter 2
      • 메인
        • 메인 요리 1
        • 메인 요리 2

여러 음식점 간 메뉴 공유

메뉴의 merchant_ids 목록에 모든 레스토랑을 포함하면 하나의 메뉴를 여러 레스토랑에서 공유할 수 있습니다. 이 목록은 엔티티 피드를 사용하는 파트너의 엔티티 ID를 허용합니다.

권장사항

다음은 메뉴 피드를 개발할 때 따라야 하는 권장사항입니다.

  • 음식점에는 하나의 메뉴만 연결할 수 있습니다.
  • 기본 언어를 TextField의 첫 번째 언어로 제공합니다. LocalizedText 객체를 여러 개 전송하는 경우 텍스트 목록의 첫 번째 객체가 사용자에게 표시됩니다.
  • 모든 메뉴 항목은 메뉴 섹션에 추가해야 합니다. 메뉴 객체에 메뉴 항목을 직접 추가하지 마세요.
  • utf-8 인코딩을 사용하여 콘텐츠를 제공합니다. 비ASCII 문자는 이스케이프 처리하지 않아도 됩니다.
  • 여러 지역에서 출시하는 경우 units 및 nanos 필드에 올바른 통화 코드와 단위를 사용해야 합니다. 단위의 10^-9인 nanos 필드에 특히 주의하세요. 인벤토리 뷰어의 메뉴 시각화 도구를 사용하여 가격을 올바르게 설정했는지 확인합니다.
  • 사용자에게 시각적으로 풍부하고 포괄적이며 최신 메뉴를 제공하는 것은 유용하고 매력적인 사용자 환경을 제공하는 데 매우 중요합니다. 가격, 설명, 사진, 식이 정보는 모두 의사 결정을 유도하는 핵심 요소이며, 파트너는 최적의 사용자 및 판매자 환경을 제공하기 위해 이러한 데이터를 최대한 많이 제공하는 것이 좋습니다.

메뉴 피드가 출시되면 메뉴 피드 데이터가 탐색 환경에 표시될 수 있으며 음식점 장소 시트의 '메뉴' 탭에 표시될 수 있습니다. 메뉴 탭은 Google 검색 (모바일 및 데스크톱)에서 지원되며, Google 지도를 비롯한 추가 표시 경로로 환경이 확장될 예정입니다. 렌더링된 환경은 표시 경로에 따라 다를 수 있습니다.

설명이 포함된 메뉴 항목을 보여주는 메뉴의 예

그림 3: 모바일의 비즈니스 프로필에 메뉴 피드 콘텐츠가 표시되는 방식의 예

메뉴가 올바르게 구성되었는지 확인하려면 인벤토리 뷰어에서 메뉴 시각화 도구를 사용하여 메뉴를 미리 봅니다.

음식점 메뉴는 Google 비즈니스 프로필을 통한 음식점 자체, 음식 주문 및 예약 파트너, 메뉴의 사용자 사진 등 다양한 소스에서 가져올 수 있습니다. 여러 소스에서 동일한 음식점의 메뉴를 제공하는 경우 판매자는 Google 비즈니스 프로필 메뉴 편집기에서 기본 제공업체를 선택할 수 있습니다.