Identifikasi deep link khusus platform konten Anda

Saat pengguna memulai Tindakan Media pada konten (misalnya, pengguna mengklik ikon Anda di Google Penelusuran), Google akan mengarahkan pengguna langsung ke konten di aplikasi atau platform Anda menggunakan deep link konten.

Berikut adalah persyaratan untuk deep link:

  • urlTemplate (dari objek target) memerlukan deep link.
  • Deep link harus membuka konten yang ditargetkan di semua platform yang ditentukan.
  • Deep link dapat menyertakan parameter (&) atau tag anchor (#).
    • Jika putar otomatis tidak diaktifkan secara default, sebaiknya tambahkan parameter, seperti &autoplay=true, ke deep link untuk mengaktifkan fitur putar otomatis di aplikasi atau platform Anda.

Contoh @id, url, dan 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",
       ...
     },
   ...
   },
   ...
}

Pseudocode berikut menunjukkan perilaku yang diinginkan saat pengguna memulai pemutaran:

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

Untuk mendapatkan perilaku pemutaran yang diinginkan, patuhi persyaratan khusus platform berikut:

iOS
Anda harus menggunakan Link Universal.
Android dan Android TV
Anda dapat menggunakan Link Aplikasi Android atau link skema kustom.

Di Android dan Android TV, Anda juga dapat menggunakan link skema kustom. package_id aplikasi Anda harus disertakan dalam URI skema kustom. Hal ini memastikan bahwa pengguna akan diarahkan ke halaman aplikasi Anda di Google Play Store jika aplikasi Anda belum diinstal. Oleh karena itu, format URI berikut adalah satu-satunya format skema kustom yang dapat diterima untuk Tindakan Media:

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

Contoh:

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

Untuk mengetahui detail selengkapnya, lihat spesifikasi lengkap.

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

Contoh:

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

Format URI lainnya, seperti contoh berikut, bukan link skema kustom yang dapat diterima untuk Tindakan Media:

scheme://{path}

Contoh:

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

Praktik terbaik

Jika aplikasi Anda tidak diinstal dan Anda tidak memiliki pemutar web, konfigurasi server web Anda untuk mengalihkan pengguna secara otomatis ke Android atau App Store untuk menginstal aplikasi Anda. Untuk mengalihkan, gunakan Dynamic Links Firebase atau platform link smart pihak ketiga.

Jika aplikasi Anda tidak diinstal dan Anda memiliki pemutar web, berikan link atau banner smart ke Play Store atau App Store untuk pengguna menginstal aplikasi Anda. Berikut adalah contoh banner smart yang diterapkan:

Contoh banner cerdas yang diterapkan

Tabel berikut menunjukkan persyaratan dan batasan untuk deep link, sebagaimana berkaitan dengan iOS, Android, dan AndroidTV:

iOS Android dan AndroidTV
http:// atau https:// Wajib Direkomendasikan jika situs seluler mendukung pemutaran.
android-app:// atau intent:// T/A Direkomendasikan jika situs seluler tidak mendukung pemutaran.
foo:// (string arbitrer) Tidak diizinkan Tidak diizinkan

Jenis platform

Untuk memastikan konten Anda tersedia di berbagai platform Google yang mendukung Tindakan Media, patuhi persyaratan berikut:

Tabel berikut berisi daftar platform yang mendukung Tindakan Media:

Platform Deskripsi
http://schema.org/DesktopWebPlatform Platform penelusuran di browser web desktop.
http://schema.org/MobileWebPlatform Platform penelusuran di browser web seluler.
http://schema.org/AndroidPlatform Platform Penelusuran dan PlayGuide di aplikasi Android.
http://schema.org/AndroidTVPlatform Platform Android TV di aplikasi Android TV.
http://schema.org/IOSPlatform Platform penelusuran di aplikasi iOS.
http://schema.googleapis.com/GoogleVideoCast Platform Cast dan Home di perangkat Chromecast.
http://schema.googleapis.com/GoogleAudioCast Listen Actions only. Platform Cast dan Home di perangkat Chromecast.

Contoh entity dengan dua deep link yang berbeda:

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

Perilaku pemutaran

Untuk sebagian besar konten, saat Google mengarahkan pengguna ke aplikasi atau platform Anda, kami mewajibkan Anda untuk memutar otomatis konten yang dipilih. Hal ini memungkinkan pengguna mulai menonton atau mendengarkan konten dengan cepat.

Perilaku pemutaran Tindakan Menonton

Untuk Tindakan Tonton, kami memerlukan perilaku pemutaran berikut.

Semua deep link: Film, TVEpisode, TVSeries, dan TVSeason

  • Perilaku login atau pembelian: Jika layanan Anda memerlukan login atau pembelian, film atau episode harus diputar, sebagaimana mestinya untuk jenisnya, setelahnya. Untuk mengetahui detail selengkapnya, lihat panduan deep link di bawah.

  • Pemutaran: Jika layanan Anda melacak status pengguna, pemutaran harus dimulai dari penanda sebelumnya pengguna pada film atau episode. Jika tidak, pemutaran harus dimulai dari awal konten.

  • Putar Otomatis: Bergantung pada platformnya, layanan Anda harus memutar konten secara jelas setelah episode atau film target dipilih oleh pengguna.

    • Penelusuran: Putar Otomatis sangat direkomendasikan, tetapi tidak wajib. Jika putar otomatis tidak didukung, konten harus diputar dalam satu klik setelah pengguna diarahkan ke aplikasi atau layanan Anda.
    • Android TV: Putar otomatis diperlukan untuk film dan episode.

Hanya deep link TVSeries dan TVSeason

  • Pemilihan episode target: Anda harus memilih episode target yang tepat. Jika layanan Anda melacak status pengguna, episode target harus merupakan episode yang terakhir kali dihentikan oleh pengguna. Atau, jika pengguna telah menyelesaikan episode yang terakhir ditonton, jadikan episode berikutnya sebagai episode target. Jika tidak, episode target harus berupa salah satu dari berikut ini sesuai pertimbangan Anda:

    • TVSeries
      • Episode pertama serial. Direkomendasikan untuk acara bersambung.
      • Episode pertama dari season terbaru. Direkomendasikan untuk acara bersambung yang berjalan lama.
      • Episode terbaru. Direkomendasikan untuk acara harian atau terkait berita.
    • TVSeason
      • Episode pertama musim ini. Direkomendasikan untuk acara bersambung.
      • Episode terbaru. Direkomendasikan untuk acara harian atau terkait berita.

    Deep link untuk TVSeries atau TVSeason harus statis (tidak berubah) dan mengarah ke episode target. Jangan gunakan deep link untuk episode tertentu.

    Tabel berikut memberikan beberapa contoh yang menunjukkan logika pemilihan episode target yang diperlukan untuk jenis entity TVSeries, TVSeason, dan TVEpisode:

    Menargetkan episode jika pengguna terakhir menonton S6E24 Menargetkan episode jika pengguna belum menonton episode apa pun
    Deep link seri
    • S6E24 (jika pengguna belum menyelesaikan S6E24)
    • S6E25 (jika pengguna telah selesai menonton S6E24)

    Salah satu dari berikut ini:

    • Episode pertama serial
    • Episode pertama season terbaru
    • Episode terbaru
    Deep link musim (S1-S5)
    • Episode mana pun yang terakhir ditonton pengguna di season tersebut, atau episode pertama di season tersebut jika pengguna belum menonton episode apa pun di season tersebut.
    • Episode pertama musim ini
    Deep link musim (S6)
    • S6E24 (jika pengguna belum menyelesaikan S6E24)
    • S6E25 (jika pengguna telah selesai menonton S6E24)

    Salah satu dari berikut ini:

    • Episode pertama musim ini
    • Episode terbaru
    Deep link episode
    • Episode tertentu yang diklik.
    • Episode tertentu yang diklik.

Perilaku pemutaran Tindakan Mendengarkan

Untuk Tindakan Mendengarkan, kami mewajibkan perilaku pemutaran berikut:

  • Konten harus diputar dalam satu klik setelah pengguna diarahkan ke aplikasi atau layanan Anda.
  • Jika aplikasi atau platform Anda memerlukan login, aplikasi atau platform tersebut harus memutar konten segera atau dalam satu klik setelah login.
  • Aplikasi atau platform Anda harus menawarkan setidaknya satu cara bagi semua pengguna untuk memutar lagu, album, artis, atau playlist yang sama persis.
    • Untuk pengguna yang tidak memenuhi syarat untuk memutar konten yang sama persis (misalnya, mereka tidak memiliki langganan yang diperlukan), layanan Anda harus menjelaskan apa yang perlu dilakukan pengguna agar memenuhi syarat untuk memutar konten yang sama persis saat tiba di aplikasi atau platform Anda.

Kami merekomendasikan praktik terbaik berikut untuk aplikasi atau platform Anda:

  • Untuk MusicGroup, putar konten yang berbeda dari artis setiap kali pengguna memilih artis.
  • Untuk MusicAlbum, putar konten sesuai urutan kemunculannya di album.
  • Untuk MusicPlaylist, putar konten yang berbeda dari playlist setiap kali pengguna memilih playlist.

Lakukan hal berikut:

  1. Untuk setiap konten, periksa apakah konten tersebut memiliki deep link yang berbeda berdasarkan platform.
  2. Untuk setiap deep link, ajukan pertanyaan berikut tentang titik masuknya (halaman di aplikasi atau platform yang dituju deep link):
    • Apakah titik entri (bukan konten) mendukung beberapa bahasa?
    • Apakah titik entri mendukung beberapa bahasa subtitle?
    • Apakah titik entri mendukung beberapa sudut kamera?
    • Apakah titik entri mendukung beberapa format video?

Jika jawaban Anda adalah ya untuk salah satu pertanyaan ini, Anda harus memberikan properti additionalProperty untuk deep link tersebut. Lihat contoh additionalProperty.

Sebelumnya
Mengumpulkan Metadata
Berikutnya
Mengidentifikasi Persyaratan Akses