Стартовые фиды (устаревшие версии)

Сначала вам нужно создать свои каналы, затем Google их оценивает.

Создание каналов

1. Создавайте свои каналы. Большую часть данных о ваших запасах вы передаете в Google через фиды. Для начала создайте два типа каналов:

   • Лента продавцов. В ленте «Продавцы» описаны ваши продавцы и ссылки на действия на уровне продавца.
   • Фид услуг (необязательно): фид услуг описывает услуги и уровень обслуживания action_link , которые ваши продавцы предоставляют вашей платформе.

   Обязательные и рекомендуемые поля

   Кормить	Имя поля	Описание	Необходимый?
   Торговец	идентификатор продавца	Уникальный идентификатор продавца	Да
   Торговец	имя	Имя продавца	Да
   Торговец	гео	Адрес и геокоординаты продавца	Да
   Торговец	телефон	Телефон торговца	Да
   Торговец	категория	Тип места продавца	Приятно иметь
   Торговец	action_link	Информация о ссылках на контент, специфичных для продавцов	Необязательно, если предоставляются служебные каналы, в противном случае требуется.
   Торговец	идентификатор бренда	Строка, определяющая используемый бренд, ориентированный на потребителя.	Необязательный
   Услуги	идентификатор_сервиса	Уникальный идентификатор услуги, предоставляемой продавцом	Да (только если предоставлен сервисный канал)
   Услуги	идентификатор продавца	Ссылка на Продавца, предоставляющего данную услугу	Да (только если предоставлен сервисный канал)
   Услуги	имя_локального_сервиса	Название предоставляемой услуги	Да (только если предоставлен сервисный канал)
   Услуги	localized_description	Видимое пользователю описание услуги	Необязательный
   Услуги	action_link	Предоставляет информацию о глубоких ссылках, связанных с сервисом.	Да (только если предоставлен сервисный канал)
   Услуги	тип	Тип глубокой ссылки (например, SERVICE_TYPE_DINING_RESERVATION)	Да (только если предоставлен сервисный канал)

   Примечание. Все дополнительные поля, указанные в справочном разделе, следует игнорировать.
   Ключевой момент: вам необходимо только загрузить фид продавца.

   Для начала ознакомьтесь с образцами фидов

   • Фиды бронирования мест в ресторанах
   • Заказ еды Доставка Feed
   • Самовывоз заказа еды
   • Фиды заказа еды с метаданными
   • Фиды розничных заказов
   • Фиды розничных заказов с метаданными
   • Ленты личных встреч
   • Ленты онлайн/виртуальных встреч

   Для продавцов, которые имеют несколько услуг, но предоставляют их с помощью одной ссылки действия, вам следует предоставить одну ссылку действия для всех услуг, связанных с продавцом в фиде продавцов.

   Подробнее об указании ссылок на действия в устаревших каналах интеграции для начинающих можно узнать здесь .

   Включите метаданные фида в каждый из ваших фидов, которые инструктируют Google о том, как интерпретировать фид.

   Ниже приведен фрагмент метаданных фида:

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }
   

   Примечание. Все каналы необходимо загружать с помощью инструкции обработки PROCESS_AS_COMPLETE. PROCESS_AS_INCREMENTAL устарел и не может использоваться.
   Примечание. Стартовую начальную интеграцию также можно реализовать в сочетании со сквозной интеграцией Actions Center или в качестве дополнения к сквозной интеграции. Для поддержки этого вам также потребуется реализовать каналы доступности и обязательные поля сквозной интеграции в соответствии с этим руководством .

2. Экспортируйте свои каналы. Формат каналов описывается с помощью синтаксиса буфера протокола 3 , однако вы можете обратиться к упомянутым выше примерам, чтобы увидеть формат JSON. Мы рекомендуем загружать фиды в формате JSON.

   Если вы действительно хотите продолжить работу с форматом pb3, общую информацию о том, как использовать буферы протокола для создания файла pb3, см. в разделе «Основы буфера протокола: Java» .

3. Загрузите каналы в свой Dropbox SFTP. Чтобы загрузить свои каналы, используйте информацию о почтовом ящике SFTP , предоставленную вам Google, и закрытый ключ, который вы создали в программе «Настройка» . Сервер Google SFTP доступен по sftp://partnerupload.google.com через порт 19321 .

   Загружайте файлы с уникальными именами, например с именем, включающим временную метку. Уникальные имена помогают устранять неполадки и позволяют запрашивать статус канала.

   Чтобы определить размер кормов и частоту доставки, используйте следующие рекомендации:

   • Размер файлов фида и фрагментов:
     • Размер файла фида не должен превышать 200 МБ (после сжатия). Сжимаем их с помощью gzip
     • Если ваш файл может достигать размера более 200 МБ (после сжатия), разделите его на несколько фрагментов, следуя руководству по сегментированию файлов каналов . Однако одна только устаревшая стартовая интеграция вряд ли достигнет предела в 200 МБ.
   • Частота полных обновлений:
     • Полная информация о торговцах предоставляется один раз в день.
     • (Если реализовано) Полная информация об услугах предоставляется один раз в день.
   Примечание. Google обрабатывает файлы фидов сразу после их загрузки в папку обмена SFTP. Если канал разбит на несколько файлов, процесс начинается после загрузки последнего файла. Если ваш фид содержит ошибки, вы получите электронное письмо с кодами ошибок фида .

Google оценивает каналы

После того как вы загружаете свои фиды, Google обрабатывает и оценивает их качество и полноту. Мы учитываем несколько факторов:

• Корма соответствуют заявленным характеристикам.
• Фиды включают все обязательные поля.
• У каждого продавца есть по крайней мере одна action_link или одна услуга, для которой определена хотя бы action_link .
• Большая часть ваших данных о продавцах совпадает с местоположениями на Картах Google.

Примечание. Чтобы обеспечить плавную интеграцию, перед отправкой фидов выполните предварительную оценку вышеуказанных факторов, за исключением последнего.