Yemek tarifi (Recipe
, HowTo
, ItemList
) yapılandırılmış verisi
Google'a, yapılandırılmış verilerle hazırladığınız yemek tarifini anlatarak kullanıcıların tarifinizi bulmasına yardımcı olun. Yorumcu puanları, yemek pişirme ve hazırlık süreleri ile beslenme bilgileri gibi bilgileri verdiğinizde Google, tarifinizi daha iyi anlayabilir ve ilginç yöntemlerle kullanıcılara sunabilir. Yemek tarifleri Google Arama sonuçlarında ve Google Görseller'de görünebilir.
![Yemek tarifi zengin sonuçlarının Google Arama'da nasıl görünebileceğinin resmi. Yemek tarifinin ne kadar sürede pişirileceği, bir görsel ve yorum bilgileri gibi ayrıntıların da bulunduğu, farklı web sitelerinden alınmış 4 zengin sonuç gösterilir.](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/recipe-rich-result-google-search.png?authuser=0000&hl=tr)
![Yemek tariflerinin Google Görseller'de nasıl görünebileceğinin resmi. Sonuçlardan 3 tanesinde bunların yemek tarifi olduğunu belirten yemek tarifi rozetinin bulunduğu, farklı yemek öğelerini gösteren 6 görsel arama sonucu sunulur](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/recipes-in-google-images.png?authuser=0000&hl=tr)
İçeriğinizi nasıl işaretlediğinize bağlı olarak yemek tarifleriniz aşağıdaki geliştirmeler için uygun olabilir:
Yemek tarifi geliştirmeleri | |
---|---|
Yemek tarifi barındırma bandı: Kullanıcıların, yemek tarifi galerinizin sayfalarını keşfetmesine yardımcı olmak için
ItemList yapılandırılmış veriler ekleyin.
|
![]() |
Yapılandırılmış veri ekleme
Yapılandırılmış veri, bir sayfa hakkında bilgi sağlamak ve sayfa içeriğini sınıflandırmak için kullanılan standart bir biçimdir. Yapılandırılmış veri konusunda yeniyseniz yapılandırılmış verinin nasıl çalıştığı hakkında daha fazla bilgi edinebilirsiniz.
Aşağıda, yapılandırılmış verinin nasıl oluşturulacağı, test edileceği ve yayınlanacağı hakkında bir genel bakış sunulmuştur. Web sayfasına yapılandırılmış verinin nasıl ekleneceği hakkında adım adım açıklamalı kılavuz için yapılandırılmış veri codelab'e göz atın.
- Zorunlu özellikleri ekleyin. Kullandığınız biçime bağlı olarak sayfada yapılandırılmış verilerin nereye ekleneceğini öğrenin.
- Yönergeleri uygulayın.
- Zengin Sonuçlar Testi'ni kullanarak kodunuzu doğrulayın ve kritik hataları düzeltin. Araçta işaretlenmiş olabilecek kritik olmayan sorunları da düzeltme seçeneğini değerlendirin. Bu tür hatların düzeltilmesi yapılandırılmış verilerinizin kalitesini artırır ancak zengin sonuçlara uygun olmak için zorunlu değildir.
- Yapılandırılmış verinizi içeren birkaç sayfa dağıtıp Google'ın sayfayı nasıl gördüğünü test etmek için URL Denetleme aracını kullanın. Google'ın sayfanıza erişebildiğinden ve bir robots.txt dosyası,
noindex
etiketi veya giriş gereksinimleri tarafından engellenmediğinden emin olun. Sayfa düzgün görünüyorsa Google'dan URL'lerinizi yeniden taramasını isteyebilirsiniz. - İleride yapılacak değişiklikler konusunda Google'a bilgi vermeye devam etmek için site haritası gönderin. Bu işlemi Search Console Sitemap API ile otomatikleştirebilirsiniz.
Örnekler
Burada, JSON-LD kodu kullanan yemek tarifleriyle ilgili bazı örnekler verilmiştir.
Arama'da Yemek Tarifi
Burada, Arama'da gösterilmeye uygun bir sayfa örneği verilmiştir.
<html> <head> <title>Non-Alcoholic Piña Colada</title> <script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Recipe", "name": "Non-Alcoholic Piña Colada", "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "author": { "@type": "Person", "name": "Mary Stone" }, "datePublished": "2024-03-10", "description": "This non-alcoholic pina colada is everyone's favorite!", "recipeCuisine": "American", "prepTime": "PT1M", "cookTime": "PT2M", "totalTime": "PT3M", "keywords": "non-alcoholic", "recipeYield": "4 servings", "recipeCategory": "Drink", "nutrition": { "@type": "NutritionInformation", "calories": "120 calories" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "5", "ratingCount": "18" }, "recipeIngredient": [ "400ml of pineapple juice", "100ml cream of coconut", "ice" ], "recipeInstructions": [ { "@type": "HowToStep", "name": "Blend", "text": "Blend 400ml of pineapple juice and 100ml cream of coconut until smooth.", "url": "https://example.com/non-alcoholic-pina-colada#step1", "image": "https://example.com/photos/non-alcoholic-pina-colada/step1.jpg" }, { "@type": "HowToStep", "name": "Fill", "text": "Fill a glass with ice.", "url": "https://example.com/non-alcoholic-pina-colada#step2", "image": "https://example.com/photos/non-alcoholic-pina-colada/step2.jpg" }, { "@type": "HowToStep", "name": "Pour", "text": "Pour the pineapple juice and coconut mixture over ice.", "url": "https://example.com/non-alcoholic-pina-colada#step3", "image": "https://example.com/photos/non-alcoholic-pina-colada/step3.jpg" } ], "video": { "@type": "VideoObject", "name": "How to Make a Non-Alcoholic Piña Colada", "description": "This is how you make a non-alcoholic piña colada.", "thumbnailUrl": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "contentUrl": "https://www.example.com/video123.mp4", "embedUrl": "https://www.example.com/videoplayer?video=123", "uploadDate": "2024-02-05T08:00:00+08:00", "duration": "PT1M33S", "interactionStatistic": { "@type": "InteractionCounter", "interactionType": { "@type": "WatchAction" }, "userInteractionCount": 2347 }, "expires": "2024-02-05T08:00:00+08:00" } } </script> </head> <body> </body> </html>
Bant
itemList
yapılandırılmış verileri içeren bir tarif özeti sayfası (tarif listesi içeren bir sayfa) örneğini burada bulabilirsiniz. Bu içerik, Arama sonuçlarında bir ızgarada görüntülenmeye uygun olabilir.
<html> <head> <title>Grandma's Best Pie Recipes</title> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "ItemList", "itemListElement": [ { "@type": "ListItem", "position": 1, "url": "https://example.com/apple-pie.html" }, { "@type": "ListItem", "position": 2, "url": "https://example.com/blueberry-pie.html" }, { "@type": "ListItem", "position": 3, "url": "https://example.com/cherry-pie.html" }] } </script> </head> <body> </body> </html>
Yönergeler
İşaretlemenizin Arama sonuçlarında görünmeye uygun olması için yapılandırılmış verilerle ilgili genel kurallara uymanız gerekir.
Aşağıdaki yönergeler Recipe
yapılandırılmış verileri için geçerlidir.
- Belirli bir yemeğin hazırlanmasıyla ilgili içerik için
Recipe
yapılandırılmış verileri kullanın. Örneğin, "yüz peelingi" veya "parti fikirleri" bir yemek için geçerli adlar değildir. - Yemek tariflerinizin bir
bantta veya ızgarada görünmesi için aşağıdaki
kurallara uymanız gerekir:
- Listenizle ilgili tarifleri özetlemek için
ItemList
yapılandırılmış verileri sağlayın.ItemList
yapılandırılmış verilerini ayrı olarak veya yapılandırılmış tarif verileriyle birlikte sağlayabilirsiniz. - Sitenizde, koleksiyondaki tüm tarifleri listeleyen bir özet sayfası olmalıdır. Örneğin, bir kullanıcı Arama sonuçlarından özet bağlantısını tıkladığında sitenizde aramasıyla ilgili tariflerin listelendiği bir sayfaya doğru şekilde yönlendirilir.
- Listenizle ilgili tarifleri özetlemek için
Yapılandırılmış veri türü tanımları
İçeriğinizin Google Arama'da zengin sonuç olarak görüntülenmeye uygun olması için gerekli özellikleri eklemeniz gerekir. İçeriğiniz hakkında daha fazla bilgi ekleyerek daha iyi bir kullanıcı deneyimi sağlamak için önerilen özellikleri de dahil edebilirsiniz.
Recipe
Tarif içeriğinizi, schema.org Recipe
türünün aşağıdaki özellikleriyle işaretleyin. Recipe
öğesinin tanımını
ayrıntılı şekilde
schema.org/Recipe adresinde bulabilirsiniz.
Google tarafından desteklenen özellikler şunlardır:
Zorunlu özellikler | |
---|---|
image
|
Tamamlanmış yemeğin resmi. Ek resim yönergeleri:
Örneğin: "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ] |
name |
Yemeğin adı. |
Önerilen özellikler | |
---|---|
aggregateRating |
Öğeye atanan ortalama yorum puanı için ek açıklama. Yorum snippet'i yönergelerini uygulayın ve hem zorunlu hem de önerilen
|
author |
Yemek tarifini yazan kişinin veya kuruluşun adı. Google'ın çeşitli özellikler kullanarak yazarları en iyi şekilde anlamasına yardımcı olmak için yazar işaretlemesiyle ilgili en iyi uygulamalara uymaya dikkat edin. |
cookTime |
Varsa, yemeğin gerçek pişme süresi (ISO 8601 biçiminde). Her zaman |
datePublished |
Varsa, ISO 8601 biçiminde tarifin yayınlandığı tarih. |
description |
Yemeğin açıklandığı kısa bir özet. |
keywords
|
Tarifiniz için mevsim ("yaz"), tatil ("Şeker Bayramı") gibi terimler veya başka açıklamalar ("pratik", "kolay", "özgün"). Ek yönergeler
|
nutrition.calories |
Bu tarifle oluşturulan her bir porsiyondaki toplam kalori
miktarı. |
prepTime |
Varsa, yemeğin malzemelerini ve çalışma alanını hazırlamak için gereken süre (ISO 8601 biçiminde). Her zaman |
recipeCategory |
Tarifinizin ilgili olduğu öğün veya yemek türü. Örneğin: "akşam yemeği", "ana yemek" veya "tatlı, atıştırmalık". |
recipeCuisine |
Tarifinizle ilişkili bölge. Örneğin, "Fransız", "Akdeniz" veya "Amerikan". |
recipeIngredient |
Yemek tarifinde kullanılan malzeme. Örneğin: "recipeIngredient": [ "1 (15 ounce) package double crust ready-to-use pie crust", "6 cups thinly sliced, peeled apples (6 medium)", "3/4 cup sugar", "2 tablespoons all-purpose flour", "3/4 teaspoon ground cinnamon", "1/4 teaspoon salt", "1/8 teaspoon ground nutmeg", "1 tablespoon lemon juice" ] Ek yönergeler:
|
recipeInstructions
|
Yemeği yapmak için gerçekleştirilecek adımlar.
Ek yönergeler
|
recipeYield |
Varsa, tarifle hazırlanan miktar. Bu tariften elde edilen porsiyon sayısını yalnızca bir sayıyla belirtin. Farklı bir birim (örneğin, öğe sayısı) kullanmak istiyorsanız ek getiri ekleyebilirsiniz. Bu, porsiyon başına besin bilgileri ( Örnek "recipeYield": [ "6", "24 cookies" ] |
totalTime |
Varsa, ISO 8601 biçiminde belirtilen, yemeği pişmeye hazırlamak için gereken süre.
|
video
|
VideoObject
Yemek hazırlama adımlarını gösteren bir video. Zorunlu ve önerilen Video özellikleri listesine uyun. |
HowToSection
Bir tarifle ilgili talimatların bir bölümünü oluşturan bir dizi adımı (veya alt bölümü)
gruplandırmak için HowToSection
kullanın. HowToSection
öğesini doğrudan
recipeInstructions
özelliğinin tanımı içinde veya başka bir HowToSection
öğesine ait bir itemListElement
olarak
belirtin.
HowToSection
türü, tek bir tarifin bir bölümünü tanımlar ve bir veya
daha fazla adımdan oluşur. Aynı yemekle ilgili farklı tarifler tanımlamak için HowToSection
kullanmayın; bunun yerine, tek bir tarifin parçası olarak HowToSection
kullanın. Bir yemekle
ilgili birden fazla tarifin listelenmesi için birden fazla Recipe
nesnesi kullanın. Örneğin, elmalı turta yapmanın birden fazla yolunu belirtmek için, bunları HowToSection
nesneleri olarak değil, birden çok Recipe
nesnesi olarak listeleyin.
HowToSection
öğesinin tam tanımını schema.org/HowToSection adresinde bulabilirsiniz.
Zorunlu özellikler | |
---|---|
itemListElement
|
HowToStep
Bölüm ve/veya alt bölümler için ayrıntılı adımların listesi. Örneğin, bir pizza tarifinde, hamurun yapılmasıyla ilgili adımlar, malzemelerin hazırlanması için bir bölüm ve karıştırıp pişirilmesi aşaması için de başka bir bölüm olabilir. Örnek: { "@type": "HowToSection", "name": "Assemble the pie", "itemListElement": [ { "@type": "HowToStep", "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate." }, { "@type": "HowToStep", "text": "Top with second crust. Cut slits or shapes in several places in top crust." } ] } |
name
|
Text
Bölümün adı. |
HowToStep
İçeriğiniz için uygunsa tarifin bir kısmının nasıl yapacağınızı açıklayan bir veya daha fazla cümleyi gruplandırmak için HowToStep
etiketini kullanın. Cümleleri içeren text
özelliğini tanımlayın
veya dönüşümlü olarak her bir cümle için HowToDirection
veya HowToTip
ile itemListElement
özeliğini tanımlayın.
Yemek tarifinizin adımlarını HowToStep türünün
aşağıdaki özellikleriyle işaretleyin. Bir HowToStep
özelliğini doğrudan recipeInstructions
özelliğinin tanımında veya HowToSection
için itemListElement
olarak belirtin.
HowToStep
öğesinin tam tanımını
schema.org/HowToStep adresinde bulabilirsiniz.
Zorunlu özellikler | |
---|---|
itemListElement
|
HowToDirection veya HowToTip
Tarifler veya ipuçları dahil olmak üzere ayrıntılı alt adımların listesi.
|
text
|
Text
Bu adımla ilgili tam talimat metni.
|
Önerilen özellikler | |
---|---|
image
|
ImageObject veya URL
Adımla ilgili bir resim. Ek resim yönergeleri:
|
name
|
Text
Adımı özetleyen kelime veya kısa ifade. Örneğin, "Elmalı turta hamurunu hazırlama". Açıklayıcı olmayan metin (örneğin, "1. Adım: [metin]") veya başka bir adım sayısı biçimi (örneğin, "1. [metin]") kullanmayın. |
url
|
URL
Doğrudan adıma bağlanan bir |
video
|
VideoObject veya Clip
Bu adım için bir video veya videonun bir klibi. |
HowToDirection
ve HowToTip
Varsa, yol tariflerini veya ipuçlarını açıklamak için HowToDirection
ve HowToTip
öğelerini kullanın.
Aynı zorunlu ve önerilen özelliklere sahiptirler.
HowToDirection
ve HowToTip
öğelerinin tam tanımlarını schema.org/HowToDirection ve schema.org/HowToTip adreslerinde bulabilirsiniz.
Zorunlu özellikler | |
---|---|
text
|
Text
Tarifin veya ipucunun metni. |
ItemList
Tarifin özelliklerine ek olarak, ana makineye özel listeler için aşağıdaki özellikleri ekleyin. ItemList
zorunlu değildir, ancak tarifinizin bir ana makine bandına uygun olmasını istiyorsanız aşağıdaki özellikleri eklemeniz gerekir. Barındırma bandı hakkında daha fazla bilgi için bkz.
Bant.
ItemList
öğesinin tam tanımını schema.org/ItemList adresinde bulabilirsiniz.
Zorunlu özellikler | |
---|---|
itemListElement
|
Tek öğe sayfası için ek açıklama. |
ListItem.position
|
Listedeki öğe sayfasının konum sırası. Örneğin: "itemListElement": [ { "@type": "ListItem", "position": 1, }, { "@type": "ListItem", "position": 2, } ] |
ListItem.url
|
Öğe sayfasının standart URL'si. Her öğenin benzersiz bir URL’si olmalıdır. |
Search Console ile zengin sonuçları izleme
Search Console, sayfalarınızın Google Arama'daki performansını izlemenize yardımcı olan bir araçtır. Google Arama sonuçlarına dahil olmak için Search Console'a kaydolmanız gerekmez, ancak Google'ın sitenizi nasıl gördüğünü anlamanıza ve iyileştirmenize yardımcı olabilir. Aşağıdaki durumlarda Search Console'u kontrol etmenizi öneririz:
- Yapılandırılmış verileri ilk kez dağıttıktan sonra
- Yeni şablonlar yayınladıktan veya kodunuzu güncelledikten sonra
- Düzenli olarak trafiği analiz etmek için
Yapılandırılmış verileri ilk kez dağıttıktan sonra
Google sayfalarınızı dizine ekledikten sonra, ilgili Zengin sonuç durum raporunu kullanarak sorunları arayın. İdeal olan, geçerli öğelerin sayısı artarken geçersiz öğelerin sayısında artış olmamasıdır. Yapılandırılmış verilerinizde sorun bulursanız:
- Geçersiz öğeleri düzeltin.
- Sorunun devam edip etmediğini kontrol etmek için yayındaki URL'yi inceleyin.
- Durum raporunu kullanarak doğrulama isteğinde bulunun.
Yeni şablonlar yayınladıktan veya kodunuzu güncelledikten sonra
Web sitenizde önemli değişiklikler yaptığınızda yapılandırılmış verilerdeki geçersiz öğelerin sayısında artış olup olmadığını takip edin.- Geçersiz öğe sayısında artış görürseniz çalışmayan yeni bir şablonu kullanıma sunmuş olabilirsiniz veya siteniz mevcut şablonla yeni ve kötü bir şekilde etkileşime giriyor olabilir.
- Geçerli öğelerde azalma görürseniz (geçersiz öğelerdeki artışla eşleşmeyen), artık sayfalarınıza yapılandırılmış veri yerleştirmiyor olabilirsiniz. Soruna neyin neden olduğunu öğrenmek için URL Denetleme aracı'nı kullanın.
Düzenli olarak trafiği analiz etme
Performans Raporu'nu kullanarak Google Arama trafiğinizi analiz edin. Veriler, sayfanızın Arama'da ne sıklıkta zengin sonuç olarak göründüğünü, kullanıcıların bu zengin sonucu ne sıklıkta tıkladığını ve arama sonuçlarında göründüğünüz ortalama konumu gösterir. Bu sonuçlara Search Console API ile otomatik olarak da ulaşabilirsiniz.Sorun giderme
Yapılandırılmış verileri uygulamada veya hata ayıklamada sorun yaşıyorsanız size yardımcı olabilecek bazı kaynaklar aşağıda verilmiştir.
- İçerik yönetim sistemi (İYS) kullanıyorsanız veya sitenizle başka biri ilgileniyorsa bu kişiden size yardım etmesini isteyin. Sorunla ilgili ayrıntılı bilgiler içeren Search Console mesajlarını bu kişiye yönlendirdiğinizden emin olun.
- Google, yapılandırılmış veriler kullanan özelliklerin arama sonuçlarında görüneceğini garanti etmez. Google'ın içeriğinizi zengin sonuç içinde göstermemesinin yaygın nedenlerini içeren liste için Genel Yapılandırılmış Veri Yönergeleri'ni inceleyin.
- Yapılandırılmış verilerinizde bir hata olabilir. Yapılandırılmış veri hatalarının listesini kontrol edin.
- Sayfanıza yönelik bir yapılandırılmış veri manuel işlemi varsa sayfadaki yapılandırılmış veriler dikkate alınmaz (sayfa Google Arama sonuçlarında görünmeye devam edebilir). Yapılandırılmış veri sorunlarını düzeltmek için Manuel İşlemler raporunu kullanın.
- İçeriğinizin kurallara uygun olup olmadığını belirlemek için yönergeleri tekrar inceleyin. Sorun, spam içeriği veya spam içerikli işaretleme kullanımından kaynaklanıyor olabilir. Bununla birlikte, sorunun söz diziminden kaynaklanmadığı durumlarda Zengin Sonuçlar Testi bu sorunları tanımlayamaz.
- Eksik zengin sonuçlar / toplam zengin sonuç sayısında düşüş sorununu giderin.
- Yeniden tarama ve yeniden dizine ekleme için zaman tanıyın. Google’ın yayınlandıktan sonra bir sayfayı bulmasının ve taramasının birkaç gün sürebileceğini unutmayın. Tarama ve dizine ekleme hakkında genel sorular için Google Arama tarama ve dizine ekleme için SSS bölümüne bakın.
- Sorunuzu Google Arama Merkezi forumunda sorun.