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

Kode semu 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:

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. Aplikasi Anda package_id harus disertakan dalam URI skema kustom. Hal ini memastikan bahwa pengguna diarahkan ke halaman aplikasi Anda di Play Store jika aplikasi tidak 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 yang mengikutinya, tidak dapat diterima link skema 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 agar secara otomatis mengalihkan pengguna ke Android atau App Store untuk menginstal aplikasi. Untuk mengalihkan, gunakan link dinamis Firebase atau platform smart link pihak ketiga.

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

Contoh banner cerdas yang diterapkan

Tabel berikut menunjukkan persyaratan dan batasan untuk deep link, karena 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 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 Transmisi dan Home di perangkat Chromecast.
http://schema.googleapis.com/GoogleAudioCast Hanya Tindakan Dengarkan. Platform Transmisi dan Home di perangkat Chromecast.

Contoh entitas 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 memutar otomatis konten yang dipilih. Hal ini memungkinkan pengguna untuk memulai dengan cepat menonton atau mendengarkan konten.

Perilaku pemutaran Tindakan Menonton

Untuk Watch Actions, kami memerlukan perilaku pemutaran berikut.

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

  • Perilaku login atau pembelian: Jika layanan Anda memerlukan proses login atau membeli, film atau episode harus diputar, sebagaimana mestinya ketik, setelahnya. Untuk detail selengkapnya, lihat panduan deep link yang mengikuti.

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

  • Putar Otomatis: Bergantung pada platform, layanan Anda harus memutar konten dengan 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 sekali 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 berupa episode yang terakhir kali pengguna berhenti menonton. Atau, jika pengguna benar-benar menyelesaikan yang terakhir mereka tonton, jadikan episode target sebagai episode berikutnya episode. Jika tidak, episode target harus berupa salah satu dari berikut atas pertimbangan Anda sendiri:

    • TVSeries
      • Episode pertama serial. Direkomendasikan untuk acara serial.
      • Episode pertama di season terbaru. Direkomendasikan untuk serial berdurasi panjang.
      • Episode terbaru. Direkomendasikan untuk acara harian atau yang berkaitan dengan berita.
    • TVSeason
      • Episode pertama season. Direkomendasikan untuk acara serial.
      • Episode terbaru. Direkomendasikan untuk acara harian atau yang berkaitan dengan berita.

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

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

    Episode target jika pengguna terakhir kali menonton S6E24 Target 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 ini
    • Episode pertama di season terbaru
    • Episode terbaru
    Deep link season (S1-S5)
    • Episode mana pun yang terakhir ditonton pengguna di season tersebut, atau episode pertama season ini jika pengguna belum menontonnya episode dalam season tersebut.
    • Episode pertama musim ini
    Deep link season (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 Dengarkan

Untuk Tindakan Dengarkan, kami memerlukan perilaku pemutaran berikut:

  • Konten harus diputar dalam sekali klik setelah pengguna diarahkan ke aplikasi atau layanan Anda.
  • Jika aplikasi atau platform Anda memerlukan login, konten harus segera diputar atau dalam sekali 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.
    • Bagi pengguna yang tidak memenuhi syarat untuk memutar konten yang tepat (misalnya, mereka tidak memiliki langganan yang diperlukan), layanan Anda harus menjelaskan apa yang perlu dilakukan pengguna agar memenuhi syarat untuk memutar konten yang tepat setelah 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 tampilan 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 yang dituju deep link):
    • 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 untuk salah satu pertanyaan ini adalah ya, Anda harus menyediakan properti additionalProperty untuk deep link tersebut. Lihat contoh additionalProperty.

Sebelumnya
Mengumpulkan Metadata
Berikutnya
Mengidentifikasi Persyaratan Akses