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 perlu menghosting feed menggunakan salah satu metode hosting yang didukung agar dapat diambil Google secara rutin.

Persyaratan format file feed

Berikut adalah persyaratan untuk file feed:

  • File feed harus memiliki ekstensi nama file .json.
  • Jangan enkripsi file feed Anda.

  • Encode file feed Anda dalam UTF-8 (periksa setelan editor file Anda).

    alt_text

  • Bagi file menjadi beberapa file jika ukuran file feed lebih besar dari 1 GB (tidak dikompresi).

  • Sebaiknya buat file per jenis entity (misalnya, tvseries.json, tvseasons.json, tvepisodes.json, movies.json, dll.).

    • Jika ukuran file melebihi 1 GB, bagi entitasnya menjadi beberapa (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.

  • Pastikan file dienkode tanpa BOM, sesuai dengan spesifikasi JSON. Untuk memeriksa sistem operasi Linux, hexdump file.json | head -n 1 tidak boleh diawali dengan BBEF pada alamat 0x00.

Jenis feed

Feed produksi

  • Ini mewakili kumpulan file feed json yang bersama-sama mewakili seluruh katalog yang Anda kami luncurkan di Google. Anda dapat mempelajari cara membuat feed pada bagian di bawah.
  • Feed ini adalah satu-satunya feed yang Anda perlukan jika Anda berintegrasi dengan Google untuk pertama kalinya.
  • Setelah dikirim ke Google, feed ini akan dianalisis dan diiterasi secara ekstensif pada beberapa waktu untuk mencapai standar kualitas yang lebih tinggi dengan jumlah informasi yang ditangkap dan 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 tidak diluncurkan sebelumnya.
    • Perluasan feed untuk menyertakan sejumlah besar entity/metadata baru untuk diluncurkan di lokalitas.
    • Perluasan feed ke jenis platform baru. Misalnya, jika feed produksi hanya diluncurkan di Google Penelusuran dan kini Anda ingin memperluas peluncurannya ke Google TV.
  • Dalam kasus tersebut, feed staging diperlukan. Feed ini adalah salinan feed produksi, hanya saja file ini memiliki metadata tambahan, misalnya, deep link untuk platform baru, metadata untuk lokalitas baru dan seterusnya.
  • Mirip dengan feed produksi, data ini akan dianalisis dan diiterasi secara ekstensif beberapa kali untuk mencapai standar kualitas yang lebih tinggi w.r.t jumlah informasi yang ditangkap dan ketepatannya. Setelah standar kualitas tercapai, feed ini akan menggantikan feed produksi saat ini menjadi feed produksi baru.
  • Feed ini memungkinkan kita memisahkan peluncuran awal dari peluncuran tambahan, melakukan semua pengujian yang diperlukan, tanpa memengaruhi feed produksi. Hal ini memastikan tidak ada gangguan hingga akhir {i>user experience<i}.

Bekerja samalah dengan perwakilan Google Anda untuk mengklarifikasi pertanyaan apa pun yang mungkin Anda miliki mengenai informasi di atas.

Membuat file feed

Ikuti praktik terbaik berikut saat membuat feed:

  1. Buat feed contoh menggunakan sekumpulan kecil entitas

    Sebelum membuat feed yang berisi semua konten di katalog, sebaiknya buat contoh feed yang hanya berisi sekumpulan kecil entitas. Saat mengerjakan {i>feed<i}, Anda mungkin menemui masalah performa. Dengan membatasi ukuran set entitas, Anda akan dapat men-debug error ini dan peringatan dengan lebih mudah.

  2. Memvalidasi feed contoh

    Kami menyediakan alat yang memastikan bahwa feed Anda sesuai dengan spesifikasi. Saran dari kami Anda akan menggunakan alat ini untuk mengatasi semua error dan peringatan yang ditemukan dalam feed contoh.

  3. Membuat feed produksi

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

Membuat feed contoh

  1. Pilih satu entitas representatif dari katalog Anda. Pilih entity dengan struktur yang cukup kompleks, tetapi masih khas untuk entity dalam katalog.
  2. Gunakan alat Validasi Feed Data untuk memeriksa error sintaksis dan properti wajib yang tidak ada. (Lihat bagian berikutnya untuk mengetahui detailnya.)

    Contoh feed dengan satu entity 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 sampel

Alat berikut tersedia untuk membantu Anda memvalidasi feed contoh dengan data terstruktur Google spesifikasi untuk feed media.

  • Alat Validasi Feed Data

    Alat Validasi Feed Data dapat memvalidasi satu entitas pada satu waktu. Gunakan alat ini untuk memvalidasi sampel dari katalog Anda untuk error struktural dan error konten umum. Anda dapat menemukan lebih banyak mengetahui detail 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 kesalahan struktur yang umum. Anda dapat menemukan detail selengkapnya tentang di sini.

Membuat feed produksi

  1. Setelah semua error dan peringatan dalam feed contoh diselesaikan, luaskan feed untuk menyertakan semua entitas di katalog Anda.
  2. Menggunakan alat Validasi Feed Data untuk memvalidasi sejumlah kecil entitas di feed Anda pada satu waktu (Menempelkan sejumlah entitas pada alat tersebut dapat membekukan browser web). Konfirmasi bahwa feed Anda menyertakan semua entitas di katalog dengan membandingkan jumlah entitas di feed Anda dengan jumlah item di katalog.
Sebelumnya
Identifikasi Harga
Berikutnya
Menghosting Feed