Identifica i link diretti specifici della piattaforma dei tuoi contenuti

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

Deep link

Di seguito sono riportati i requisiti per i link diretti:

• urlTemplate (di un oggetto target) richiede un deep link.
• I link diretti devono aprire i contenuti a cui rimandano su tutte le piattaforme specificate.
• I deep link possono includere parametri (&) o anchor tag (#).
  • Se la riproduzione automatica non è attivata per impostazione predefinita, ti consigliamo di aggiungere un parametro, ad esempio &autoplay=true, al deep link per attivare la funzionalità di riproduzione automatica sulla tua app o piattaforma.

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

Utilizzare i deep link per avviare la riproduzione

Il seguente pseudocodice rappresenta il comportamento desiderato quando un utente avvia la 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 i seguenti requisiti specifici della piattaforma:

iOS

Devi utilizzare i link universali.

Android e Android TV

Puoi utilizzare i link per app Android o i link con schema personalizzato.

Link di schemi personalizzati per Android e Android TV

Su Android e Android TV, puoi anche utilizzare link di schema personalizzati. Il package_id della tua app deve essere incluso nell'URI dello schema personalizzato. In questo modo, se l'app non è installata, l'utente viene indirizzato alla pagina dell'app sul Play Store. Pertanto, i seguenti formati URI sono gli unici formati di schema personalizzato accettabili per le Azioni multimediali:

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

Ad esempio:

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

Per maggiori 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 seguente, non sono accettabili come link con schema personalizzato per le Azioni multimediali:

scheme://{path}

Ad esempio:

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

Best practice

Nel caso in cui l'app non sia installata e non disponi di un web player, configura il server web in modo che reindirizzi automaticamente l'utente a Google Play o all'App Store per installare l'app. Per il reindirizzamento, utilizza Firebase Dynamic Links o piattaforme di smart link di terze parti.

Nel caso in cui l'app non sia installata e tu abbia un web player, fornisci un link o un banner intelligente all'Android Store o all'App Store in modo che gli utenti possano installare la tua app. Di seguito è riportato un esempio di banner intelligente implementato:

Riepilogo dei requisiti e delle limitazioni dei link diretti

La tabella seguente mostra i requisiti e le limitazioni per i deep link, in relazione a iOS, Android e Android TV:

Tipi di piattaforma

Per assicurarti che i tuoi contenuti siano disponibili sulle varie piattaforme Google che supportano le Azioni multimediali, rispetta i seguenti requisiti:

• Tutte le piattaforme supportate dai partner richiedono un link diretto per i tuoi contenuti.
• Per le piattaforme Chromecast, devi creare un ricevitore utilizzando l'ultimo SDK CAF Receiver.
• Per le piattaforme mobile (Android e iOS), consulta i requisiti nella sezione Utilizzare link diretti per avviare la riproduzione.

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

Esempio di un'entità con due deep link 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, richiediamo la riproduzione automatica dei contenuti selezionati. In questo modo, gli utenti possono iniziare rapidamente a guardare o ascoltare i contenuti.

Comportamento di riproduzione delle Azioni di visualizzazione

Per le Azioni per Watch, richiediamo il seguente comportamento di riproduzione.

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

• Comportamento di accesso o acquisto:se il tuo servizio richiede l'accesso o l'acquisto, il film o l'episodio deve essere riprodotto, a seconda del tipo, in seguito. Per ulteriori dettagli, consulta le linee guida per i link diretti riportate di seguito.

• Riproduzione:se il tuo servizio monitora lo stato di un utente, la riproduzione deve iniziare dal segnalibro precedente dell'utente sul film o sull'episodio. In caso contrario, la riproduzione deve iniziare dall'inizio dei contenuti.

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

  • Ricerca:la riproduzione automatica è altamente 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:la riproduzione automatica è obbligatoria per film ed episodi.

Solo deep link TVSeries e TVSeason

• Selezione dell'episodio target:devi selezionare l'episodio target corretto. Se il tuo servizio tiene traccia dello stato di un utente, l'episodio di destinazione deve essere l'episodio che l'utente ha interrotto per ultimo. In alternativa, se l'utente ha terminato completamente l'episodio che stava guardando, imposta come episodio di destinazione l'episodio successivo. In caso contrario, l'episodio di destinazione deve essere uno dei seguenti a tua discrezione:

  • TVSeries
    • Il primo episodio della serie. Consigliato per le serie.
    • La prima puntata dell'ultima stagione. Consigliato per serie a lunga durata.
    • L'ultima puntata. Consigliato per programmi giornalieri o di notizie.
  • TVSeason
    • La prima puntata della stagione. Consigliato per le serie.
    • L'ultima puntata. Consigliato per programmi giornalieri o di notizie.

  Un link diretto per TVSeries o TVSeason deve essere statico (non modificabile) e risolversi nell'episodio di destinazione. Non utilizzare il link diretto per un episodio specifico.

  La seguente tabella fornisce diversi esempi che illustrano la logica di selezione degli episodi di destinazione richiesta per i tipi di entità TVSeries, TVSeason e TVEpisode:

  	Episodio target se l'utente ha guardato per ultimo l'episodio 24 della stagione 6	Targeting dell'episodio se l'utente non ha guardato alcun episodio
  Deep link della serie	S6E24 (se l'utente non ha terminato l'episodio) S6E25 (se l'utente ha terminato la visione di S6E24)	Uno dei documenti seguenti: Primo episodio della serie Primo episodio dell'ultima stagione Puntata più recente
  Deep link della stagione (S1-S5)	L'ultimo episodio guardato dall'utente in quella stagione o il primo episodio della stagione se l'utente non ha guardato alcun episodio in quella stagione.	Primo episodio della stagione
  Link diretto alla stagione (S6)	S6E24 (se l'utente non ha terminato l'episodio) S6E25 (se l'utente ha terminato la visione di S6E24)	Uno dei documenti seguenti: Primo episodio della stagione Puntata più recente
  Deep link dell'episodio	L'episodio specifico su cui è stato fatto clic.	L'episodio specifico su cui è stato fatto clic.

Comportamento di riproduzione di 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, deve riprodurre i contenuti immediatamente o con un solo clic dopo l'accesso.
• La tua app o piattaforma deve offrire almeno un modo per consentire a tutti gli utenti di 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 tuo servizio deve spiegare cosa deve fare l'utente per diventare idoneo a riprodurre i contenuti esatti quando arriva sulla 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 un utente lo seleziona.
• Per MusicAlbum, riproduci i contenuti nell'ordine di visualizzazione nell'album.
• Per MusicPlaylist, riproduci contenuti diversi dalla playlist ogni volta che un utente la seleziona.

Identificare i link diretti

Segui questi passaggi:

1. Per ogni contenuto, controlla se ha deep link diversi in base alle piattaforme.
2. Per ogni link diretto, poni le seguenti domande sul relativo punto di ingresso (la pagina dell'app o della piattaforma a cui ti indirizza il link diretto):
   • Il punto di accesso (non i contenuti) supporta più lingue?
   • Il punto di contatto supporta più lingue per i sottotitoli codificati?
   • Il punto di ingresso supporta più angolazioni della videocamera?
   • Il punto di contatto supporta più formati video?

Se la risposta a una di queste domande è sì, devi fornire la proprietà additionalProperty per quel link diretto. Vedi l'esempio di additionalProperty.