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 mewakili 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 mencapai 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 diarahkan ke halaman aplikasi Anda di 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, konfigurasikan server web Anda untuk otomatis mengalihkan pengguna ke Android atau App Store untuk menginstal aplikasi Anda. Untuk mengalihkan, gunakan Dynamic Links Firebase atau platform smart link pihak ketiga.

Jika aplikasi Anda belum diinstal dan Anda memiliki pemutar web, berikan link atau banner smart ke Android atau App Store agar pengguna dapat menginstal aplikasi Anda. Berikut adalah contoh banner smart yang diterapkan:

Contoh banner pintar yang diterapkan

Tabel berikut menunjukkan persyaratan dan batasan untuk deep link, karena terkait 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 beberapa platform Google (Penelusuran, Asisten, Android TV, dan Chromecast), 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 Hanya Tindakan Dengarkan. 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: Movie, TVEpisode, TVSeries, dan TVSeason

  • Perilaku login atau pembelian: Jika layanan Anda memerlukan login atau pembelian, film atau episode harus diputar, sesuai dengan jenisnya, setelah itu. Untuk mengetahui detail selengkapnya, lihat panduan deep link yang berikut.

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

  • Putar Otomatis: Bergantung pada platform, 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.

Khusus deep link TVSeries dan TVSeason

  • Pilihan episode target: Anda harus memilih episode target yang tepat. Jika layanan Anda melacak status pengguna, episode target harus berupa episode yang terakhir kali dihentikan pengguna. Atau, jika pengguna benar-benar menyelesaikan episode yang terakhir ditonton, buat episode target menjadi episode berikutnya. Jika tidak, episode target harus berupa salah satu dari berikut ini sesuai kebijaksanaan Anda:

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

    Deep link untuk TVSeries atau TVSeason harus bersifat statis (tidak berubah) dan me-resolve 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:

    Episode target jika pengguna terakhir kali menonton S6E24 Menargetkan episode jika pengguna belum menonton episode apa pun
    Deep link serial
    • S6E24 (jika pengguna belum menyelesaikan S6E24)
    • S6E25 (jika pengguna telah selesai menonton S6E24)

    Salah satu dari berikut ini:

    • Episode pertama serial
    • Episode pertama di season terbaru
    • Episode terbaru
    Deep link musim (S1-S5)
    • Episode mana pun yang terakhir ditonton pengguna di season tersebut, atau episode pertama season 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 Listen Actions

Untuk Tindakan Dengarkan, kami memerlukan 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 segera memutar konten 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 tepat.
    • Untuk pengguna yang tidak memenuhi syarat untuk memutar konten yang tepat (misalnya, mereka tidak memiliki langganan yang diperlukan), layanan Anda harus menjelaskan hal yang perlu dilakukan pengguna agar memenuhi syarat untuk memutar konten yang tepat saat membuka aplikasi atau platform Anda.

Sebaiknya lakukan 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 kemunculan 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 entrinya (halaman di aplikasi atau platform tempat deep link mengarahkan Anda):
    • Apakah titik entri (bukan konten) mendukung beberapa bahasa?
    • Apakah titik entri mendukung beberapa bahasa subtitel?
    • Apakah titik entri mendukung beberapa sudut kamera?
    • Apakah titik entri mendukung beberapa format video?

Jika jawaban Anda 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