Feed Media adalah objek JSON yang berisi kumpulan entity yang mewakili konten media dalam katalog Anda, seperti Serial TV, Film, Lagu, Album, dan lainnya. Langkah pertama dalam proses aktivasi adalah mulai mengembangkan feed Anda. Setelah file siap, Anda harus menghosting feed menggunakan salah satu metode hosting yang didukung agar Google dapat mengambilnya secara rutin.
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 Anda).

Bagi file menjadi beberapa file jika file feed Anda berukuran lebih dari 1 GB (tidak dikompresi).
Sebaiknya buat file per jenis entity (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.). - Selama 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 dengan spesifikasi JSON. Untuk memeriksa OS Linux,
hexdump file.json | head -n 1tidak boleh dimulai denganBBEFdi alamat 0x00.
Jenis feed
Feed produksi
- Ini mewakili kumpulan file feed JSON yang bersama-sama mewakili seluruh katalog yang ingin Anda luncurkan di Google. Anda dapat mempelajari cara membuat feed di bagian di bawah.
- Ini adalah satu-satunya feed yang Anda perlukan jika Anda berintegrasi dengan Google untuk pertama kalinya.
- Setelah dikirimkan ke Google, feed ini akan dianalisis secara ekstensif dan diiterasi beberapa kali untuk mencapai standar kualitas yang lebih tinggi terkait jumlah informasi yang diambil dan kebenarannya 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 sejumlah besar entitas/metadata baru yang akan diluncurkan di lokalitas baru.
- Perluasan feed ke jenis platform baru. Misalnya, saat feed produksi hanya diluncurkan di Google Penelusuran dan sekarang Anda ingin memperluas peluncuran ke Google TV.
- Dalam kasus tersebut, feed staging diperlukan. Feed ini adalah salinan feed produksi, tetapi memiliki metadata tambahan, misalnya, deep link untuk platform baru, metadata untuk lokalitas baru, dan sebagainya.
- Mirip dengan feed produksi, feed ini akan dianalisis secara ekstensif dan diiterasi beberapa kali untuk mencapai standar kualitas yang lebih tinggi terkait jumlah informasi yang diambil dan kebenarannya. Setelah standar kualitas tercapai, feed ini akan menggantikan feed produksi saat ini untuk 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 tentang hal di atas.
Membuat file feed
Ikuti praktik terbaik berikut saat membuat feed:
Membuat feed contoh menggunakan sekumpulan kecil entitas
Sebelum membuat feed yang berisi semua konten dalam katalog, sebaiknya buat feed contoh yang hanya berisi sekumpulan kecil entitas. Saat mengerjakan feed, Anda mungkin akan mengalami masalah. Dengan membatasi ukuran kumpulan entity, Anda akan dapat men-debug error dan peringatan ini dengan lebih mudah.
-
Kami menyediakan alat yang memastikan feed Anda mematuhi spesifikasi. Sebaiknya gunakan alat ini untuk menyelesaikan semua error dan peringatan yang ditemukan di feed sampel Anda.
-
Setelah memverifikasi bahwa Anda memiliki struktur yang baik untuk sebagian kecil entitas, kembangkan feed untuk seluruh katalog Anda.
Membuat feed contoh
- Pilih satu entitas representatif dari katalog Anda. Pilih entity dengan struktur yang cukup kompleks, tetapi masih umum untuk entity dalam katalog.
- Gunakan alat Validasi Skema JSON untuk memeriksa error sintaksis dan properti wajib yang 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 contoh feed berdasarkan spesifikasi data terstruktur Google untuk feed media:
Alat Validasi Skema JSON
Alat Validasi Skema JSON memvalidasi semua file dalam feed secara lokal sebelum diupload. Gunakan alat ini selama pengembangan feed untuk menghindari error struktural dan jenis yang umum. Anda dapat menemukan detail selengkapnya tentang alat ini di sini.
Properti Katalog di Search Console
Setelah perwakilan Google mengaktifkan properti katalog Search Console dan feed contoh atau feed staging Anda diserap, gunakan Properti Katalog di Search Console untuk memeriksa error validasi, peringatan, dan diagnostik penyerapan tingkat entitas.
Membuat feed produksi
- Setelah semua error dan peringatan struktural dalam feed contoh diselesaikan, perluas feed untuk menyertakan semua entitas dalam katalog Anda.
- Jalankan alat Validasi Skema JSON pada file feed yang diperluas dan tinjau Properti Katalog di Search Console setelah upload untuk memverifikasi bahwa tidak ada error validasi. Konfirmasi bahwa feed Anda menyertakan semua entitas dalam katalog dengan membandingkan jumlah entitas dalam feed dengan jumlah item dalam katalog.