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 della tua app o piattaforma utilizzando il link diretto dei contenuti.

Link diretto

Di seguito sono riportati i requisiti per i link diretti:

• urlTemplate (di un oggetto target) 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 tag di ancoraggio (#).
  • Se la riproduzione automatica non è attivata per impostazione predefinita, ti consigliamo di aggiungere un parametro, ad esempio &autoplay=true, al link diretto per attivare la funzionalità di riproduzione automatica nella 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 link diretti 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 agli schemi personalizzati per Android e Android TV

Su Android e Android TV, puoi anche utilizzare i link agli schemi personalizzati. Il valore package_id della tua app deve essere incluso nell'URI dello schema personalizzato. In questo modo, se l'app non è installata, l'utente verrà 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 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 riportato di seguito, non sono link a schemi personalizzati accettabili per le azioni multimediali:

scheme://{path}

Ad esempio:

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

Best practice

Se la tua app non è installata e non hai un player web, configura il tuo server web in modo da reindirizzare automaticamente l'utente ad Android o all'App Store per installare la tua app. Per il reindirizzamento, utilizza i link dinamici di Firebase o piattaforme di smart link di terze parti.

Se la tua app non è installata e hai un player web, fornisci un link o uno smart banner all'Android Store o all'App Store per consentire agli utenti di installarla. Di seguito è riportato un esempio di smart banner implementato:

Riepilogo dei requisiti e delle limitazioni dei link diretti

La tabella seguente mostra i requisiti e le limitazioni per i link diretti relativi a iOS, Android e Android TV:

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:

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

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

Esempio di 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, ti chiediamo di attivare la riproduzione automatica dei contenuti selezionati. In questo modo, gli utenti possono iniziare rapidamente a guardare o ascoltare i contenuti.

Comportamento di riproduzione di Watch Actions

Per le azioni sullo smartwatch, è richiesto 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 un acquisto, il film o la puntata devono essere riprodotti in seguito, a seconda del tipo. Per ulteriori dettagli, consulta le linee guida sui link diretti riportate di seguito.

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

• Riproduzione automatica:a seconda della piattaforma, è necessario che il tuo 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 entro un clic dopo che l'utente è stato indirizzato alla tua app o al tuo servizio.
  • Android TV: la riproduzione automatica è obbligatoria per i film e le puntate.

Solo link diretti a TVSeries e TVSeason

• Selezione della puntata di destinazione: devi selezionare la puntata di destinazione corretta. Se il tuo servizio monitora lo stato di un utente, la puntata di destinazione deve essere quella che l'utente ha smesso di guardare per ultima. In alternativa, se l'utente ha completato completamente la puntata che stava guardando per ultima, imposta come puntata di destinazione la puntata successiva. In caso contrario, l'episodio di destinazione deve essere uno dei seguenti a tua discrezione:

  • TVSeries
    • La prima puntata della serie. Consigliata per i programmi in serie.
    • La prima puntata dell'ultima stagione. Consigliata per programmi serializzati di lunga durata.
    • L'ultima puntata. Consigliato per programmi giornalieri o relativi alle notizie.
  • TVSeason
    • La prima puntata della stagione. Consigliata per i programmi in serie.
    • L'ultima puntata. Consigliato per programmi giornalieri o relativi alle notizie.

  Un link diretto per TVSeries o TVSeason deve essere statico (non modificabile) e deve risolvere nell'episodio target. Non utilizzare il link diretto per una puntata specifica.

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

  	Puntata target se l'utente ha guardato per ultima volta la S6E24	Puntata target se l'utente non ha guardato nessuna puntata
  Link diretto alla serie	S6E24 (se l'utente non ha completato la puntata S6E24) S6E25 (se l'utente ha terminato la visione della puntata S6E24)	Il valore sarà uno dei seguenti: Prima puntata della serie Prima puntata dell'ultima stagione Puntata più recente
  Link diretto alla stagione (S1-S5)	L'ultimo episodio guardato dall'utente nella stagione o il primo episodio della stagione se l'utente non ha guardato nessun episodio della stagione.	Prima puntata della stagione
  Link diretto alla stagione (S6)	S6E24 (se l'utente non ha completato la puntata S6E24) S6E25 (se l'utente ha terminato la visione della puntata S6E24)	Il valore sarà uno dei seguenti: Prima puntata della stagione Puntata più recente
  Link diretto alla 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, è richiesto il seguente comportamento di riproduzione:

• I contenuti devono essere riprodotti entro un clic dopo che l'utente è stato indirizzato alla tua app o al tuo servizio.
• Se la tua app o piattaforma richiede l'accesso, deve riprodurre i contenuti immediatamente o entro un clic dopo l'accesso.
• La tua app o 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 alla riproduzione dei contenuti esatti (ad esempio, perché non dispongono dell'abbonamento richiesto), il tuo servizio deve spiegare cosa deve fare l'utente per diventare idoneo alla riproduzione dei contenuti esatti quando arriva nella tua app o sulla tua 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 in cui appaiono nell'album.
• Per MusicPlaylist, riproduci contenuti diversi della playlist ogni volta che un utente la seleziona.

Identifica i link diretti

Segui questi passaggi:

1. Per ogni contenuto, controlla se sono presenti link diretti diversi in base alle piattaforme.
2. Per ogni link diretto, poni le seguenti domande sul relativo punto di contatto (la pagina della tua app o piattaforma a cui rimanda il link diretto):
   • Il punto di contatto (non i contenuti) supporta più lingue?
   • Il punto di contatto supporta più lingue dei sottotitoli?
   • Il punto di contatto supporta più angolazioni della fotocamera?
   • Il punto di contatto supporta più formati video?

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