Feed oluşturma

Medya feed'i, kataloğunuzdaki TV dizilerini, Filmleri, Şarkıları, Albümleri ve diğer medya içeriklerini temsil eden öğelerin koleksiyonunu içeren bir JSON nesnesidir. İlk katılım sürecinin ilk adımı, feed'lerinizi geliştirmeye başlamaktır. Dosyalar hazır olduğunda, Google'ın düzenli olarak getirmesi için desteklenen barındırma yöntemlerinden birini kullanarak feed'i barındırın.

Feed dosyası biçim şartları

Feed dosyalarıyla ilgili şartlar şunlardır:

  • Feed dosyasının dosya adı uzantısı .json olmalıdır.
  • Feed dosyanızı şifrelemeyin.
  • Feed dosyanızı UTF-8 olarak kodlayın (dosya düzenleyici ayarınızı kontrol edin).

    alternatif_metin

  • Feed dosyanız 1 GB'tan (sıkıştırılmamış) büyükse dosyayı birden fazla dosyaya bölün.

  • Her varlık türü (örneğin, tvseries.json, tvseasons.json, tvepisodes.json, movies.json vb.) başına bir dosya oluşturmanızı öneririz.

    • Bu dosyalardan herhangi biri 1 GB'ı aşarsa öğelerini birden fazla dosyaya (örneğin, tvepisodes_01.json, tvepisodes_02.json vb.) bölün.
    • Dosya boyutu 1 GB'tan küçük olduğu sürece tek bir dosyaya kaç tane öğe ekleyebileceğinize dair bir sınırlama yoktur.
  • Dosyanın JSON spesifikasyonuna uygun olarak BOM olmadan kodlandığından emin olun. Bir Linux işletimini kontrol etmek için hexdump file.json | head -n 1 0x00 adresindeki BBEF ile başlamamalıdır.

Feed türleri

Üretim feed'i

  • Bu, Google'da başlatmak istediğiniz kataloğun tamamını temsil eden json feed dosyası grubunu temsil eder. Aşağıdaki bölümde feed oluşturma hakkında bilgi edinebilirsiniz.
  • Bu, Google ile ilk kez entegrasyon yapıyorsanız ihtiyacınız olan tek feed'dir.
  • Bu feed Google'a gönderildikten sonra, ayrıntılı olarak analiz edilir ve birkaç kez tekrarlanır. Böylece, yakalanan bilgi miktarı ve nihai olarak besleme ve kullanıma sunulmadan önce doğruluğu ile daha yüksek kaliteli bir çubuk elde edilir.

Hazırlık feed'i

  • Üretim feed'inin genişletilmesini gerektiren belirli kullanım alanları vardır. Bu tür senaryolara örnek olarak aşağıdakiler verilebilir:
    • Feed'in önceden kullanıma sunulmamış yeni öğe türlerini içerecek şekilde genişletilmesi.
    • Feed'in yeni yerlerde başlatılacak çok sayıda yeni varlık/meta veri içerecek şekilde genişletilmesi.
    • Feed'in yeni platform türlerine genişletilmesi. Örneğin, üretim feed'i yalnızca Google Arama'da kullanıma sunulduğunda ve şimdi lansmanı Google TV'yi kapsayacak şekilde genişletmek istediğinizde.
  • Bu tür durumlarda hazırlık feed'i gerekir. Bu feed, ek meta verilerin (örneğin, yeni bir platformun derin bağlantıları, yeni bir yerel ayara ait meta veriler) ve üretim feed'inin bir kopyası olması dışında üretim feed'inin bir kopyasıdır.
  • Bu, üretim feed'ine benzer şekilde, analiz edilen bilgi miktarı ve bilgilerin doğruluğuyla daha yüksek kalite çıtası elde etmek için birkaç kez kapsamlı bir şekilde analiz edilip yinelenecektir. Kalite çubuğuna ulaşıldıktan sonra bu feed, mevcut üretim feed'inin yerini alarak yeni üretim feed'i haline gelir.
  • Bu feed, ilk lansmanı ek lansmanlardan ayırmamıza ve gereken tüm testleri üretim feed'ini etkilemeden yapmamıza olanak tanır. Böylece son kullanıcı deneyiminde kesinti olmaz.

Yukarıdakilerle ilgili sorularınız için Google temsilcinizle birlikte çalışın.

Feed dosyası oluşturma

Feed'i oluştururken aşağıdaki en iyi uygulamaları izleyin:

  1. Küçük bir öğe grubunu kullanarak örnek feed oluşturma

    Kataloğunuzdaki tüm içeriği barındıran bir feed oluşturmadan önce yalnızca az sayıda öğe içeren bir örnek feed oluşturmanızı öneririz. Feed'iniz üzerinde çalışırken sorunlarla karşılaşabilirsiniz. Varlık grubunun boyutunu sınırlandırarak bu hatalar ve uyarılarla ilgili hataları daha kolay şekilde giderebilirsiniz.

  2. Örnek özet akışını doğrulama

    Feed'inizin spesifikasyonlara uygun olmasını sağlayan araçlar sağlarız. Örnek feed'inizde bulunan tüm hataları ve uyarıları çözmek için bu araçları kullanmanızı öneririz.

  3. Üretim feed'i oluşturma

    Küçük varlık grubunuz için iyi bir yapınız olduğunu doğruladıktan sonra, kataloğunuzun tamamı için bir feed oluşturun.

Örnek feed oluşturma

  1. Kataloğunuzdan bir temsili varlık seçin. Oldukça karmaşık bir yapıya sahip, ancak katalogdaki bir varlık için tipik olarak bulunan bir öğeyi seçin.
  2. Söz dizimi hatalarını ve eksik özellikleri kontrol etmek için Veri Feed'i Doğrulama aracını kullanın. (Ayrıntılar için bir sonraki bölüme bakın.)

    Tek bir Movie varlığına sahip feed örneği

    {
      "@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"
            }
          ]
        }
      ]
    }
    

Örnek özet akışını doğrulama

Aşağıdaki araçlar, örnek feed'i, Google'ın medya feed'leri için yapılandırılmış veri spesifikasyonlarıyla doğrulamanıza yardımcı olabilir.

  • Veri Feed'i Doğrulama aracı

    Veri Feed'i Doğrulama aracı, aynı anda tek bir varlığı doğrulayabilir. Kataloğunuzdaki örnek bir varlığı yapısal hatalar ve yaygın içerik hataları için doğrulamak amacıyla bu aracı kullanın. Araçla ilgili daha fazla bilgiyi burada bulabilirsiniz.

  • JSON Şema Doğrulama aracı

    JSON Şema Doğrulama aracı, bir feed'deki tüm dosyaları doğrulayabilir. Sık karşılaşılan yapısal hatalardan kaçınmak için bu aracı feed'in geliştirmesi sırasında kullanın. Araçla ilgili daha fazla bilgiyi burada bulabilirsiniz.

Üretim feed'i oluşturma

  1. Örnek feed'deki tüm hatalar ve uyarılar çözümlendikten sonra feed'i kataloğunuzdaki tüm varlıkları içerecek şekilde genişletin.
  2. Feed'inizdeki az sayıda varlığı aynı anda doğrulamak için sık sık Veri Feed'i Doğrulama aracını kullanın (Araçta çok sayıda öğe yapıştırıldığında web tarayıcısı donabilir). Feed'inizdeki öğelerin sayısını kataloğunuzdaki öğelerin sayısıyla karşılaştırarak feed'inizin kataloğunuzdaki tüm varlıkları içerdiğini onaylayın.