Feed Media adalah objek JSON yang berisi kumpulan entitas yang mewakili konten media dalam katalog Anda, seperti Serial TV, Film, Lagu, Album, dan lainnya. Langkah pertama dalam proses orientasi adalah mulai mengembangkan feed Anda. Setelah file siap, Anda harus menghosting feed menggunakan salah satu metode hosting yang didukung agar Google dapat mengambil feed secara teratur.
Persyaratan format file feed
Berikut adalah persyaratan untuk file feed:
- File feed harus memiliki ekstensi nama file
.json
. - Jangan mengenkripsi file feed Anda.
Enkode file feed Anda dalam UTF-8 (periksa setelan editor file).
Bagi file menjadi beberapa file jika file feed Anda lebih besar dari 1 GB (tidak dikompresi).
Sebaiknya buat file per jenis entitas (misalnya,
tvseries.json
,tvseasons.json
,tvepisodes.json
,movies.json
, dll.).- Jika salah satu file ini melebihi 1 GB, bagi entity-nya menjadi beberapa
file (misalnya
tvepisodes_01.json
,tvepisodes_02.json
, dll.). - Asalkan ukuran file kurang dari 1 GB, tidak ada batasan jumlah entitas yang dapat Anda sertakan dalam satu file.
- Jika salah satu file ini melebihi 1 GB, bagi entity-nya menjadi beberapa
file (misalnya
Pastikan file dienkode tanpa BOM, sesuai spesifikasi JSON. Untuk memeriksa OS Linux,
hexdump file.json | head -n 1
tidak boleh dimulai denganBBEF
di alamat 0x00.
Jenis feed
Feed produksi
- Ini mewakili kumpulan file feed json yang bersama-sama mewakili seluruh katalog Anda yang ingin diluncurkan di Google. Anda dapat mempelajari cara membuat feed pada bagian di bawah ini.
- Ini adalah satu-satunya feed yang Anda butuhkan jika Anda berintegrasi dengan Google untuk pertama kalinya.
- Setelah dikirim ke Google, feed ini akan dianalisis dan diiterasi secara ekstensif beberapa kali untuk mencapai standar kualitas yang lebih tinggi dengan jumlah informasi yang diambil dan ketepatannya sebelum akhirnya diserap dan diluncurkan.
Feed staging
- Ada kasus penggunaan tertentu yang memerlukan perluasan feed produksi. Beberapa contoh skenario tersebut adalah:
- Perluasan feed untuk menyertakan jenis entitas baru, yang sebelumnya tidak diluncurkan.
- Perluasan feed untuk menyertakan entitas/metadata baru dalam jumlah besar untuk diluncurkan di lokalitas baru.
- Perluasan feed ke jenis platform baru. Misalnya, saat feed produksi hanya diluncurkan di Google Penelusuran, sekarang Anda ingin memperluas peluncurannya ke Google TV.
- Dalam kasus seperti itu, feed staging wajib diisi. Feed ini adalah salinan feed produksi, tetapi memiliki metadata tambahan, misalnya deep link untuk platform baru, metadata untuk lokalitas baru dan seterusnya.
- Serupa dengan feed produksi, feed ini akan dianalisis dan diiterasi secara ekstensif beberapa kali untuk mencapai batas kualitas yang lebih tinggi dengan jumlah informasi yang diambil dan ketepatannya. Setelah mencapai batas kualitas, feed ini akan menggantikan feed produksi saat ini menjadi feed produksi baru.
- Feed ini memungkinkan kami memisahkan peluncuran awal dari peluncuran tambahan, melakukan semua pengujian yang diperlukan, tanpa memengaruhi feed produksi. Hal ini memastikan tidak ada gangguan pada pengalaman pengguna akhir.
Hubungi perwakilan Google Anda untuk mengklarifikasi pertanyaan apa pun yang mungkin Anda miliki di atas.
Membuat file feed
Ikuti praktik terbaik ini saat membuat feed:
Membuat feed contoh menggunakan kumpulan entitas yang kecil
Sebelum membuat feed yang berisi semua konten dalam katalog Anda, sebaiknya buat feed contoh dengan sekelompok kecil entitas. Selagi mengerjakan feed, Anda mungkin mengalami masalah. Dengan membatasi ukuran kumpulan entitas, Anda dapat men-debug error dan peringatan ini dengan lebih mudah.
-
Kami menyediakan alat yang memastikan feed Anda mematuhi spesifikasi. Sebaiknya gunakan alat ini untuk mengatasi semua error dan peringatan yang ditemukan di feed contoh Anda.
-
Setelah memverifikasi bahwa Anda memiliki struktur yang baik untuk kumpulan kecil entitas Anda, buat feed untuk seluruh katalog.
Membuat contoh feed
- Pilih satu entitas perwakilan dari katalog Anda. Pilih entitas dengan struktur yang cukup rumit, tetapi tetap umum untuk entitas dalam katalog.
- Gunakan alat Validasi Feed Data untuk memeriksa kesalahan sintaksis dan properti wajib tidak ada. (Lihat bagian berikutnya untuk mengetahui detailnya.)
Contoh feed dengan satu entitas
Movie
{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ { "@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", "inLanguage": "en", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform", "http://schema.googleapis.com/GoogleVideoCast" ] }, "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "[partner determined string]" }, "availabilityStarts": "2018-07-21T10:35:29Z", "availabilityEnds": "2019-10-21T10:35:29Z", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "CA" } ] } }, "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie", "releasedEvent": { "@type": "PublicationEvent", "startDate": "2008-01-20", "location": { "@type": "Country", "name": "US" } }, "description": "This is my favorite movie.", "actor": [ { "@type": "Person", "name": "John Doe", "sameAs": "https://en.wikipedia.org/wiki/John_Doe" }, { "@type": "Person", "name": "Jane Doe", "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe" } ], "identifier": [ { "@type": "PropertyValue", "propertyID": "IMDB_ID", "value": "tt0123456" } ] } ] }
Memvalidasi feed contoh
Alat berikut tersedia untuk membantu Anda memvalidasi feed contoh dengan spesifikasi data terstruktur Google untuk feed media.
Alat Validasi Feed Data
Alat Validasi Feed Data dapat memvalidasi entitas satu per satu. Gunakan alat ini untuk memvalidasi entitas sampel dari katalog Anda untuk error struktural dan error konten umum. Anda dapat menemukan detail selengkapnya tentang alat ini di sini.
Alat Validasi Skema JSON
Alat Validasi Skema JSON dapat memvalidasi semua file dalam feed. Gunakan alat ini selama pengembangan feed untuk menghindari error struktural umum. Anda dapat menemukan detail selengkapnya tentang alat ini di sini.
Membuat feed produksi
- Setelah semua error dan peringatan dalam feed contoh diselesaikan, luaskan feed tersebut untuk menyertakan semua entity di katalog Anda.
- Gunakan alat Validasi Feed Data secara rutin untuk memvalidasi sejumlah kecil entitas di feed Anda sekaligus (Menempelkan banyak entitas pada alat ini dapat membekukan browser web). Pastikan feed Anda menyertakan semua entitas dalam katalog dengan membandingkan jumlah entitas dalam feed Anda dengan jumlah item dalam katalog Anda.