Определите глубинные ссылки вашего контента, специфичные для платформы.

Когда пользователь инициирует действия с медиаконтентом (например, нажимает на вашу иконку в поиске Google), Google перенаправляет пользователя непосредственно к контенту в вашем приложении или на платформе, используя прямую ссылку на этот контент.

Прямая ссылка

Для создания глубоких ссылок требуются следующие условия:

• urlTemplate ( целевого объекта ) требует наличия прямой ссылки.
• Глубокие ссылки должны открывать целевой контент на всех указанных платформах.
• Глубокие ссылки могут содержать параметры (&) или теги привязки (#).
  • Если функция автовоспроизведения не активирована по умолчанию, мы рекомендуем добавить параметр, например &autoplay=true , к прямой ссылке, чтобы активировать функцию автовоспроизведения в вашем приложении или на платформе.

Пример использования @id , url и urlTemplate :

{
   "@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",
       ...
     },
   ...
   },
   ...
}

Используйте прямые ссылки для начала воспроизведения.

Следующий псевдокод описывает желаемое поведение при запуске воспроизведения пользователем:

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

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

iOS

Необходимо использовать универсальные ссылки .

Android и Android TV

Вы можете использовать либо ссылки на приложения Android , либо ссылки на пользовательские схемы .

Ссылки на пользовательские схемы для Android и Android TV

На Android и Android TV также можно использовать ссылки с пользовательской схемой. В URI пользовательской схемы необходимо включить package_id вашего приложения. Это гарантирует, что пользователь будет перенаправлен на страницу вашего приложения в Play Store, если ваше приложение не установлено. Таким образом, следующие форматы URI являются единственными допустимыми форматами пользовательской схемы для действий с медиафайлами:

android-app://{package_id}/{scheme}/{path}

Например:

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

Для получения более подробной информации см. полную спецификацию .

intent://{package_id}/{scheme}/{path}

Например:

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

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

scheme://{path}

Например:

mynetwork://play?series=20114&title=21141&media=e90c89fa4

Передовые методы

Если ваше приложение не установлено и у вас нет веб-плеера, настройте веб-сервер так, чтобы он автоматически перенаправлял пользователя в магазин приложений Android или App Store для установки вашего приложения. Для перенаправления используйте динамические ссылки Firebase или сторонние платформы для создания интеллектуальных ссылок.

Если ваше приложение не установлено, но у вас есть веб-плеер, предоставьте ссылку или умный баннер на страницу Android или App Store, чтобы пользователи могли установить ваше приложение. Ниже приведен пример реализованного умного баннера:

Краткое описание требований и ограничений для глубоких ссылок

В таблице ниже приведены требования и ограничения для глубоких ссылок, относящиеся к iOS, Android и AndroidTV:

Типы платформ

Чтобы ваш контент был доступен на всех платформах Google, поддерживающих Media Actions, выполните следующие требования:

• Все поддерживаемые партнёрами платформы требуют наличия прямой ссылки на ваш контент.
• Для платформ Chromecast необходимо создать приемник, используя последнюю версию Cast Application Framework (CAF) Receiver SDK .
• Для мобильных платформ (Android и iOS) см. требования в разделе «Использование прямых ссылок для начала воспроизведения» .

В таблице ниже приведен список платформ, поддерживающих медиа-действия:

Пример сущности с двумя разными глубокими ссылками:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

Поведение воспроизведения

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

Поведение воспроизведения действий просмотра

Для действий просмотра требуется следующее поведение воспроизведения.

Все прямые ссылки: Фильм, Эпизод, Сериал и Сезон

• Вход в систему или совершение покупки: Если ваш сервис требует входа в систему или совершения покупки, после этого должен быть воспроизведен фильм или эпизод, в соответствии с его типом. Для получения более подробной информации см. следующие рекомендации по использованию прямых ссылок.

• Воспроизведение: Если ваш сервис отслеживает состояние пользователя, воспроизведение должно начинаться с предыдущей отметки пользователя на видео или эпизоде. В противном случае воспроизведение должно начинаться с начала контента.

• Автовоспроизведение: В зависимости от платформы, ваш сервис должен автоматически воспроизводить контент после того, как пользователь выберет нужный эпизод или фильм.

  • Поиск: Функция автовоспроизведения настоятельно рекомендуется, но не является обязательной. Если автовоспроизведение не поддерживается, контент должен воспроизводиться в течение одного клика после того, как пользователь перейдет в ваше приложение или сервис.
  • Android TV: Для воспроизведения фильмов и серий требуется автовоспроизведение.

Только прямые ссылки на сериалы и сезоны сериалов.

• Выбор целевого эпизода: Необходимо выбрать правильный целевой эпизод. Если ваш сервис отслеживает состояние пользователя, целевым эпизодом должен быть тот эпизод, который пользователь закончил смотреть в последний раз. Или, если пользователь полностью досмотрел последний просмотренный эпизод, выберите в качестве целевого эпизода следующий эпизод. В противном случае, на ваше усмотрение, целевым эпизодом может быть один из следующих:

  • TVSeries
    • Первая серия сериала. Рекомендуется для просмотра сериалов, которые транслируются последовательно.
    • Первая серия нового сезона. Рекомендуется для просмотра сериалов, которые длятся долго.
    • Последний эпизод. Рекомендуется для просмотра в режиме реального времени или в новостной программе.
  • TVSeason
    • Первый эпизод сезона. Рекомендуется для просмотра сериалов.
    • Последний эпизод. Рекомендуется для просмотра в режиме реального времени или в новостной программе.

  Ссылка для TVSeries или TVSeason должна быть статической (неизменяемой) и вести к целевому эпизоду. Не используйте прямую ссылку для конкретного эпизода.

  В таблице ниже приведены несколько примеров, демонстрирующих необходимую логику выбора целевого эпизода для типов сущностей TVSeries , TVSeason и TVEpisode :

  	Целевой эпизод, если пользователь последний раз смотрел 6 сезон 24 серию	Если пользователь ещё не смотрел ни одной серии, выберите целевую серию.
  Глубокая ссылка на серию	S6E24 (если пользователь еще не досмотрел S6E24) S6E25 (если пользователь досмотрел S6E24)	Один из следующих вариантов: Первая серия сериала Первый эпизод нового сезона Последний эпизод
  Глубокая связь между сезонами (S1-S5)	Какой бы эпизод пользователь ни смотрел в последний раз в этом сезоне, или первый эпизод сезона, если пользователь не смотрел ни одного эпизода в этом сезоне.	Первый эпизод сезона
  Глубокая связь между сезонами (S6)	S6E24 (если пользователь еще не досмотрел S6E24) S6E25 (если пользователь досмотрел S6E24)	Один из следующих вариантов: Первый эпизод сезона Последний эпизод
  прямая ссылка на эпизод	Конкретный эпизод, на который был сделан клик.	Конкретный эпизод, на который был сделан клик.

Поведение воспроизведения в разделе «Действия прослушивания»

Для действий прослушивания требуется следующее поведение воспроизведения:

• Контент должен воспроизводиться в течение одного клика после того, как пользователь перейдет в ваше приложение или сервис.
• Если ваше приложение или платформа требует авторизации, контент должен воспроизводиться немедленно или в один клик после авторизации.
• Ваше приложение или платформа должны предоставлять как минимум один способ для всех пользователей воспроизвести именно ту песню, альбом, исполнителя или плейлист.
  • Для пользователей, не имеющих права играть в данный контент (например, у них нет необходимой подписки), ваш сервис должен объяснить, что пользователь должен сделать, чтобы получить право играть в данный контент после перехода в ваше приложение или на вашу платформу.

Мы рекомендуем следующие лучшие практики для вашего приложения или платформы:

• Для MusicGroup следует воспроизводить разный контент от одного и того же исполнителя каждый раз, когда пользователь выбирает исполнителя.
• В приложении MusicAlbum воспроизводите контент в порядке его появления в альбоме.
• Для MusicPlaylist каждый раз, когда пользователь выбирает плейлист, воспроизводится разный контент из него.

Определите глубокие ссылки

Выполните следующие действия:

1. Для каждого элемента контента проверьте, есть ли у него разные прямые ссылки в зависимости от платформы.
2. Для каждой прямой ссылки задайте следующие вопросы о точке входа (странице вашего приложения или платформы, на которую ведет прямая ссылка):
   • Поддерживает ли точка входа (а не контент) несколько языков?
   • Поддерживает ли точка входа несколько языков субтитров?
   • Поддерживает ли точка входа несколько ракурсов камеры?
   • Поддерживает ли точка входа несколько видеоформатов?

Если вы ответили утвердительно хотя бы на один из этих вопросов, вам необходимо указать свойство additionalProperty для этой прямой ссылки. См. пример использования свойства additionalProperty .

Когда пользователь инициирует действия с медиаконтентом (например, нажимает на вашу иконку в поиске Google), Google перенаправляет пользователя непосредственно к контенту в вашем приложении или на платформе, используя прямую ссылку на этот контент.

Прямая ссылка

Для создания глубоких ссылок требуются следующие условия:

• urlTemplate ( целевого объекта ) требует наличия прямой ссылки.
• Глубокие ссылки должны открывать целевой контент на всех указанных платформах.
• Глубокие ссылки могут содержать параметры (&) или теги привязки (#).
  • Если функция автовоспроизведения не активирована по умолчанию, мы рекомендуем добавить параметр, например &autoplay=true , к прямой ссылке, чтобы активировать функцию автовоспроизведения в вашем приложении или на платформе.

Пример использования @id , url и urlTemplate :

{
   "@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",
       ...
     },
   ...
   },
   ...
}

Используйте прямые ссылки для начала воспроизведения.

Следующий псевдокод описывает желаемое поведение при запуске воспроизведения пользователем:

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

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

iOS

Необходимо использовать универсальные ссылки .

Android и Android TV

Вы можете использовать либо ссылки на приложения Android , либо ссылки на пользовательские схемы .

Ссылки на пользовательские схемы для Android и Android TV

На Android и Android TV также можно использовать ссылки с пользовательской схемой. В URI пользовательской схемы необходимо включить package_id вашего приложения. Это гарантирует, что пользователь будет перенаправлен на страницу вашего приложения в Play Store, если ваше приложение не установлено. Таким образом, следующие форматы URI являются единственными допустимыми форматами пользовательской схемы для действий с медиафайлами:

android-app://{package_id}/{scheme}/{path}

Например:

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

Для получения более подробной информации см. полную спецификацию .

intent://{package_id}/{scheme}/{path}

Например:

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

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

scheme://{path}

Например:

mynetwork://play?series=20114&title=21141&media=e90c89fa4

Передовые методы

Если ваше приложение не установлено и у вас нет веб-плеера, настройте веб-сервер так, чтобы он автоматически перенаправлял пользователя в магазин приложений Android или App Store для установки вашего приложения. Для перенаправления используйте динамические ссылки Firebase или сторонние платформы для создания интеллектуальных ссылок.

Если ваше приложение не установлено, но у вас есть веб-плеер, предоставьте ссылку или умный баннер на страницу Android или App Store, чтобы пользователи могли установить ваше приложение. Ниже приведен пример реализованного умного баннера:

Краткое описание требований и ограничений для глубоких ссылок

В таблице ниже приведены требования и ограничения для глубоких ссылок, относящиеся к iOS, Android и AndroidTV:

Типы платформ

Чтобы ваш контент был доступен на всех платформах Google, поддерживающих Media Actions, выполните следующие требования:

• Все поддерживаемые партнёрами платформы требуют наличия прямой ссылки на ваш контент.
• Для платформ Chromecast необходимо создать приемник, используя последнюю версию Cast Application Framework (CAF) Receiver SDK .
• Для мобильных платформ (Android и iOS) см. требования в разделе «Использование прямых ссылок для начала воспроизведения» .

В таблице ниже приведен список платформ, поддерживающих медиа-действия:

Пример сущности с двумя разными глубокими ссылками:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

Поведение воспроизведения

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

Поведение воспроизведения действий просмотра

Для действий просмотра требуется следующее поведение воспроизведения.

Все прямые ссылки: Фильм, Эпизод, Сериал и Сезон

• Вход в систему или совершение покупки: Если ваш сервис требует входа в систему или совершения покупки, после этого должен быть воспроизведен фильм или эпизод, в соответствии с его типом. Для получения более подробной информации см. следующие рекомендации по использованию прямых ссылок.

• Воспроизведение: Если ваш сервис отслеживает состояние пользователя, воспроизведение должно начинаться с предыдущей отметки пользователя на видео или эпизоде. В противном случае воспроизведение должно начинаться с начала контента.

• Автовоспроизведение: В зависимости от платформы, ваш сервис должен автоматически воспроизводить контент после того, как пользователь выберет нужный эпизод или фильм.

  • Поиск: Функция автовоспроизведения настоятельно рекомендуется, но не является обязательной. Если автовоспроизведение не поддерживается, контент должен воспроизводиться в течение одного клика после того, как пользователь перейдет в ваше приложение или сервис.
  • Android TV: Для воспроизведения фильмов и серий требуется автовоспроизведение.

Только прямые ссылки на сериалы и сезоны сериалов.

• Выбор целевого эпизода: Необходимо выбрать правильный целевой эпизод. Если ваш сервис отслеживает состояние пользователя, целевым эпизодом должен быть тот эпизод, который пользователь закончил смотреть в последний раз. Или, если пользователь полностью досмотрел последний просмотренный эпизод, выберите в качестве целевого эпизода следующий эпизод. В противном случае, на ваше усмотрение, целевым эпизодом может быть один из следующих:

  • TVSeries
    • Первая серия сериала. Рекомендуется для просмотра сериалов, которые транслируются последовательно.
    • Первая серия нового сезона. Рекомендуется для просмотра сериалов, которые длятся долго.
    • Последний эпизод. Рекомендуется для просмотра в режиме реального времени или в новостной программе.
  • TVSeason
    • Первый эпизод сезона. Рекомендуется для просмотра сериалов.
    • Последний эпизод. Рекомендуется для просмотра в режиме реального времени или в новостной программе.

  Ссылка для TVSeries или TVSeason должна быть статической (неизменяемой) и вести к целевому эпизоду. Не используйте прямую ссылку для конкретного эпизода.

  В таблице ниже приведены несколько примеров, демонстрирующих необходимую логику выбора целевого эпизода для типов сущностей TVSeries , TVSeason и TVEpisode :

  	Целевой эпизод, если пользователь последний раз смотрел 6 сезон 24 серию	Если пользователь ещё не смотрел ни одной серии, выберите целевую серию.
  Глубокая ссылка на серию	S6E24 (если пользователь еще не досмотрел S6E24) S6E25 (если пользователь досмотрел S6E24)	Один из следующих вариантов: Первая серия сериала Первый эпизод нового сезона Последний эпизод
  Глубокая связь между сезонами (S1-S5)	Какой бы эпизод пользователь ни смотрел в последний раз в этом сезоне, или первый эпизод сезона, если пользователь не смотрел ни одного эпизода в этом сезоне.	Первый эпизод сезона
  Глубокая связь между сезонами (S6)	S6E24 (если пользователь еще не досмотрел S6E24) S6E25 (если пользователь досмотрел S6E24)	Один из следующих вариантов: Первый эпизод сезона Последний эпизод
  прямая ссылка на эпизод	Конкретный эпизод, на который был сделан клик.	Конкретный эпизод, на который был сделан клик.

Поведение воспроизведения в разделе «Действия прослушивания»

Для действий прослушивания требуется следующее поведение воспроизведения:

• Контент должен воспроизводиться в течение одного клика после того, как пользователь перейдет в ваше приложение или сервис.
• Если ваше приложение или платформа требует авторизации, контент должен воспроизводиться немедленно или в один клик после авторизации.
• Ваше приложение или платформа должны предоставлять как минимум один способ для всех пользователей воспроизвести именно ту песню, альбом, исполнителя или плейлист.
  • Для пользователей, не имеющих права играть в данный контент (например, у них нет необходимой подписки), ваш сервис должен объяснить, что пользователь должен сделать, чтобы получить право играть в данный контент после перехода в ваше приложение или на вашу платформу.

Мы рекомендуем следующие лучшие практики для вашего приложения или платформы:

• Для MusicGroup следует воспроизводить разный контент от одного и того же исполнителя каждый раз, когда пользователь выбирает исполнителя.
• В приложении MusicAlbum воспроизводите контент в порядке его появления в альбоме.
• Для MusicPlaylist каждый раз, когда пользователь выбирает плейлист, воспроизводится разный контент из него.

Определите глубокие ссылки

Выполните следующие действия:

1. Для каждого элемента контента проверьте, есть ли у него разные прямые ссылки в зависимости от платформы.
2. Для каждой прямой ссылки задайте следующие вопросы о точке входа (странице вашего приложения или платформы, на которую ведет прямая ссылка):
   • Поддерживает ли точка входа (а не контент) несколько языков?
   • Поддерживает ли точка входа несколько языков субтитров?
   • Поддерживает ли точка входа несколько ракурсов камеры?
   • Поддерживает ли точка входа несколько видеоформатов?

Если вы ответили утвердительно хотя бы на один из этих вопросов, вам необходимо указать свойство additionalProperty для этой прямой ссылки. См. пример использования свойства additionalProperty .

Когда пользователь инициирует действия с медиаконтентом (например, нажимает на вашу иконку в поиске Google), Google перенаправляет пользователя непосредственно к контенту в вашем приложении или на платформе, используя прямую ссылку на этот контент.

Прямая ссылка

Для создания глубоких ссылок требуются следующие условия:

• urlTemplate ( целевого объекта ) требует наличия прямой ссылки.
• Глубокие ссылки должны открывать целевой контент на всех указанных платформах.
• Глубокие ссылки могут содержать параметры (&) или теги привязки (#).
  • Если функция автовоспроизведения не активирована по умолчанию, мы рекомендуем добавить параметр, например &autoplay=true , к прямой ссылке, чтобы активировать функцию автовоспроизведения в вашем приложении или на платформе.

Пример использования @id , url и urlTemplate :

{
   "@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",
       ...
     },
   ...
   },
   ...
}

Используйте прямые ссылки для начала воспроизведения.

Следующий псевдокод описывает желаемое поведение при запуске воспроизведения пользователем:

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

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

iOS

Необходимо использовать универсальные ссылки .

Android и Android TV

Вы можете использовать либо ссылки на приложения Android , либо ссылки на пользовательские схемы .

Ссылки на пользовательские схемы для Android и Android TV

На Android и Android TV также можно использовать ссылки с пользовательской схемой. В URI пользовательской схемы необходимо включить package_id вашего приложения. Это гарантирует, что пользователь будет перенаправлен на страницу вашего приложения в Play Store, если ваше приложение не установлено. Таким образом, следующие форматы URI являются единственными допустимыми форматами пользовательской схемы для действий с медиафайлами:

android-app://{package_id}/{scheme}/{path}

Например:

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

Для получения более подробной информации см. полную спецификацию .

intent://{package_id}/{scheme}/{path}

Например:

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

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

scheme://{path}

Например:

mynetwork://play?series=20114&title=21141&media=e90c89fa4

Передовые методы

Если ваше приложение не установлено и у вас нет веб-плеера, настройте веб-сервер так, чтобы он автоматически перенаправлял пользователя в магазин приложений Android или App Store для установки вашего приложения. Для перенаправления используйте динамические ссылки Firebase или сторонние платформы для создания интеллектуальных ссылок.

Если ваше приложение не установлено, но у вас есть веб-плеер, предоставьте ссылку или умный баннер на страницу Android или App Store, чтобы пользователи могли установить ваше приложение. Ниже приведен пример реализованного умного баннера:

Краткое описание требований и ограничений для глубоких ссылок

В таблице ниже приведены требования и ограничения для глубоких ссылок, относящиеся к iOS, Android и AndroidTV:

Типы платформ

Чтобы ваш контент был доступен на всех платформах Google, поддерживающих Media Actions, выполните следующие требования:

• Все поддерживаемые партнёрами платформы требуют наличия прямой ссылки на ваш контент.
• Для платформ Chromecast необходимо создать приемник, используя последнюю версию Cast Application Framework (CAF) Receiver SDK .
• Для мобильных платформ (Android и iOS) см. требования в разделе «Использование прямых ссылок для начала воспроизведения» .

В таблице ниже приведен список платформ, поддерживающих медиа-действия:

Пример сущности с двумя разными глубокими ссылками:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

Поведение воспроизведения

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

Поведение воспроизведения действий просмотра

Для действий просмотра требуется следующее поведение воспроизведения.

Все прямые ссылки: Фильм, Эпизод, Сериал и Сезон

• Вход в систему или совершение покупки: Если ваш сервис требует входа в систему или совершения покупки, после этого должен быть воспроизведен фильм или эпизод, в соответствии с его типом. Для получения более подробной информации см. следующие рекомендации по использованию прямых ссылок.

• Воспроизведение: Если ваш сервис отслеживает состояние пользователя, воспроизведение должно начинаться с предыдущей отметки пользователя на видео или эпизоде. В противном случае воспроизведение должно начинаться с начала контента.

• Автовоспроизведение: В зависимости от платформы, ваш сервис должен автоматически воспроизводить контент после того, как пользователь выберет нужный эпизод или фильм.

  • Поиск: Функция автовоспроизведения настоятельно рекомендуется, но не является обязательной. Если автовоспроизведение не поддерживается, контент должен воспроизводиться в течение одного клика после того, как пользователь перейдет в ваше приложение или сервис.
  • Android TV: Для воспроизведения фильмов и серий требуется автовоспроизведение.

Только прямые ссылки на сериалы и сезоны сериалов.

• Выбор целевого эпизода: Необходимо выбрать правильный целевой эпизод. Если ваш сервис отслеживает состояние пользователя, целевым эпизодом должен быть тот эпизод, который пользователь закончил смотреть в последний раз. Или, если пользователь полностью досмотрел последний просмотренный эпизод, выберите в качестве целевого эпизода следующий эпизод. В противном случае, на ваше усмотрение, целевым эпизодом может быть один из следующих:

  • TVSeries
    • Первая серия сериала. Рекомендуется для просмотра сериалов, которые транслируются последовательно.
    • Первая серия нового сезона. Рекомендуется для просмотра сериалов, которые длятся долго.
    • Последний эпизод. Рекомендуется для просмотра в режиме реального времени или в новостной программе.
  • TVSeason
    • Первый эпизод сезона. Рекомендуется для просмотра сериалов.
    • Последний эпизод. Рекомендуется для просмотра в режиме реального времени или в новостной программе.

  Ссылка для TVSeries или TVSeason должна быть статической (неизменяемой) и вести к целевому эпизоду. Не используйте прямую ссылку для конкретного эпизода.

  В таблице ниже приведены несколько примеров, демонстрирующих необходимую логику выбора целевого эпизода для типов сущностей TVSeries , TVSeason и TVEpisode :

  	Целевой эпизод, если пользователь последний раз смотрел 6 сезон 24 серию	Если пользователь ещё не смотрел ни одной серии, выберите целевую серию.
  Глубокая ссылка на серию	S6E24 (если пользователь еще не досмотрел S6E24) S6E25 (если пользователь досмотрел S6E24)	Один из следующих вариантов: Первая серия сериала Первый эпизод нового сезона Последний эпизод
  Глубокая связь между сезонами (S1-S5)	Какой бы эпизод пользователь ни смотрел в последний раз в этом сезоне, или первый эпизод сезона, если пользователь не смотрел ни одного эпизода в этом сезоне.	Первый эпизод сезона
  Глубокая связь между сезонами (S6)	S6E24 (если пользователь еще не досмотрел S6E24) S6E25 (если пользователь досмотрел S6E24)	Один из следующих вариантов: Первый эпизод сезона Последний эпизод
  прямая ссылка на эпизод	Конкретный эпизод, на который был сделан клик.	Конкретный эпизод, на который был сделан клик.

Поведение воспроизведения в разделе «Действия прослушивания»

Для действий прослушивания требуется следующее поведение воспроизведения:

• Контент должен воспроизводиться в течение одного клика после того, как пользователь перейдет в ваше приложение или сервис.
• Если ваше приложение или платформа требует авторизации, контент должен воспроизводиться немедленно или в один клик после авторизации.
• Ваше приложение или платформа должны предоставлять как минимум один способ для всех пользователей воспроизвести именно ту песню, альбом, исполнителя или плейлист.
  • Для пользователей, не имеющих права играть в данный контент (например, у них нет необходимой подписки), ваш сервис должен объяснить, что пользователь должен сделать, чтобы получить право играть в данный контент после перехода в ваше приложение или на вашу платформу.

Мы рекомендуем следующие лучшие практики для вашего приложения или платформы:

• Для MusicGroup следует воспроизводить разный контент от одного и того же исполнителя каждый раз, когда пользователь выбирает исполнителя.
• В приложении MusicAlbum воспроизводите контент в порядке его появления в альбоме.
• Для MusicPlaylist каждый раз, когда пользователь выбирает плейлист, воспроизводится разный контент из него.

Определите глубокие ссылки

Выполните следующие действия:

1. Для каждого элемента контента проверьте, есть ли у него разные прямые ссылки в зависимости от платформы.
2. Для каждой прямой ссылки задайте следующие вопросы о точке входа (странице вашего приложения или платформы, на которую ведет прямая ссылка):
   • Поддерживает ли точка входа (а не контент) несколько языков?
   • Поддерживает ли точка входа несколько языков субтитров?
   • Поддерживает ли точка входа несколько ракурсов камеры?
   • Поддерживает ли точка входа несколько видеоформатов?

Если вы ответили утвердительно хотя бы на один из этих вопросов, вам необходимо указать свойство additionalProperty для этой прямой ссылки. См. пример использования свойства additionalProperty .

Когда пользователь инициирует действия с медиаконтентом (например, нажимает на вашу иконку в поиске Google), Google перенаправляет пользователя непосредственно к контенту в вашем приложении или на платформе, используя прямую ссылку на этот контент.

Прямая ссылка

Для создания глубоких ссылок требуются следующие условия:

• urlTemplate ( целевого объекта ) требует наличия прямой ссылки.
• Глубокие ссылки должны открывать целевой контент на всех указанных платформах.
• Глубокие ссылки могут содержать параметры (&) или теги привязки (#).
  • Если функция автовоспроизведения не активирована по умолчанию, мы рекомендуем добавить параметр, например &autoplay=true , к прямой ссылке, чтобы активировать функцию автовоспроизведения в вашем приложении или на платформе.

Пример использования @id , url и urlTemplate :

{
   "@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",
       ...
     },
   ...
   },
   ...
}

Используйте прямые ссылки для начала воспроизведения.

Следующий псевдокод описывает желаемое поведение при запуске воспроизведения пользователем:

if your app is installed
  open app and initiate playback
elseif your website supports playback
  open your website and initiate playback
else
  take user to your app's install page on the Play or App store and then
  initiate playback after your app is installed

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

iOS

Необходимо использовать универсальные ссылки .

Android и Android TV

Вы можете использовать либо ссылки на приложения Android , либо ссылки на пользовательские схемы .

Ссылки на пользовательские схемы для Android и Android TV

На Android и Android TV также можно использовать ссылки с пользовательской схемой. В URI пользовательской схемы необходимо включить package_id вашего приложения. Это гарантирует, что пользователь будет перенаправлен на страницу вашего приложения в Play Store, если ваше приложение не установлено. Таким образом, следующие форматы URI являются единственными допустимыми форматами пользовательской схемы для действий с медиафайлами:

android-app://{package_id}/{scheme}/{path}

Например:

android-app://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

Для получения более подробной информации см. полную спецификацию .

intent://{package_id}/{scheme}/{path}

Например:

intent://com.partner.mynetworkapp/mynetwork/play?series=20114&title=21141&media=e90c89fa4

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

scheme://{path}

Например:

mynetwork://play?series=20114&title=21141&media=e90c89fa4

Передовые методы

Если ваше приложение не установлено и у вас нет веб-плеера, настройте веб-сервер так, чтобы он автоматически перенаправлял пользователя в магазин приложений Android или App Store для установки вашего приложения. Для перенаправления используйте динамические ссылки Firebase или сторонние платформы для создания интеллектуальных ссылок.

Если ваше приложение не установлено, но у вас есть веб-плеер, предоставьте ссылку или умный баннер на страницу Android или App Store, чтобы пользователи могли установить ваше приложение. Ниже приведен пример реализованного умного баннера:

Краткое описание требований и ограничений для глубоких ссылок

В таблице ниже приведены требования и ограничения для глубоких ссылок, относящиеся к iOS, Android и AndroidTV:

Типы платформ

Чтобы ваш контент был доступен на всех платформах Google, поддерживающих Media Actions, выполните следующие требования:

• Все поддерживаемые партнёрами платформы требуют наличия прямой ссылки на ваш контент.
• Для платформ Chromecast необходимо создать приемник, используя последнюю версию Cast Application Framework (CAF) Receiver SDK .
• Для мобильных платформ (Android и iOS) см. требования в разделе «Использование прямых ссылок для начала воспроизведения» .

В таблице ниже приведен список платформ, поддерживающих медиа-действия:

Пример сущности с двумя разными глубокими ссылками:

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/standardView",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform"
      ]
    },
    {
      "@type":"EntryPoint",
      "urlTemplate":"http://example.com/multipleViews",
      "actionPlatform": [
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ],
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "videoFormat",
          "value": [ "HD", "4K" ]
        }
      ],
    }
  ],
  ...
}

Поведение воспроизведения

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

Поведение воспроизведения действий просмотра

Для действий просмотра требуется следующее поведение воспроизведения.

Все прямые ссылки: Фильм, Эпизод, Сериал и Сезон

• Вход в систему или совершение покупки: Если ваш сервис требует входа в систему или совершения покупки, после этого должен быть воспроизведен фильм или эпизод, в соответствии с его типом. Для получения более подробной информации см. следующие рекомендации по использованию прямых ссылок.

• Воспроизведение: Если ваш сервис отслеживает состояние пользователя, воспроизведение должно начинаться с предыдущей отметки пользователя на видео или эпизоде. В противном случае воспроизведение должно начинаться с начала контента.

• Автовоспроизведение: В зависимости от платформы, ваш сервис должен автоматически воспроизводить контент после того, как пользователь выберет нужный эпизод или фильм.

  • Поиск: Функция автовоспроизведения настоятельно рекомендуется, но не является обязательной. Если автовоспроизведение не поддерживается, контент должен воспроизводиться в течение одного клика после того, как пользователь перейдет в ваше приложение или сервис.
  • Android TV: Для воспроизведения фильмов и серий требуется автовоспроизведение.

Только прямые ссылки на сериалы и сезоны сериалов.

• Выбор целевого эпизода: Необходимо выбрать правильный целевой эпизод. Если ваш сервис отслеживает состояние пользователя, целевым эпизодом должен быть тот эпизод, который пользователь закончил смотреть в последний раз. Или, если пользователь полностью досмотрел последний просмотренный эпизод, выберите в качестве целевого эпизода следующий эпизод. В противном случае, на ваше усмотрение, целевым эпизодом может быть один из следующих:

  • TVSeries
    • Первая серия сериала. Рекомендуется для просмотра сериалов, которые транслируются последовательно.
    • Первая серия нового сезона. Рекомендуется для просмотра сериалов, которые длятся долго.
    • Последний эпизод. Рекомендуется для просмотра в режиме реального времени или в новостной программе.
  • TVSeason
    • Первый эпизод сезона. Рекомендуется для просмотра сериалов.
    • Последний эпизод. Рекомендуется для просмотра в режиме реального времени или в новостной программе.

  Ссылка для TVSeries или TVSeason должна быть статической (неизменяемой) и вести к целевому эпизоду. Не используйте прямую ссылку для конкретного эпизода.

  В таблице ниже приведены несколько примеров, демонстрирующих необходимую логику выбора целевого эпизода для типов сущностей TVSeries , TVSeason и TVEpisode :

  	Целевой эпизод, если пользователь последний раз смотрел 6 сезон 24 серию	Если пользователь ещё не смотрел ни одной серии, выберите целевую серию.
  Глубокая ссылка на серию	S6E24 (если пользователь еще не досмотрел S6E24) S6E25 (if the user has finished watching S6E24)	Один из следующих вариантов: First episode of the series First episode of the latest season Latest episode
  Season deep link (S1-S5)	Whichever episode the user last watched in that season, or the first episode of the season if the user hasn't watched any episodes in that season.	First episode of the season
  Season deep link (S6)	S6E24 (if the user hasn't finished S6E24) S6E25 (if the user has finished watching S6E24)	Один из следующих вариантов: First episode of the season Latest episode
  Episode deep link	The specific episode that was clicked.	The specific episode that was clicked.

Listen Actions playback behavior

For Listen Actions, we require the following playback behavior:

• Content must play within one click after the user is taken to your app or service.
• If your app or platform requires a sign-in, it needs to play the content immediately or within one click after the sign-in.
• Your app or platform must offer at least one way for all users to play the exact song, album, artist, or playlist.
  • For users ineligible to play the exact content (for example, they don't have the required subscription), your service must explain what the user needs to do to become eligible to play the exact content upon arriving at your app or platform.

We recommend the following best practices for your app or platform:

• For MusicGroup , play different content from the artist each time a user selects the artist.
• For MusicAlbum , play content in the order of appearance in the album.
• For MusicPlaylist , play different content from the playlist each time a user selects the playlist.

Identify the deep links

Выполните следующие действия:

1. For each content, check if it has different deep links based on the platforms.
2. For each deep link, ask the following questions about its entry point (the page on your app or platform the deep link takes you to):
   • Does the entry point (not the content) support multiple languages?
   • Does the entry point support multiple subtitle languages?
   • Does the entry point support multiple camera angles?
   • Does the entry point support multiple video formats?

If your answer is yes to any of these questions, you need to provide the additionalProperty property for that deep link. See the additionalProperty example.