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 dirige directamente al contenido de tu app o plataforma mediante el vínculo directo del contenido.

Los siguientes son los requisitos para los vínculos directos:

  • urlTemplate (de un objeto de destino) requiere un vínculo directo.
  • Los vínculos directos deben abrir el contenido al que se segmentan en todas las plataformas especificadas.
  • Los vínculos directos pueden incluir parámetros (&) o etiquetas de ancla (#).

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

El siguiente pseudocódigo representa el comportamiento deseado cuando un usuario inicia la 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 los siguientes 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 esquemas personalizados.

En Android y Android TV, también puedes usar vínculos de esquemas personalizados. El package_id de tu app debe incluirse en el URI del esquema personalizado. Esto garantiza que el usuario se dirija a la página de tu app en Play Store si 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 vínculos de esquema personalizados aceptables para las Acciones multimedia:

scheme://{path}

Por ejemplo:

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

Prácticas recomendadas

En caso de que tu app no esté instalada y no tengas un reproductor web, configura tu servidor web para que redireccione automáticamente al usuario a Android o App Store para que la instale. Para redireccionar, usa Dynamic Links de Firebase o plataformas de vínculos inteligentes de terceros.

En caso de que tu app no esté instalada y tengas un reproductor web, proporciona un vínculo o un banner inteligente a Android o App Store para que los usuarios instalen tu app. El siguiente es un ejemplo de un banner inteligente implementado:

Ejemplo de un banner inteligente implementado

En la siguiente tabla, se muestran los requisitos y las limitaciones de los vínculos directos en relación con 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:

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 un navegador web para computadoras
http://schema.org/MobileWebPlatform Plataforma de búsqueda en un 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 Busca la plataforma en la app para iOS.
http://schema.googleapis.com/GoogleVideoCast Plataformas de Cast y Home en un dispositivo Chromecast
http://schema.googleapis.com/GoogleAudioCast Solo acciones de escucha. Plataformas de 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 la reproducción

En el caso de la mayoría del contenido, cuando Google dirige a los usuarios a tu app o plataforma, requerimos que reproduzcas automáticamente el contenido seleccionado. Esto permite que los usuarios comiencen a mirar o escuchar el contenido con rapidez.

Comportamiento de reproducción de las Acciones de visualización

Para las Acciones de reproducción, requerimos 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 o una compra, la película o el episodio deben reproducirse, según corresponda a su tipo, después. Para obtener más detalles, consulta los lineamientos de vínculos directos que se incluyen a continuación.

  • 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 comenzar desde el principio del contenido.

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

    • 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 el usuario se dirija a tu app o servicio.
    • Android TV: La reproducción automática es obligatoria para las películas y los episodios.

Solo vínculos directos de TVSeries y TVSeason

  • Selección del episodio objetivo: Debes seleccionar el episodio objetivo correcto. Si tu servicio realiza un seguimiento del estado de un usuario, el episodio de destino debe ser el que el usuario dejó de mirar por última vez. O bien, si el usuario terminó por completo el episodio que miró por última vez, haz que el episodio objetivo sea el siguiente. De lo contrario, el episodio de destino debe ser uno de los siguientes según tu criterio:

    • TVSeries
      • Es el primer episodio de la serie. Se recomienda para programas serializados.
      • El primer episodio de la temporada más reciente. Se recomienda 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 (no debe cambiar) y resolverse en el episodio de destino. No uses el vínculo directo para un episodio específico.

    En la siguiente tabla, se proporcionan varios ejemplos que demuestran la lógica de selección de episodios objetivo requerida para los tipos de entidades TVSeries, TVSeason y TVEpisode:

    El episodio de destino si el usuario miró por última vez el episodio 24 de la temporada 6 Es el episodio de destino si el usuario no miró ningún episodio.
    Vínculo directo a la serie
    • S6E24 (si el usuario no terminó S6E24)
    • S6E25 (si el usuario terminó de mirar el 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 el usuario miró por última vez en esa temporada o el primer episodio de la temporada si el usuario no miró ningún episodio de esa temporada
    • Primer episodio de la temporada
    Vínculo directo de la temporada (S6)
    • S6E24 (si el usuario no terminó S6E24)
    • S6E25 (si el usuario terminó de mirar el 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 reproducción, requerimos el siguiente comportamiento de reproducción:

  • El contenido debe reproducirse con un clic después de que se dirija al usuario a tu app o servicio.
  • Si tu app o plataforma requiere un acceso, debe reproducir el contenido de inmediato o con un clic después de acceder.
  • Tu app o 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 son aptos para reproducir el contenido exacto (por ejemplo, no tienen la suscripción requerida), tu servicio debe explicar lo que el usuario debe hacer para poder reproducir el contenido exacto cuando llegue a tu app o plataforma.

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

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

Puedes hacer lo siguiente:

  1. Para cada contenido, verifica si tiene diferentes vínculos directos según las plataformas.
  2. Para cada vínculo directo, haz las siguientes preguntas sobre su punto de entrada (la página de tu app o plataforma a la que te dirige el vínculo directo):
    • ¿El punto de entrada (no el contenido) admite varios idiomas?
    • ¿El punto de entrada admite varios idiomas de 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 cualquiera de estas preguntas es afirmativa, debes proporcionar la propiedad additionalProperty para ese vínculo directo. Consulta el ejemplo de additionalProperty.

Anterior
Recopila los metadatos
Siguiente
Identifica el requisito de acceso