Feed oluşturma

Medya feed'i, kataloğunuzdaki medya içeriğini (ör. TV dizileri, filmler, şarkılar, albümler) temsil eden bir varlık koleksiyonu 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ırmanız gerekir.

Feed dosyası biçimi şartları

Feed dosyaları için gerekenler şunlardır:

  • Feed dosyası .json dosya adı uzantısına sahip olmalıdır.
  • Feed dosyanızı şifrelemeyin.

  • Feed dosyanızı UTF-8 olarak kodlayın (dosya düzenleyici ayarınızı kontrol edin).

    alt_text

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

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

    • Bu dosyalardan herhangi biri 1 GB'ı aşıyorsa öğelerini birden fazla dosyaya bölün (örneğin, tvepisodes_01.json, tvepisodes_02.json vb.).
    • Dosya boyutu 1 GB'tan küçük olduğu sürece tek bir dosyaya kaç öğe ekleyeceğinizle ilgili bir sınırlama yoktur.

  • Dosyanın, JSON spesifikasyonuna uygun olarak BOM olmadan kodlandığından emin olun. Linux işletim sisteminde kontrol etmek için hexdump file.json | head -n 1, 0x00 adresinde BBEF ile başlamamalıdır.

Feed türleri

Üretim feed'i

  • Bu, Google'da yayınlamak istediğiniz kataloğunuzun tamamını temsil eden JSON feed dosyası grubunu temsil eder. Aşağıdaki bölümde feed oluşturmayı öğrenebilirsiniz.
  • Google ile ilk kez entegrasyon yapıyorsanız ihtiyacınız olan tek feed budur.
  • Bu feed Google'a gönderildikten sonra, son olarak beslenip kullanıma sunulmadan önce yakalanan bilgi miktarı ve doğruluğu açısından daha yüksek bir kalite standardına ulaşmak için kapsamlı bir şekilde analiz edilir ve birkaç kez iterasyon uygulanır.

Hazırlık feed'i

  • Üretim feed'inin genişletilmesini gerektiren belirli kullanım alanları vardır. Bu tür senaryolara örnek olarak şunlar verilebilir:
    • Feed'in, daha önce kullanıma sunulmamış yeni öğe türlerini içerecek şekilde genişletilmesi.
    • Feed'in, yeni yerel ayarlarda kullanıma sunulacak çok sayıda yeni öğe/meta veri içerecek şekilde genişletilmesi.
    • Feed'in yeni platform türlerini içerecek şekilde genişletilmesi. Örneğin, üretim feed'i yalnızca Google Arama'da kullanıma sunulmuşsa ve şimdi Google TV'de de kullanıma sunmak istiyorsanız.
  • Bu gibi durumlarda bir hazırlık feed'i gereklidir. Bu feed, üretim feed'inin bir kopyasıdır. Bununla birlikte, yeni bir platform için derin bağlantılar, yeni bir yerel ayar için meta veriler vb. gibi ek meta veriler içerir.
  • Üretim feed'ine benzer şekilde, yakalanan bilgi miktarı ve doğruluğu açısından daha yüksek bir kalite standardına ulaşmak için bu feed kapsamlı bir şekilde analiz edilir ve birkaç kez iterasyon uygulanır. Kalite standardına ulaşıldığında bu feed, mevcut üretim feed'inin yerini alarak yeni üretim feed'i olur.
  • Bu feed, ilk lansmanı ek lansmanlardan ayırmamıza ve üretim feed'ini etkilemeden gerekli tüm testleri yapmamıza olanak tanır. Bu sayede son kullanıcı deneyiminde kesinti yaşanmaz.

Yukarıdakilerle ilgili kafanıza takılan soruları Google temsilcinizle görüşün.

Feed dosyası oluşturma

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

  1. Küçük bir varlık grubu kullanarak örnek feed oluşturma

    Kataloğunuzdaki tüm içeriği içeren bir feed oluşturmadan önce, yalnızca küçük bir öğe grubu içeren bir örnek feed oluşturmanızı öneririz. Özet akışınız üzerinde çalışırken sorunlarla karşılaşabilirsiniz. Varlık kümesinin boyutunu sınırlandırarak bu hata ve uyarılarda daha kolay hata ayıklama yapabilirsiniz.

  2. Örnek feed'i doğrulama

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

  3. Üretim feed'i oluşturma

    Küçük öğe grubunuzun iyi bir yapıya sahip olduğunu doğruladıktan sonra katalogunuzun tamamı için bir feed geliştirin.

Örnek feed oluşturma

  1. Kataloğunuzdan temsili bir öğe seçin. Yeterince karmaşık bir yapıya sahip ancak katalogdaki bir varlık için yine de tipik olan bir varlık seçin.
  2. Söz dizimi hatalarını ve eksik zorunlu özellikleri kontrol etmek için Veri Feed'i Doğrulama Aracı'nı kullanın. (Ayrıntılar için sonraki bölüme bakın.) 
    {
  "@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 feed'i doğrulama

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

  • Veri Feed'i Doğrulama aracı

    Veri feed'i doğrulama aracı, aynı anda tek bir öğeyi doğrulayabilir. Kataloğunuzdaki bir örnek öğeyi yapısal hatalar ve yaygın içerik hataları açısından doğrulamak için bu aracı kullanın. Kaldırma isteği aracı hakkında daha fazla bilgiyi burada bulabilirsiniz.

  • JSON Şeması Doğrulama Aracı

    JSON Şeması Doğrulama aracı, feed'deki tüm dosyaları doğrulayabilir. Sık karşılaşılan yapısal hataları önlemek için feed'in geliştirilmesi sırasında bu aracı kullanın. Araç hakkında daha fazla bilgiyi burada bulabilirsiniz.

Üretim feed'i oluşturma

  1. Örnek feed'deki tüm hatalar ve uyarılar giderildikten sonra feed'i, kataloğunuzdaki tüm öğeleri içerecek şekilde genişletin.
  2. Feed'inizdeki az sayıda öğeyi aynı anda doğrulamak için Veri feed'i doğrulama aracını sık sık kullanın (Aracıya çok sayıda öğe yapıştırmak web tarayıcısını dondurabilir). Feed'inizdeki öğe sayısını katalogunuzdaki öğe sayısıyla karşılaştırarak feed'inizin katalogunuzdaki tüm öğeleri içerdiğini doğrulayın.
Önceki
Fiyatı Belirleyin
Sonraki
Feed'i barındırma