피드 만들기
데이터가 Google에 직접 표시되려면 피드를 Google에 정기적으로 제공해야 합니다. 다음 피드가 필요합니다.
피드 | 설명 | 빈도 |
---|---|---|
판매자 | 판매자를 설명합니다. | 24시간마다 한 번 |
서비스 | 판매자가 제공하는 서비스를 설명합니다. | 24시간마다 한 번 |
제공 지역 | 판매자가 제공하는 서비스의 이용 가능 시간대입니다. 최소 30일 동안의 노출 기간을 제공해야 합니다. (90일까지 연장 가능, Google 담당자에게 문의) | 24시간마다 한 번 |
각 피드에 Google에 피드를 해석하는 방법을 알려주는 메타데이터를 포함합니다.
피드 형식은 프로토콜 버퍼 3 구문으로 설명되지만 피드를 상응하는 JSON 형식으로 업로드할 수 있습니다. JSON 형식은 피드 샘플을 참고하세요. JSON 형식으로 피드를 업로드하는 것이 좋습니다.
피드 파일 크기, 샤딩, 압축
압축 및 샤드에 관한 다음 튜토리얼을 참고하세요.피드의 크기를 결정하려면 다음 가이드라인을 참고하세요 (피드는 '샤드'라고 하는 여러 파일로 구성할 수 있습니다).
- 추천 피드 샤딩:
- 판매자 피드: 샤드 1개
- 서비스 피드: 샤드 1개
- 이용 가능 여부 피드: 샤드 20개 미만
- 피드 파일의 크기 및 샤딩:
- 샤드 파일 크기를 200MB 미만으로 유지합니다(압축 후). 필요한 경우 여러 개의 샤드를 사용합니다.
- 하나의 샤드로 전송되는 개별 레코드는 이후 피드에서 동일한 샤드로 전송하지 않아도 됩니다.
- 성능을 향상하려면 데이터를 샤드 간에 균등하게 분할하여 모든 샤드 파일의 크기를 비슷하게 만듭니다.
- 필요한 경우 gzip을 사용하여 일반 텍스트 JSON 피드를 압축합니다. 단, 개별 피드 샤드에 대해 이 작업을 실행합니다.
SFTP 보관용 계정에 피드 업로드
샌드박스 환경에 피드를 업로드합니다. 이렇게 하려면 파트너 포털 피드 구성 페이지 내의 사용자 이름을 참고하세요. Google SFTP 서버는 19321
포트의 sftp://partnerupload.google.com
에서 사용할 수 있습니다.
업로드하는 파일에 고유한 이름을 지정하는 것이 좋습니다. 예를 들어 각 파일 이름에 타임스탬프를 추가하는 방법이 있습니다. 이렇게 하면 문제를 해결하고 피드 상태를 쿼리할 때 유용합니다.
데이터가 올바른지 확인
파트너 포털에 로그인합니다. 샌드박스 환경으로 전환하여 대시보드 섹션에서 다음 페이지를 찾습니다.
- 피드
- 피드 요약 통계를 표시하고 피드를 업로드하는 동안 발생한 오류를 표시합니다.
샌드박스 환경에 처음 업로드한 후 데이터가 올바른지 확인하려면 피드 페이지에서 피드 오류가 있는지 확인하세요. 그런 다음 인벤토리 요약 페이지에서 데이터 문제가 있는지 확인합니다. 일반적인 문제는 서비스 없이 판매자를 업로드하거나 향후 이용 가능 시간대가 없는 서비스를 업로드하는 것입니다.
실시간 UI 환경을 에뮬레이션하는 샌드박스 프런트엔드는 사용자의 관점에서 데이터가 어떻게 표시되는지 보여줍니다. 액세스하려면 상단의 환경 전환 도구가 샌드박스로 설정되어 있는지 확인하고 인벤토리 > 인벤토리 로 이동하여 '준비됨' 또는 '실제 (샌드박스)'인 판매자를 찾은 다음 가장 오른쪽 열의 링크를 클릭하거나 (있는 경우) 행을 클릭하고 'RwG - E2E' 링크를 클릭합니다. '준비됨' 또는 '게시됨 (샌드박스)' 상태의 판매자가 없는 경우 사용 중지된 판매자를 열고 오른쪽에 나열된 모든 문제를 해결합니다 (예: 향후 이용 가능 여부가 업로드되었는지 확인).
샌드박스 프런트엔드에 액세스할 수 없는 경우 프런트엔드 액세스 권한이 부여된 계정으로 로그인되어 있는지 확인합니다. 또한 이 계정으로만 로그인되어 있는지 확인합니다. 다른 계정으로 로그인한 다음 사용자 전환 기능을 사용하여 승인된 Google 계정에 로그인해도 샌드박스 프런트엔드에서 차단됩니다.
프로덕션에 피드 업로드
오류가 없는 완전한 피드를 샌드박스 환경에 지속적으로 업로드할 수 있게 되면 프로덕션 환경에 업로드를 시작할 수 있습니다. 이 시점에서는 통합이 게시되지 않습니다.
판매자를 Google 비즈니스 등록정보에 일치시키기 시작할 수 있도록 전체 판매자 피드를 최대한 빨리 (출시 1주일 전까지) 업로드하세요. 일치가 올바른지 확인하세요.
프로덕션 피드 데이터가 모두 일관되게 업로드되고 프로덕션 시스템에 연결되면 피드를 검토할 수 있습니다.
Google에서 피드 평가
피드를 업로드하면 Google에서 피드를 처리하고 피드의 품질과 완전성을 평가합니다. Google은 다음과 같은 요인을 확인합니다.
- 피드가 피드 사양과 일치합니다.
- 피드에 필수 입력란이 모두 포함되어 있습니다.
- 피드의 총 판매자 수가 Google과 상의한 수와 일치합니다.
- 판매자별로 하나 이상의 서비스가 정의되어 있습니다.
- 피드의 총 서비스 수가 Google과 상의한 수와 일치합니다.
- 향후 1~30일(또는 적용 범위가 90일로 연장된 경우 90일) 동안 이용 가능 시간대가 있는 서비스의 수를 확인합니다.
- 제공된 판매자 중 Google 지도의 지형지물과 매치시킬 수 있는 판매자 수를 확인합니다.