Pertanyaan umum (FAQ) terkait Engage SDK

FAQ terkait Publikasi

Siapa yang mengelola tugas publikasi konten?

Developer aplikasi mengelola tugas publikasi konten dan mengirim permintaan ke Layanan Engage. Dengan cara ini, partner developer memiliki lebih banyak kontrol atas waktu dan cara memublikasikan konten kepada pengguna. Anda tidak akan terlalu sering mengaktifkan aplikasi partner untuk memublikasikan konten.

Apakah developer perlu memublikasikan semua jenis cluster?

Meskipun secara teknis developer bebas memublikasikan satu cluster saja, kami sangat menyarankan untuk menyertakan lebih banyak cluster. Jika tidak, developer akan melewatkan peluang untuk mendorong interaksi yang lebih baik dengan konten mereka. Sebaiknya publikasikan semua jenis cluster untuk setiap kategori.

Seberapa sering partner developer harus memublikasikan data menggunakan pengelola kerja saat aplikasi berjalan?

Hal ini akan diputuskan oleh partner developer. Google merekomendasikan publikasi sekali atau dua kali per hari untuk konten rekomendasi umum, dan menggunakan metodologi berbasis peristiwa untuk keranjang belanja, pemesanan ulang, dan konten kelanjutan lainnya (misalnya, memulai worker sebagai callback pengguna yang menambahkan item ke keranjang atau pengguna yang menghentikan film di tengah jalan). Untuk aplikasi sosial, penting untuk memublikasikan cluster rekomendasi yang diperbarui setelah setiap penggunaan aplikasi. Pengguna aplikasi media sosial lebih tertarik dengan rekomendasi terbaru dan idealnya ingin melihat postingan maksimal sekali.

Kapan sebaiknya developer memanggil API penghapusan?

API penghapusan hanya boleh dipanggil jika tidak ada konten untuk dipublikasikan. Jangan memanggil API penghapusan dan publikasi secara berurutan untuk mengganti konten; API publikasi menghapus konten sebelumnya secara otomatis.

FAQ terkait Intent Siaran

Mengapa developer aplikasi Android perlu mendaftar untuk intent siaran?

Untuk menayangkan konten baru kepada pengguna, Anda harus menggunakan intent siaran untuk memicu sinkronisasi data ketika pengguna mungkin tidak sering menggunakan aplikasi.

Tidak dapat menguji intent siaran

Aplikasi verifikasi tidak mendukung pengujian intent siaran dengan izin. Anda harus menghapus izin saat pengujian dan menambahkannya kembali sebelum mengalihkan SDK ke versi produksi di Langkah 6.

Eksekusi latar belakang tidak diizinkan

Saat mendaftarkan intent siaran, Anda mungkin menemukan error berikut:

Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }

Anda harus mendaftarkan penerima siaran secara dinamis.

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION,
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null));
...

}

FAQ terkait Alur Kerja

Saat berintegrasi dengan SDK, Anda mungkin menemukan error berikut:

Error validasi di tingkat aplikasi, cluster, entitas

Ringkasan di tingkat aplikasi, cluster, dan entity menampilkan jumlah error validasi. Error ini terkait dengan kolom wajib yang tidak ada atau nilai yang tidak valid yang diberikan. Pesan error akan muncul dalam warna merah di bawah setiap kolom yang relevan. Perbaiki semua error validasi dan periksa kebenarannya sebelum membagikan APK.

Deep link dikaitkan dengan nama paket. Cara yang baik untuk menguji deep link adalah dengan menggunakan alat adb.

adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>

Deep link adalah cara yang bagus untuk melacak atribusi. URL deep link yang mengarahkan pengguna ke aplikasi Anda dapat disertakan dengan parameter pelacakan tambahan. Misalnya - "http://xx/deeplink?source_tag=engage".

Developer dapat menambahkan parameter pelacakan mereka sendiri dan memberikan atribusi untuk menghitung dampak.

FAQ Engage for TV 2.0

Pertanyaan Umum

Apa itu Engage?

Engage meningkatkan pengalaman "melanjutkan aktivitas terakhir" ke level berikutnya. Ini adalah upgrade signifikan yang memungkinkan penonton melanjutkan konten mereka dengan lancar di berbagai perangkat. Bayangkan Anda memulai film di Google TV, lalu melanjutkannya dengan mudah di ponsel saat dalam perjalanan – itulah keunggulan Engage.

Sistem baru ini dirancang untuk meningkatkan interaksi dan retensi penonton dengan memberikan pengalaman yang lancar dan tanpa hambatan di seluruh ekosistem Google.

Apakah Video Discovery API sama dengan Engage?

Ya, keduanya sama. Engage SDK adalah library yang menyertakan dukungan untuk baris lanjutkan menonton. Engage mendukung lebih banyak jenis entity konten selain video, sehingga integrasi ini tidak lagi bernama "Penemuan Video".

Apa saja manfaat menggunakan Engage?

Jawaban: Engage memudahkan penonton untuk melanjutkan konten Anda dari bagian terakhir yang mereka tonton, apa pun perangkat yang mereka gunakan. Berikut caranya:

  • Pengalaman lancar di seluruh Google: Mulai menonton di Google TV, dan lanjutkan dengan lancar di ponsel Android, iPhone, atau tablet Android Anda. Fitur ini bahkan berfungsi di perangkat yang belum menginstal aplikasi.
  • Peningkatan engagement dan retensi: Engage membantu mendorong pengguna untuk kembali ke aplikasi Anda, bahkan di perangkat baru. Dengan mengizinkan pengguna melanjutkan acara favorit mereka, Anda meningkatkan peluang mereka untuk terus menonton.
  • Jangkauan yang lebih luas: Selain Google TV, Engage berfungsi di seluruh pengalaman media Android lainnya, seperti Koleksi Play dan aplikasi media Google lainnya.
  • Kompatibel dengan versi lama: Jika Anda sudah menggunakan fitur "Tonton Berikutnya" yang lebih lama, tidak masalah. Engage kompatibel dengan versi lama, sehingga integrasi Anda yang ada akan tetap berfungsi.

Catatan Penting: Semua integrasi Lanjutkan Menonton yang baru harus menggunakan Engage. Sistem "Mainkan Berikutnya di Berbagai Perangkat" yang lama akan dihentikan secara bertahap.

Platform apa yang mendukung Engage?

  1. Google TV
  2. Android TV (hanya di perangkat, tetapi mendukung Engage SDK)
  3. Aplikasi seluler Android Google TV
  4. Aplikasi seluler Google TV iOS
  5. Koleksi Play
  6. Google Entertainment Space
  7. Perangkat iOS (dengan integrasi REST API).

Apakah Engage SDK ditujukan untuk Lanjutkan Menonton?

Ya, Engage SDK mendukung konten untuk baris lanjutkan menonton. Hal ini diperlukan untuk berintegrasi dengan Engage.

Apakah Engage tersedia untuk semua orang?

Engage diluncurkan secara bertahap.

  • Akses Awal: Kami awalnya memberikan akses kepada sekelompok partner tertentu melalui Program Akses Awal (EAP).
  • Memperluas Akses: Kami berupaya keras agar Engage segera tersedia untuk semua developer.

Untuk peluncuran yang lancar dan sukses, kami memiliki pengamanan untuk mengelola peluncuran. Hal ini melibatkan daftar yang diizinkan di sisi Engage dan pemeriksaan terpisah dalam Engage SDK. Baik Anda adalah partner EAP atau ingin segera bergabung, hubungi kami agar kami dapat menyiapkan izin akses sebelum Anda memulai integrasi Engage SDK.

Persyaratan gambar telah diperbarui di bagian Membuat Entity.

Dengan dokumentasi API baru ini, apakah data Lanjutkan Menonton akan ditarik oleh server Google dari klien dan apakah data tersebut akan ditampilkan di semua perangkat?

API baru ini menawarkan peningkatan signifikan untuk konten di baris lanjutkan menonton, termasuk:

  • Pengalaman lancar di seluruh Google TV: Pengguna dapat mulai menonton di satu Google TV dan melanjutkan di Google TV lain yang login dengan akun yang sama. Fitur ini juga berfungsi dengan Android TV versi lama.

  • Integrasi aplikasi seluler: Konten dari Engage ditampilkan di aplikasi seluler Google TV untuk Android dan iOS, sehingga pengguna dapat beralih dengan lancar antara TV dan perangkat seluler.

  • Peningkatan retensi pengguna: Bahkan di perangkat yang tidak menginstal aplikasi atau tempat pengguna tidak login, konten di baris lanjutkan menonton mendorong pengguna untuk berinteraksi kembali dengan aplikasi Anda, sehingga meningkatkan retensi.

  • Perluasan ke platform lain: Engage diperluas ke platform media Google lainnya seperti Android, Kumpulan Koleksi Play, tablet, serta aplikasi & platform media Google lainnya di Android, sehingga memaksimalkan engagement pengguna di berbagai perangkat.

Berapa batas jumlah entitas yang dapat saya publikasikan ke cluster Continuation?

Setiap partner developer dibatasi hingga maksimum 5 entity di cluster Lanjutan. Batas ini ditujukan untuk distribusi konten yang adil di baris "lanjutkan menonton" di Google TV, yang merupakan ruang bersama untuk beberapa penyedia media.

Apa yang terjadi jika saya mencoba memublikasikan lebih dari 5 entitas?

Engage SDK akan menolak permintaan publikasi Anda jika melebihi batas 5 entitas. Anda harus mengurangi jumlah entitas dalam permintaan agar berhasil memublikasikan. Anda hanya boleh menyertakan entitas yang belum selesai ditonton pengguna, jadi dalam kebanyakan kasus, hanya akan ada beberapa entitas seperti itu. Jika ada lebih dari 5 entitas tersebut, Anda dapat memilih entitas yang lebih baru untuk dipublikasikan.

Mengapa ada batasan jumlah entitas?

Baris lanjutkan menonton di Google TV menampilkan konten dari berbagai penyedia media. Membatasi jumlah entitas per penyedia sehingga pengguna melihat pilihan konten yang beragam dari semua sumber favorit mereka, sehingga mendorong pengalaman pengguna yang adil dan seimbang.

Pertanyaan Terkait Aplikasi Verifikasi

Apakah saya wajib menguji aplikasi saya dengan aplikasi verifikasi sebelum mengirimkannya?

Ya, menguji aplikasi Anda dengan aplikasi verifikasi sangat penting sebelum mengirimkan APK Anda.

Meskipun kami memahami bahwa Anda mungkin yakin dengan penerapan Anda, integrasi Engage memiliki banyak komponen yang rumit. Aplikasi verifikasi berfungsi sebagai jaring pengaman, yang mendeteksi potensi masalah sejak dini dan menghemat waktu serta upaya Anda yang berharga dalam jangka panjang.

Anggap saja sebagai pemeriksaan cepat yang membantu menjamin peluncuran yang lancar dan pengalaman pengguna yang luar biasa.

Dengan mengidentifikasi dan mengatasi masalah apa pun sebelumnya, Anda dapat menghindari frustrasi akibat penolakan dan pengiriman ulang.

Untuk mengirimkan APK, Anda harus menyertakan screenshot yang menunjukkan bahwa aplikasi Anda telah lulus proses verifikasi.

Apa saja kesalahan umum yang harus diwaspadai selama integrasi?

Aplikasi verifikasi dirancang untuk mendeteksi potensi masalah pada integrasi Engage Anda. Berikut beberapa kesalahan umum yang sering dihadapi developer:

Untuk semua jenis konten (film, episode TV, live stream, klip video):

  • Link Tidak Ada: Pastikan Anda memberikan URI (link) khusus platform yang valid untuk konten Anda. Link ini memberi tahu sistem tempat menemukan konten Anda di setiap platform.
  • Judul Tidak Ada: Jangan lupa menyertakan judul untuk semua konten Anda. Hal ini membantu pengguna mengidentifikasi apa yang mereka tonton.
  • Rasio Aspek Gambar: Pastikan semua gambar yang terkait dengan konten Anda memiliki rasio aspek mendekati 16:9. Tindakan ini memastikan gambar Anda ditampilkan dengan benar di berbagai layar.

Untuk Episode TV:

  • Lengkapi Informasi Episode: Pastikan untuk menyertakan judul acara, nomor episode, dan nomor season. Hal ini membantu mengatur episode dan memungkinkan pengguna menjelajahi serial.
  • Posisi Pemutaran yang Akurat: Periksa kembali apakah posisi pemutaran terakhir kurang dari atau sama dengan total durasi episode. Hal ini memastikan pengguna melanjutkan dari titik yang benar.

Untuk Film:

  • Posisi Pemutaran yang Akurat: Mirip dengan episode TV, verifikasi bahwa posisi pemutaran terakhir sudah akurat.

Untuk Video Live Streaming:

  • Informasi Penyiar: Sertakan nama penyiar untuk live stream.

Untuk Klip Video:

  • Informasi Kreator: Tentukan kreator klip video.

Ingat: Aplikasi verifikasi akan menandai masalah ini, sehingga Anda dapat memperbaikinya sebelum mengirimkan aplikasi. Hal ini menghemat waktu Anda dan memastikan pengalaman yang lebih lancar bagi pengguna.

Pertanyaan Terkait Akun dan Profil

Aplikasi saya menggunakan login pengguna anonim. Apakah AccountProfile masih diperlukan untuk Engage?

AccountProfile dirancang untuk aplikasi yang menggunakan akun pengguna perorangan. Namun, kami memahami bahwa beberapa aplikasi, seperti aplikasi Anda, mungkin mengandalkan login anonim. Berikut cara kerja Engage dalam skenario ini:

  • AccountProfile secara teknis diperlukan, tetapi Anda masih dapat mengintegrasikan Engage meskipun aplikasi Anda tidak memiliki sistem akun pengguna.
  • Terbatas untuk penggunaan di perangkat: Kemampuan lintas perangkat Engage bergantung pada identifikasi pengguna di berbagai perangkat. Karena login anonim tidak menyediakan hal ini, fitur tersebut akan dibatasi pada perangkat pengguna saat ini.
  • Cara mengonfigurasi: Untuk menyiapkannya, Anda harus menonaktifkan sinkronisasi lintas perangkat. Hal ini memastikan bahwa entri kelanjutan hanya muncul di perangkat tertentu tempat konten dimulai.

Singkatnya: Meskipun Anda dapat mengintegrasikan Engage dengan login anonim, pengguna hanya akan dapat melanjutkan konten di perangkat yang sama.

Dapatkah saya menggunakan AccountProfile hanya dengan accountId dan tanpa profileId, meskipun aplikasi saya mendukung accountId dan profileId?

AccountProfile memerlukan accountId dan profileId agar dapat berfungsi dengan benar. Berikut alasannya:

  • Identifikasi yang konsisten: accountId mengidentifikasi pengguna, sedangkan profileId membedakan berbagai profil dalam akun pengguna tersebut (jika ada). Dengan memberikan keduanya, Engage akan melacak dan menampilkan konten secara akurat untuk setiap profil.
  • Mencegah error: Menggunakan accountId dan profileId secara tidak konsisten di berbagai panggilan API dapat menyebabkan perilaku dan error yang tidak terduga. Misalnya, jika Anda menyertakan keduanya saat menambahkan konten ke Engage, tetapi hanya menggunakan accountId saat menghapus konten, sistem mungkin tidak dapat mengidentifikasi dan menghapus item yang dimaksud dengan benar.

Apakah profileId diperlukan untuk Engage?

  • accountId wajib diisi. Tindakan ini mengidentifikasi pengguna di berbagai perangkat.
  • profileId sangat penting untuk pengalaman pengguna yang baik. Meskipun secara teknis opsional, profileId sangat direkomendasikan jika layanan Anda mendukung beberapa profil (seperti yang dilakukan banyak layanan streaming). Mengapa hal ini sangat penting? Karena tanpa profileId, baris lanjutkan menonton mungkin menampilkan konten dari profil lain di akun yang sama. Hal ini dapat menyebabkan pengalaman yang membingungkan dan membuat frustrasi bagi pengguna Anda.
  • Singkatnya: Memberikan profileId akan memastikan bahwa konten yang disediakan untuk baris lanjutkan menonton secara akurat mencerminkan histori tontonan setiap individu. Kecuali jika aplikasi Anda tidak mendukung konsep profil dalam akun, Anda harus menyediakannya.

Bagaimana cara Google menggunakan profileId di pihak mereka?

Jika layanan menawarkan profil yang berbeda untuk menonton konten, accountId dan profileId akan digunakan untuk mengaitkan konten yang ditonton di perangkat dengan Akun Google yang login di perangkat. Google akan mencatat data ContinueWatching berdasarkan kombinasi accountId dan profileId. Setiap perangkat Google yang login dengan Akun Google yang sama akan mendapatkan data terbaru dari accountId dan profileId terkait yang sama, di baris LanjutkanMenonton.

Apakah penautan akun diperlukan untuk menerapkan Engage?

Penautan Akun tidak diperlukan. API ini tidak lagi diprioritaskan dan semua kasus penggunaan terkait akan dicakup oleh Device Entitlements API baru.

Pertanyaan tentang Sinkronisasi di Seluruh Perangkat

Dengan izin "sinkronkan di seluruh perangkat" dari pengguna, konten yang mereka tonton akan disimpan ke server Google TV, sehingga mereka dapat melanjutkan dari bagian terakhir yang mereka tonton di perangkat mana pun yang digunakan untuk login. Tanpa izin, histori tontonan mereka tetap bersifat lokal untuk perangkat saat ini.

Can we set "sync across devices" to false?

Flag setUserConsentToSyncAcrossDevices mengontrol apakah data ContinuationCluster pengguna disinkronkan di seluruh perangkatnya (TV, ponsel, tablet, dll.). Jika tanda ini ditetapkan ke false, konten lanjutkan menonton hanya akan ditampilkan di perangkat yang sama.

Untuk mendapatkan hasil maksimal dari fitur lintas perangkat, sebaiknya aplikasi Anda mendapatkan izin pengguna dan menetapkan SyncAcrossDevices ke true.

perangkat? What data points are shared to 3P servers from non-Android devices?

Izin dikumpulkan di tingkat pengguna (tingkat profil atau akun). Setelah izin diperoleh, payload lanjutkan menonton berdasarkan interaksi dapat dikirim ke mana saja sehingga Google dapat mencerminkan status kelanjutan pengguna di mana saja di semua entitas yang memiliki interaksi parsial atau berikutnya, di perangkat apa pun (tanpa harus meminta izin lagi di setiap perangkat atau platform). Partner akan mengirimkan status lanjutkan menonton terbaru pengguna (sesuai spesifikasi) yang terkait dengan ID profil (yang disimpan di Android).

Pertanyaan Terkait REST API

Apakah ada dokumentasi tentang REST API?

Perkiraan waktu rilis untuk REST API adalah Maret 2025, yang didokumentasikan dalam Dokumentasi Developer Engage.

Pertanyaan Tonton Berikutnya Lama

Apakah Engage menggantikan Watch Next API?

Engage akan kompatibel dengan versi lama di semua perangkat Android TV yang mendukung Watch Next API. Untuk berintegrasi di Google TV dan platform lain yang mendukung Engage, developer harus menggunakan Engage SDK.

Pertanyaan tentang Pengujian dan Integrasi

Apa perbedaan antara LastPlayBackPositionTimeMillis dan durasi?

LastPlayBackPositionTimeMillis harus mencerminkan durasi pemutaran dalam milidetik saat pengguna berhenti menonton (misalnya, 605.000 md untuk 10 menit dan 5 detik). Nilai ini tidak boleh lebih besar dari total durasi entitas.

Sedangkan, LastEngagementTime adalah stempel waktu saat pengguna terakhir kali berinteraksi dengan konten.

Apa saja kasus pengujian yang harus kita lakukan?

Berikut adalah kasus pengujian untuk Google TV yang dilakukan oleh QA kami. Kasus pengujian serupa juga dapat dilakukan di platform lain.

  1. Menonton video berdurasi lebih dari 20 menit selama sekitar 5 menit. Keluar dari aplikasi. Kartu video akan ditampilkan di baris lanjutkan menonton. Catatan: Kami hanya menampilkan 5 kartu per aplikasi pihak ketiga di CW
  2. Memilih kartu yang baru muncul di baris lanjutkan menonton akan melanjutkan pemutaran video dari titik yang tepat dalam video.Catatan: Konten baru atau lama akan melanjutkan pemutaran dari posisi terakhirnya
  3. Mengubah akun di perangkat GTV akan mengubah kartu di baris lanjutkan menonton. Hanya video dari akun saat ini yang akan muncul. Diurutkan berdasarkan urutan terbaru. CW profil aplikasi pihak ketiga akan digabungkan. Catatan: CW untuk GoogleAccount2 akan menampilkan konten pihak ketiga yang ditonton GoogleAccount2
  4. Keluar dari aplikasi dengan tombol KEMBALI > Pastikan kartu ditampilkan di baris "Lanjutkan menonton"
  5. Sembunyikan video di baris lanjutkan menonton, video tersebut tidak boleh ditampilkan lagi. Uji apakah konten tersembunyi tetap tersembunyi setelah 24 jam dan bahkan setelah aplikasi dibuka setelah 24 jam. Pastikan bahwa menyembunyikan satu item tidak akan menyembunyikan beberapa item.
  6. Ketersediaan konten di baris lanjutkan menonton dengan metadata lengkap: Gambar kartu, Nama aplikasi, judul, nomor episode season untuk konten TV
  7. Check Progress ditampilkan di status progres
  8. Pengguna menonton konten hingga kredit akhir - konten tidak ditampilkan di baris lanjutkan menonton
  9. Pastikan tidak ada item yang belum ditonton muncul di baris lanjutkan menonton
  10. Pastikan item CW disusun secara kronologis berdasarkan waktu aktivitas menonton terjadi, bukan waktu aplikasi terakhir dibuka atau hari terakhir
  11. Konfirmasi bahwa detail episode dan season di kartu CW cocok dengan yang ditonton di konten episodik
  12. Pastikan item yang telah selesai (item di kredit atau setelahnya) tidak muncul di baris lanjutkan menonton
  13. Nonaktifkan perangkat di tengah-tengah menonton episode/film/acara. "Mematikan perangkat di tengah-tengah menonton episode/film/acara. Verifikasi saat menyalakan perangkat dan di TV lain, CW menampilkan kartu yang tepat , di posisi yang tepat dan status progres"
  14. Nonaktifkan perangkat setelah menonton episode 1 sepenuhnya, verifikasi
  15. episode 1 dihapus dan tidak muncul kembali di baris lanjutkan menonton [di perangkat kedua dan saat mengaktifkan perangkat pengujian]
    1. episode 2 (jika tersedia), akan muncul di baris lanjutkan menonton [di perangkat kedua dan saat mengaktifkan perangkat pengujian]
  16. Skenario pertama: TV1: Akun Google: ibu, akun/profil pihak ketiga: akun 1/ profil_1. Menonton konten dan memverifikasi bahwa data CW menampilkan konten yang ditonton oleh account_1/profile_1 pihak ketiga

  17. TV2: GoogleAccount: ibu. Verifikasi data CW dari skenario pertama. Sekarang login ke aplikasi pihak ketiga sebagai akun lain. Akun/profil pihak ketiga: account_2/ profile_2. Tonton konten dan verifikasi bahwa data CW menampilkan konten yang ditonton oleh akun_2/profil_2 pihak ketiga

  18. AkunGoogle: ibu. Kasus perangkat baru/aplikasi pihak ketiga tidak diinstal. Di perangkat baru (FDR perangkat), pastikan CW menampilkan data dari aplikasi pihak ketiga yang terakhir digunakan oleh Akun Google. Catatan: Baris CW tidak boleh menampilkan konten pihak ketiga jika GAIA belum dikaitkan dengan profil pihak ketiga di perangkat lain

    1. GoogleAccount: ibu. Kasus perangkat baru/aplikasi pihak ketiga diinstal, tetapi tidak sedang login. Di perangkat baru (FDR perangkat), pastikan CW menampilkan data dari aplikasi pihak ketiga yang terakhir digunakan oleh Akun Google.
    1. Catatan: baris lanjutkan menonton tidak boleh menampilkan konten pihak ketiga jika Akun Google belum dikaitkan dengan profil pihak ketiga

Kami tidak melihat konten kelanjutan muncul di aplikasi iOS Google TV. Apa yang terjadi?

Anda harus mengirim deeplink iOS agar konten muncul di baris lanjutkan menonton di perangkat iOS.

Seberapa sering saya harus memperbarui informasi konten untuk baris lanjutkan menonton? Haruskah saya sering mengupdatenya, misalnya setiap 15 detik?

Tidak, update yang sering tidak direkomendasikan. Berikut alasannya:

  • Dampak Performa: Mengirimkan update secara terus-menerus akan memberikan beban yang tidak perlu pada server kami, sehingga berpotensi memperlambat sistem bagi semua orang.
  • Data yang Tidak Diperlukan: Saat pengguna aktif menonton, posisi pemutaran mereka terus berubah. Mengirim update setiap beberapa detik akan membuat banyak data redundan yang tidak membantu untuk melanjutkan pemutaran.

Kapan harus memperbarui informasi konten untuk baris lanjutkan menonton:

Fokus pada pengambilan perubahan yang bermakna dalam progres menonton pengguna. Berikut adalah skenario utamanya:

  • Pemutaran Dijeda atau Dihentikan: Saat pengguna menjeda atau berhenti menonton, kirim pembaruan untuk menyimpan posisi mereka saat ini.
  • Aplikasi Ditutup atau Berjalan di Latar Belakang: Jika pengguna keluar dari aplikasi atau beralih ke aplikasi lain saat menonton video, kirim update untuk menyimpan progresnya.
  • Saat pengguna menghapus item dari baris lanjutkan menonton dalam aplikasi

Cara memperbarui secara efisien:

Daripada update berjangka waktu, gunakan peristiwa dalam pemutar video atau siklus proses aplikasi untuk memicu update. Contoh:

  • onPause, onStop: Saat pemutaran video dijeda atau dihentikan.
  • onAppClose, onAppBackgrounded: Saat aplikasi ditutup atau dipindahkan ke latar belakang.

Dengan mengikuti panduan ini, Anda akan memastikan penggunaan resource yang efisien sekaligus tetap memberikan pengalaman yang lancar di baris lanjutkan menonton bagi pengguna.