Buat feed

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).

    alt_text

  • 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.

  • Pastikan file dienkode tanpa BOM, sesuai spesifikasi JSON. Untuk memeriksa OS Linux, hexdump file.json | head -n 1 tidak boleh dimulai dengan BBEF 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:

  1. 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.

  2. Memvalidasi feed contoh

    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.

  3. Membuat feed produksi

    Setelah memverifikasi bahwa Anda memiliki struktur yang baik untuk kumpulan kecil entitas Anda, buat feed untuk seluruh katalog.

Membuat contoh feed

  1. Pilih satu entitas perwakilan dari katalog Anda. Pilih entitas dengan struktur yang cukup rumit, tetapi tetap umum untuk entitas dalam katalog.
  2. 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

  1. Setelah semua error dan peringatan dalam feed contoh diselesaikan, luaskan feed tersebut untuk menyertakan semua entity di katalog Anda.
  2. 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.
Sebelumnya
Identifikasi Harga
Berikutnya
Menghosting Feed