Bu dokümanda, Atom 0.3 biçiminde XML ürün veri feed'i oluşturmaya ilişkin yönergeler açıklanmaktadır. Örneklerimizdeki bileşenler hakkında ek bilgi bulmanıza yardımcı olması için, standart özellikler ile resmi Atom 0.3 spesifikasyonunun bu özelliklerle ilgili bölümleri arasında bağlantı oluşturduk. Atom 0.3 dosyaları için örnekler sunsak da Atom 0.3'ün kendisi hakkında çok az ayrıntı sağlıyoruz.
1. Bölüm: Atom 0.3
Atom 0.3 spesifikasyonu uyarınca, giriş düzeyinde title [ad], link [bağlantı], id [no] ve modified [değiştirilme] olmak üzere önceden tanımlanmış dört unsur bulunmaktadır. Bu unsurlar, Atom 0.3 standardında isteğe bağlı olmalarına rağmen veri feed'iniz için gereklidir.
Veri feed'iniz, fiyat ve durum gibi ek unsurları da gerektirir. Bu unsurlara ve ürünlerle ilgili daha ayrıntılı bilgilere yer vermek için Google Merchant Center ad alanını ekleyerek Atom 0.3'ü genişlettik. Google Merchant Center ad alanını tanımlayarak "özellikler" adı verilen ek unsurları kullanabilir ve feed'de tüm ürünler için daha fazla bilgi sunabilirsiniz.
Tek bir ürün içeren temel bir Atom 0.3 dokümanı örneğini aşağıda bulabilirsiniz:
<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"
xmlns:g="http://base.google.com/ns/1.0"><title>Veri feed'inizin adı</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>Kırmızı yün kazak</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Bu rahat ve yumuşak kazak soğuk kış gecelerinde sizi sıcak tutar.</summary> <id>tag:google.com,2005-10-15:/support/products</id> <issued>2005-10-13T18:30:02Z</issued> <modified>2005-10-13T18:30:02Z</modified>
<g:image_link>http://www.example.com/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>yeni</g:condition> </entry> </feed>
Bu örnekte yapılan iki önemli ekleme, ad alanı beyanının (üçüncü satırda) ve üç özelliğin (resim bağlantısı [image_link], fiyat [price] ve durum [condition]) eklenmesidir.
Google Merchant Center Ad Alanı Beyanı
Yalnızca Google Merchant Center ad alanında tanımlanmış özelliklerin kullanılabilmesi için aşağıdaki ad alanı beyanı gereklidir.
xmlns:g="http://base.google.com/ns/1.0"
Google Merchant Center ad alanını beyan ettikten sonra her özellik etiketine bir önek eklemeniz gerekir. Bu ön eki, ad alanımızda tanımlanan özellikleri Atom 0.3'te tanımlanan unsurlardan ayırmak için özelliklere ekleriz. Şu ad alanı beyanı için seçilen ön ek "g"dir:
<g:image_link>http://www.example.com/image1.jpg</g:image_link>Google Merchant Center ad alanındaki özellikler bu ön eki içermelidir. Aksi takdirde, özellikler ve içerdikleri tüm değerler göz ardı edilir.
Özellikler
Ürünlerinize özgü, istediğiniz kadar çok sayıda alakalı özellik kullanabilirsiniz. Bu özellikleri kullanarak ürünleriniz hakkında ek bilgi sağlamak, ürünlerinizin sonuçlarda gösterilme olasılığını büyük oranda artırır. Ayrıca Google Merchant Center ad alanında tanımlanan birçok özellik, tek bir üründe birden fazla kez kullanılabilir. Bu da feed'inizdeki bir ürünle ilgili daha fazla bilgi eklemenize olanak tanır.
2. Bölüm: Önemli Kontrol Listesi
Feed'inizi göndermeden önce, dosyanızın doğru biçimlendirilmiş olduğundan emin olmanıza yardımcı olması için aşağıdaki listeyi gözden geçirmenizi özellikle öneririz:
- Dosyanızın adı .xml uzantısıyla bitmelidir.
- Google Merchant Center hesabınızda kaydettiğiniz feed dosya adı, dosyanıza atadığınız adla aynı olmalıdır.
- Ad alanı beyanlarını eklemeyi unutmayın. Bu değerler tam olarak aşağıda gösterildiği gibi olmalıdır.
- Google Merchant Center ad alanı:
xmlns:g="http://base.google.com/ns/1.0". - Özel özellik ad alanı:
xmlns:[ön ek]="http://base.google.com/cns/1.0". [ön ek], dosyanızda yer alan ön ekle değiştirilir.
- Google Merchant Center ad alanı:
- Google Merchant Center ve Özel Google Merchant Center özellik etiketlerine eklenmiş ön ekin, ad alanı beyanında tanımlanan ön ekle eşleştiğini doğrulayın.
- Herhangi bir değer içermeyen özellikleri kaldırın.
3. Bölüm: Son Not
Bu dokümanda yer verilen örnek giriş, Google Merchant Center XML veri feed'i oluşturmanın temel yönlerine daha net odaklanılmasına izin verecek şekilde basitleştirilmiştir. Atom 0.3 standardında veya kendi ad alanınızda tanımlanan diğer unsurları içeren feed'leri kabul ediyoruz, ancak bu unsurların içerdiği tüm bilgiler, işleme sırasında göz ardı edilir ve listelemelerinizde görünmez. Şu an için sadece varsayılan Atom 0.3 unsurlarında ve Google Merchant Center ile Özel Google Merchant Center ad alanlarındaki özelliklerde bulunan verileri işliyoruz.