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.
- Si la reproducción automática no está activada de forma predeterminada, te recomendamos que agregues un parámetro, como
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.
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
oTVSeason
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 entidadesTVEpisode
: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:
- Verifica si cada contenido tiene vínculos directos diferentes según la plataforma.
- 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.