Identifica los vínculos directos específicos de la plataforma que se muestran en tu contenido

Cuando un usuario inicia Acciones multimedia en el contenido (por ejemplo, hace clic en tu ícono en la Búsqueda de Google), Google lo lleva directamente al contenido de tu app o plataforma mediante el vínculo directo del contenido.

Vínculo directo

A continuación, se indican los requisitos de los vínculos directos:

• urlTemplate (de un objeto de destino) requiere un vínculo directo.
• Los vínculos directos deben abrir el contenido para el que se segmentan en todas las plataformas especificadas.
• Los vínculos directos pueden incluir parámetros (&) o etiquetas de anclaje (#).
  • Si la reproducción automática no está activada de forma predeterminada, te recomendamos que agregues un parámetro, como &autoplay=true, al vínculo directo para activar la función en tu aplicación o plataforma.

A continuación, se muestra un ejemplo de @id, url y 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",
       ...
     },
   ...
   },
   ...
}

Usa vínculos directos para iniciar la reproducción

El siguiente pseudocódigo representa el comportamiento deseado cuando un usuario inicia reproducción:

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

Para lograr el comportamiento de reproducción deseado, cumple con lo siguiente requisitos específicos de la plataforma:

iOS

Debes usar vínculos universales.

Android y Android TV

Puedes usar Android App Links o vínculos de esquema personalizados.

Objetivo: Tanto los vínculos universales de iOS como los Android App Links se pueden configurar para llevan al usuario a tu app, si está instalada, y a tu sitio web, si está no está instalado. Si tu servicio no cuenta con un reproductor web, configura tu redirija automáticamente al usuario al almacén correcto para instalar la app.

Vínculos de esquema personalizados para Android y Android TV

En Android y Android TV, también puedes usar vínculos de esquemas personalizados. La duración de Se debe incluir package_id en el URI del esquema personalizado. Esto garantiza que el Se dirige al usuario a la página de tu app en Play Store si tu app no está instalada. Por lo tanto, los siguientes formatos de URI son los únicos formatos de esquema personalizado aceptables Para Acciones multimedia:

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

Por ejemplo:

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

Para obtener más detalles, consulta la especificación completa.

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

Por ejemplo:

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

Otros formatos de URI, como el siguiente ejemplo, no son personalizados. Vínculos de esquema para Acciones multimedia:

scheme://{path}

Por ejemplo:

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

Prácticas recomendadas

Si la app no está instalada y no tienes un reproductor web, configurar tu servidor web para que redireccione automáticamente al usuario al Android o App Store para instalar tu app. Para redireccionarlos, usa Firebase Dynamic Links o de terceros.

Si tienes un reproductor web y tu app no está instalada, haz lo siguiente: proporcionar un vínculo o banner inteligente a Android o App Store para que los usuarios instalar tu app. El siguiente es un ejemplo de un banner inteligente implementado:

Resumen de los requisitos y limitaciones de los vínculos directos

En la siguiente tabla, se muestran los requisitos y las limitaciones de los vínculos directos, ya que corresponden a iOS, Android y Android TV:

	iOS	Android y Android TV
http:// o https://	Obligatorio	Se recomienda si el sitio web móvil admite la reproducción.
android-app:// o intent://	N/A	Se recomienda si el sitio web móvil no admite la reproducción.
foo:// (cadena arbitraria)	No se permite	No se permite

Tipos de plataformas

Para asegurarte de que tu contenido esté disponible en las múltiples plataformas de Google (Búsqueda, Asistente, Android TV y Chromecast), cumple con los siguientes requisitos:

• Todas las plataformas compatibles con socios requieren un vínculo directo para acceder a tu contenido.
• Para las plataformas Chromecast, debes compilar un receptor con el SDK de receptor del framework de aplicaciones (CAF) de Cast más reciente.
• En el caso de las plataformas móviles (iOS y Android), consulta los requisitos en la sección Cómo usar vínculos directos para iniciar la reproducción.

En la siguiente tabla, se incluye una lista de las plataformas que admiten Acciones multimedia:

Plataforma	Descripción
http://schema.org/DesktopWebPlatform	Plataforma de búsqueda en el navegador web para computadoras.
http://schema.org/MobileWebPlatform	Plataforma de búsqueda en el navegador web móvil.
http://schema.org/AndroidPlatform	Plataformas de Búsqueda y PlayGuide en la app para Android.
http://schema.org/AndroidTVPlatform	Plataforma de Android TV en la app de Android TV.
http://schema.org/IOSPlatform	Plataforma de búsqueda en la app para iOS.
http://schema.googleapis.com/GoogleVideoCast	Plataformas Cast y Home en un dispositivo Chromecast
http://schema.googleapis.com/GoogleAudioCast	Solo escuchar acciones: Plataformas Cast y Home en un dispositivo Chromecast

Ejemplo de una entidad con dos vínculos directos diferentes:

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

Comportamiento de reproducción

Para la mayoría del contenido, cuando Google lleva a los usuarios a tu app o plataforma, solicitamos que te permite reproducir automáticamente el contenido seleccionado. Esto permite que los usuarios inicien mirar o escuchar el contenido.

Comportamiento de reproducción de Acciones de reproducción

Para las Acciones de reproducción, necesitamos el siguiente comportamiento de reproducción.

Todos los vínculos directos: Movie, TVEpisode, TVSeries y TVSeason

• Comportamiento de acceso o compra: Si tu servicio requiere un acceso compra, se debe reproducir la película o el episodio, según corresponda para su después. Para obtener más detalles, consulta los lineamientos de los vínculos directos en las conversaciones que sigues.

• Reproducción: Si tu servicio realiza un seguimiento del estado de un usuario, la reproducción debe comenzar desde el marcador anterior del usuario en la película o el episodio. De lo contrario, la reproducción debe comiencen desde el principio del contenido.

• Reproducción automática: Según la plataforma, es necesario que tu servicio reproduzca el contenido de forma destacada después de que el usuario seleccione la película o el episodio objetivo.

  • Búsqueda: Se recomienda la reproducción automática, pero no es obligatoria. Si no se admite la reproducción automática, el contenido debe reproducirse con un clic después de que se dirige al usuario a tu app o servicio.
  • Android TV: Se requiere la reproducción automática para las películas y los episodios.

Solo vínculos directos de TVSeries y TVSeason

• Selección de episodio objetivo: Debes seleccionar el episodio de destino correcto. Si Tu servicio realiza un seguimiento del estado de un usuario, el episodio de destino debe ser el episodio que el usuario dejó de mirar por última vez. O bien, si el usuario completó el episodio que miraron por última vez, hacer que el episodio objetivo sea el siguiente episodio. De lo contrario, el episodio objetivo debe ser uno de los siguientes: a tu discreción:

  • TVSeries
    • Es el primer episodio de la serie. Se recomienda para programas serializados.
    • El primer episodio de la temporada más reciente. Recomendado para programas serializados de larga duración.
    • El episodio más reciente Se recomienda para programas diarios o relacionados con noticias.
  • TVSeason
    • Es el primer episodio de la temporada. Se recomienda para programas serializados.
    • El episodio más reciente Se recomienda para programas diarios o relacionados con noticias.

  Un vínculo directo para TVSeries o TVSeason debe ser estático (sin cambios) y resuelve el episodio objetivo. No uses el vínculo directo para episodio específico.

  En la siguiente tabla, hay varios ejemplos en los que se demuestran los requisitos lógica de selección de episodios objetivo para TVSeries, TVSeason y Tipos de entidades TVEpisode:

  	Segmentar episodio si el usuario miró la última vez el S6E24	Segmentar el episodio si el usuario no miró ningún episodio
  Vínculo directo a la serie	S6E24 (si el usuario no terminó el S6E24) S6E25 (si el usuario terminó de mirar S6E24)	Uno de los siguientes: Primer episodio de la serie Primer episodio de la temporada más reciente Episodio más reciente
  Vínculo directo de la temporada (S1-S5)	El episodio que miró el usuario por última vez en esa temporada primer episodio de la temporada si el usuario no miró episodios de esa temporada.	Primer episodio de la temporada
  Vínculo directo de la temporada (S6)	S6E24 (si el usuario no terminó el S6E24) S6E25 (si el usuario terminó de mirar S6E24)	Uno de los siguientes: Primer episodio de la temporada Episodio más reciente
  Vínculo directo del episodio	El episodio específico en el que se hizo clic.	El episodio específico en el que se hizo clic.

Comportamiento de reproducción de las acciones de escucha

Para las acciones de escucha, necesitamos el siguiente comportamiento de reproducción:

• El contenido debe reproducirse con un clic después de que se dirige al usuario a tu app o servicio.
• Si tu app o plataforma requiere que accedas, debes reproducir el contenido inmediatamente o con un solo clic después del acceso.
• La app o la plataforma debe ofrecer al menos una forma para que todos los usuarios reproduzcan la canción, el álbum, el artista o la playlist exactos.
  • En el caso de los usuarios que no pueden reproducir el contenido exacto (por ejemplo, que no tienen la suscripción requerida), el servicio debe explicar qué debe hacer el usuario a fin de ser apto para reproducir el contenido exacto al acceder a tu app o plataforma.

Te sugerimos que sigas las prácticas recomendadas para tu app o plataforma:

• Para MusicGroup, reproduce contenido diferente del artista cada vez que un usuario selecciona el artista.
• Para MusicAlbum, reproduce contenido en el orden en que aparecen en el álbum.
• Para MusicPlaylist, reproduce contenido diferente de la playlist cada vez que un usuario la selecciona.

Identificar los vínculos directos

Puedes hacer lo siguiente:

1. Verifica si cada contenido tiene vínculos directos diferentes según la plataforma.
2. Para cada vínculo directo, haz las siguientes preguntas sobre su punto de entrada (la página en tu aplicación o plataforma a la que te lleva el vínculo directo):
   • ¿El punto de entrada (no el contenido) admite varios idiomas?
   • ¿El punto de entrada admite varios idiomas con subtítulos?
   • ¿El punto de entrada admite varios ángulos de cámara?
   • ¿El punto de entrada admite varios formatos de video?

Si la respuesta a alguna de estas preguntas es afirmativa, debes proporcionar la propiedad additionalProperty para ese vínculo directo. Consulta el ejemplo de additionalProperty.