Identifica i link diretti specifici della piattaforma dei tuoi contenuti

Quando un utente avvia Azioni multimediali sui contenuti (ad esempio, un utente fa clic sulla tua icona nella Ricerca Google), Google indirizza l'utente direttamente ai contenuti nella tua app o piattaforma utilizzando il link diretto ai contenuti.

Di seguito sono riportati i requisiti per i link diretti:

  • urlTemplate (di un oggetto di destinazione) richiede un link diretto.
  • I link diretti devono aprire i contenuti scelti come target su tutte le piattaforme specificate.
  • I link diretti possono includere parametri (&) o anchor tag (#).

Esempio di @id, url e 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",
       ...
     },
   ...
   },
   ...
}

Il seguente pseudocodice rappresenta il comportamento desiderato quando un utente avvia riproduzione:

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

Per ottenere il comportamento di riproduzione desiderato, rispetta le seguenti linee guida: requisiti specifici della piattaforma:

iOS
È necessario utilizzare i link universali.
Android e Android TV
Puoi utilizzare i link per app Android o link allo schema personalizzato.

Su Android e Android TV, puoi anche utilizzare i link con schema personalizzato. Della tua app package_id deve essere incluso nell'URI dello schema personalizzato. Ciò garantisce che l'utente viene indirizzato alla pagina dell'app sul Play Store, se quest'ultima non è installata. Di conseguenza, i seguenti formati URI sono gli unici formati di schema personalizzato accettabili per Azioni multimediali:

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

Ad esempio:

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

Per ulteriori dettagli, consulta la specifica completa.

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

Ad esempio:

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

Altri formati URI, come l'esempio che segue, non sono accettabili link allo schema per le Azioni multimediali:

scheme://{path}

Ad esempio:

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

Best practice

Se l'app non è installata e non hai un web player, configurare il server web in modo che reindirizzi automaticamente l'utente alla Android o App Store per installare l'app. Per eseguire il reindirizzamento, utilizza i link dinamici Firebase o piattaforme Smart Link di terze parti.

Se l'app non è installata e hai un web player, fornire un link o un banner intelligente ad Android o App Store per consentire agli utenti di installare l'app. Di seguito è riportato un esempio di banner intelligente implementato:

Esempio di banner intelligente implementato

La seguente tabella mostra i requisiti e le limitazioni per i link diretti, poiché riguarda iOS, Android e AndroidTV:

iOS Android e AndroidTV
http:// o https:// Obbligatorio Opzione consigliata se il sito web mobile supporta la riproduzione.
android-app:// o intent:// N/D Opzione consigliata se il sito web mobile non supporta la riproduzione.
foo:// (stringa arbitraria) Non consentito Non consentito

Tipi di piattaforma

Per assicurarti che i tuoi contenuti siano disponibili sulle varie piattaforme di Google (Ricerca, assistente, Android TV e Chromecast), rispetta i seguenti requisiti:

La tabella seguente contiene un elenco delle piattaforme che supportano le Azioni multimediali:

Piattaforma Descrizione
http://schema.org/DesktopWebPlatform Piattaforma di ricerca su un browser web desktop.
http://schema.org/MobileWebPlatform Piattaforma di ricerca su browser web mobile.
http://schema.org/AndroidPlatform Piattaforme di ricerca e PlayGuide nell'app per Android.
http://schema.org/AndroidTVPlatform la piattaforma Android TV sull'app Android TV.
http://schema.org/IOSPlatform Piattaforma di ricerca nell'app per iOS.
http://schema.googleapis.com/GoogleVideoCast Piattaforme di Google Cast e Home su un dispositivo Chromecast.
http://schema.googleapis.com/GoogleAudioCast Solo azioni di ascolto. Piattaforme di Google Cast e Home su un dispositivo Chromecast.

Esempio di un'entità con due link diretti diversi:

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

Comportamento di riproduzione

Per la maggior parte dei contenuti, quando Google indirizza gli utenti alla tua app o piattaforma, di riprodurre automaticamente i contenuti selezionati. Ciò consente agli utenti di iniziare rapidamente guardando o ascoltando i contenuti.

Comportamento durante la riproduzione delle azioni dell'orologio

Per le Azioni di visualizzazione, richiediamo il seguente comportamento di riproduzione.

Tutti i link diretti: Movie, TVEpisode, TVSeries e TVSeason

  • Comportamento di accesso o acquisto: se il servizio richiede un accesso o acquisto, il film o la puntata deve essere riprodotto in modo appropriato per di testo. Per ulteriori dettagli, consulta le linee guida sui link diretti seguire.

  • Riproduzione: se il tuo servizio monitora lo stato di un utente, la riproduzione deve iniziare da l'indicatore precedente dell'utente sul film o sulla puntata. In caso contrario, la riproduzione deve iniziano dall'inizio dei contenuti.

  • Riproduzione automatica: a seconda della piattaforma, è necessario che il servizio riproduca in evidenza i contenuti dopo che l'utente ha selezionato la puntata o il film di destinazione.

    • Ricerca:la riproduzione automatica è vivamente consigliata, ma non obbligatoria. Se la riproduzione automatica non è supportata, i contenuti devono essere riprodotti con un solo clic dopo che l'utente viene indirizzato alla tua app o al tuo servizio.
    • Android TV: per il film e la puntata è necessaria la riproduzione automatica.

Solo link diretti TVSeries e TVSeason

  • Selezione della puntata target:devi selezionare la puntata target corretta. Se il tuo servizio monitora lo stato di un utente, la puntata target deve essere la puntata che l'utente ha interrotto la visione. Oppure, se l'utente ha terminato l'ultima puntata guardata, imposta come target l'episodio successivo all'episodio. In caso contrario, la puntata target deve essere una delle seguenti a tua discrezione:

    • TVSeries
      • Il primo episodio della serie. Opzione consigliata per i programmi in serie.
      • Il primo episodio dell'ultima stagione. Consigliato per programmi serializzati di lunga durata.
      • L'ultima puntata. Consigliato per programmi giornalieri o legati alle notizie.
    • TVSeason
      • Il primo episodio della stagione. Opzione consigliata per i programmi in serie.
      • L'ultima puntata. Consigliato per programmi giornalieri o legati alle notizie.

    Un link diretto per TVSeries o TVSeason deve essere statico (non modificabile) e risolvere il problema con la puntata interessata. Non utilizzare il link diretto per una puntata specifica.

    La tabella seguente fornisce diversi esempi che dimostrano i requisiti richiesti logica di selezione delle puntate target per TVSeries, TVSeason e TVEpisode tipi di entità:

    Puntata target se l'utente ha guardato per l'ultima volta S6E24 Puntata target se l'utente non ha guardato nessuna puntata
    Link diretto alla serie
    • S6E24 (se l'utente non ha finito S6E24)
    • S6E25 (se l’utente ha finito di guardare S6E24)

    Il valore sarà uno dei seguenti:

    • Primo episodio della serie
    • Primo episodio dell'ultima stagione
    • Puntata più recente
    Link diretto durante la stagione (S1-S5)
    • L'ultimo episodio della stagione guardato dall'utente oppure primo episodio della stagione se l'utente non ha guardato episodi della stagione.
    • Primo episodio della stagione
    Link diretto durante la stagione (S6)
    • S6E24 (se l'utente non ha finito S6E24)
    • S6E25 (se l’utente ha finito di guardare S6E24)

    Il valore sarà uno dei seguenti:

    • Primo episodio della stagione
    • Puntata più recente
    Link diretto della puntata
    • La puntata specifica su cui è stato fatto clic.
    • La puntata specifica su cui è stato fatto clic.

Comportamento di riproduzione delle azioni di ascolto

Per le Azioni di ascolto, richiediamo il seguente comportamento di riproduzione:

  • I contenuti devono essere riprodotti con un solo clic dopo che l'utente viene indirizzato alla tua app o al tuo servizio.
  • Se la tua app o piattaforma richiede l'accesso, devi riprodurre i contenuti immediatamente o entro un clic dopo l'accesso.
  • L'app o la piattaforma deve offrire a tutti gli utenti almeno un modo per riprodurre il brano, l'album, l'artista o la playlist esatti.
    • Per gli utenti non idonei a riprodurre i contenuti esatti (ad esempio, non hanno l'abbonamento richiesto), il servizio deve spiegare cosa deve fare l'utente per ottenere l'idoneità a riprodurre i contenuti esatti all'arrivo nella tua app o piattaforma.

Consigliamo le seguenti best practice per la tua app o piattaforma:

  • Per MusicGroup, riproduci contenuti diversi dell'artista ogni volta che viene selezionato da un utente.
  • Per MusicAlbum, riproduci i contenuti in ordine di apparizione nell'album.
  • Per MusicPlaylist, riproduci contenuti diversi della playlist ogni volta che un utente la seleziona.

Segui questi passaggi:

  1. Controlla se per ogni contenuto sono presenti link diretti diversi in base alla piattaforma.
  2. Per ogni link diretto, poni le seguenti domande sul relativo punto di ingresso (la pagina dell'app o della piattaforma a cui rimanda il link diretto):
    • Il punto di accesso (non i contenuti) supporta più lingue?
    • Il punto di ingresso supporta più lingue per i sottotitoli?
    • Il punto di ingresso supporta diverse angolazioni di ripresa?
    • Il punto di ingresso supporta più formati video?

Se la risposta a una di queste domande è positiva, devi indicare la proprietà additionalProperty del link diretto. Vedi l'esempio di additionalProperty.

Indietro
Raccogli i metadati
Avanti
Identifica il requisito di accesso