Создание фида

Фид медиаконтента – это объект JSON, который содержит набор объектов, представляющих медиаконтент в вашем каталоге, например сериалы, фильмы, песни, альбомы и т. д. Первый шаг в процессе адаптации — начать разработку фидов. Когда файлы будут готовы, вам нужно будет разместить фид, используя один из поддерживаемых методов размещения, чтобы Google мог регулярно его получать.

Требования к формату файла фида

Ниже приведены требования к файлам фидов.

  • Файл фида должен иметь расширение .json.
  • Не шифруйте файл фида.
  • Используйте кодировку UTF-8 (проверьте настройки редактора файлов).

    alt_text

  • Если размер файла фида превышает 1 ГБ (в несжатом виде), разделите его на несколько файлов.

  • Рекомендуем создать по одному файлу для каждого типа объектов (например, tvseries.json, tvseasons.json, tvepisodes.json, movies.json и т. д.).

    • Если размер какого-либо из этих файлов превышает 1 ГБ, разделите его объекты на несколько файлов (например, tvepisodes_01.json, tvepisodes_02.json и т. д.).
    • Если размер файла не превышает 1 ГБ, то в него можно добавить любое количество объектов.
  • Убедитесь, что файл закодирован без BOM, как указано в спецификации JSON. Чтобы проверить ОС Linux, hexdump file.json | head -n 1 не должен начинаться с BBEF по адресу 0x00.

Типы фидов

Фид товаров

  • Это набор файлов фида JSON, которые вместе представляют весь ваш каталог, который вы хотите запустить в Google. Инструкции по созданию фида приведены в разделе ниже.
  • Если вы интегрируете свои данные с Google впервые, вам нужен только этот фид.
  • После отправки фида в Google он будет тщательно проанализирован и несколько раз доработан, чтобы достичь более высокого уровня качества в отношении объема собираемой информации и ее правильности, прежде чем он будет окончательно принят и запущен.

Тестовый фид

  • В некоторых случаях требуется расширение фида товаров. Вот несколько примеров:
    • Расширение фида за счет добавления новых типов объектов, которые ранее не использовались.
    • Расширение фида, чтобы включить в него большое количество новых объектов и метаданных для запуска в новых регионах.
    • Расширение фида на новые типы платформ. Например, если фид товаров запущен только в Google Поиске, а вы хотите запустить его и в Google TV.
  • В таких случаях требуется тестовый фид. Этот фид является копией рабочего фида, но содержит дополнительные метаданные, например ссылки на контент для новой платформы, метаданные для нового региона и т. д.
  • Как и в случае с фидом товаров для рабочей среды, мы тщательно проанализируем его и выполним несколько итераций, чтобы повысить качество и точность собираемой информации. Когда качество фида товаров достигнет нужного уровня, он заменит текущий рабочий фид товаров и станет новым рабочим фидом товаров.
  • Это позволит нам отделить первоначальный запуск от последующих и провести все необходимые тесты, не затрагивая основной фид. Это позволяет избежать сбоев в работе конечных пользователей.

Если у вас возникнут вопросы, обратитесь к представителю Google.

Создайте файл фида

При создании фида следуйте приведенным ниже рекомендациям.

  1. Создайте тестовый фид с небольшим набором объектов

    Прежде чем создавать фид со всеми товарами из каталога, рекомендуем создать тестовый фид с небольшим набором объектов. При работе с фидом вы можете столкнуться с проблемами. Ограничив размер набора объектов, вы сможете легче устранять эти ошибки и предупреждения.

  2. Проверка образца фида

    Мы предоставляем инструменты, которые позволяют убедиться, что фид соответствует спецификации. Рекомендуем использовать эти инструменты, чтобы устранить все ошибки и предупреждения, обнаруженные в вашем образце фида.

  3. Как создать рабочий фид

    Убедившись, что структура фида для небольшого набора объектов корректна, разработайте фид для всего каталога.

Создайте пример фида

  1. Выберите один объект из каталога. Выберите объект с достаточно сложной структурой, но типичный для каталога.
  2. Используйте инструмент проверки схемы JSON, чтобы найти синтаксические ошибки и отсутствующие обязательные свойства. Подробная информация приведена в следующем разделе.

    Пример фида с одним объектом Movie

    {
      "@context": "http://schema.org",
      "@type": "DataFeed",
      "dateModified": "2018-07-20T00:44:51Z",
      "dataFeedElement": [
        {
          "@context": ["http://schema.org", {"@language": "en"}],
          "@type": "Movie",
          "@id": "http://www.example.com/my_favorite_movie",
          "url": "http://www.example.com/my_favorite_movie",
          "name": "My Favorite Movie",
          "potentialAction": {
            "@type": "WatchAction",
            "target": {
              "@type": "EntryPoint",
              "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
              "inLanguage": "en",
              "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/MobileWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://schema.org/AndroidTVPlatform",
                "http://schema.org/IOSPlatform",
                "http://schema.googleapis.com/GoogleVideoCast"
              ]
            },
            "actionAccessibilityRequirement": {
              "@type": "ActionAccessSpecification",
              "category": "subscription",
              "requiresSubscription": {
                "@type": "MediaSubscription",
                "name": "Example Package",
                "commonTier": true,
                "@id": "[partner determined string]"
              },
              "availabilityStarts": "2018-07-21T10:35:29Z",
              "availabilityEnds": "2019-10-21T10:35:29Z",
              "eligibleRegion": [
                {
                  "@type": "Country",
                  "name": "US"
                },
                {
                  "@type": "Country",
                  "name": "CA"
                }
              ]
            }
          },
          "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
          "releasedEvent": {
            "@type": "PublicationEvent",
            "startDate": "2008-01-20",
            "location": {
              "@type": "Country",
              "name": "US"
            }
          },
          "description": "This is my favorite movie.",
          "actor": [
            {
              "@type": "Person",
              "name": "John Doe",
              "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
            },
            {
              "@type": "Person",
              "name": "Jane Doe",
              "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
            }
          ],
          "identifier": [
            {
              "@type": "PropertyValue",
              "propertyID": "IMDB_ID",
              "value":  "tt0123456"
            }
          ]
        }
      ]
    }

Проверьте пример фида

Для проверки фида на соответствие спецификациям структурированных данных Google для фидов медиаконтента можно использовать следующие инструменты:

  • Инструмент проверки схем JSON

    Инструмент JSON Schema Validation проверяет все файлы в фиде локально перед загрузкой. Используйте этот инструмент во время разработки фида, чтобы избежать распространенных ошибок в структуре и типах данных. Подробнее об инструменте…

  • Ресурсы каталога в Search Console

    После того как представитель Google включит ресурс-каталог Search Console и ваш тестовый или промежуточный фид будет обработан, используйте ресурсы-каталоги в Search Console, чтобы проверить ошибки валидации на уровне объектов, предупреждения и диагностику обработки.

Создайте фид товаров

  1. Когда все структурные ошибки и предупреждения в тестовом фиде будут устранены, расширьте фид, включив в него все объекты из каталога.
  2. Запустите инструмент проверки схемы JSON для расширенных файлов фида и после загрузки проверьте свойства каталога в Search Console, чтобы убедиться в отсутствии ошибок. Убедитесь, что в фиде есть все объекты из каталога. Для этого сравните количество объектов в фиде с количеством объектов в каталоге.