Bu belgede, Atom 1.0 biçiminde XML ürün verileri kaynağı oluşturmayla ilgili yönergeler açıklanmıştır. Örneklerimizdeki bileşenler hakkında ek bilgi bulmanıza yardımcı olması için, standart özellikler ile resmi Atom 1.0 spesifikasyonunun bu özelliklerle ilgili bölümleri arasında bağlantı oluşturduk. Atom 1.0 dosyaları için örnekler sunsak da Atom 1.0'ın kendisi hakkında çok az ayrıntı sağlıyoruz.
Bu standart hakkında daha fazla bilgi edinmek istiyorsanız Atom Sendikasyon Biçimi sayfasından bu spesifikasyona göz atmanızı öneririz.
Atom 1.0 örnek dosyasını indirmek için lütfen burayı tıklayın.
1. Bölüm: Atom 1.0
Atom 1.0 spesifikasyonu uyarınca giriş düzeyinde başlık, no, bağlantı, özet ve güncellenme olmak üzere önceden tanımlanmış beş unsur bulunmaktadır. Bu unsurlar, Atom 1.0 standardında isteğe bağlı olmasına rağmen ürün verisi kaynaklarında zorunludur.
Ürün verisi kaynaklarında fiyat ve durum gibi ilave unsurlar da zorunludur. Bir öğe hakkında daha ayrıntılı bilgilere yer vermek için Google Merchant Center ad alanını ekleyerek Atom 1.0'ı genişlettik. Google Merchant Center ad alanını tanımlayarak "özellikler" adı verilen ek unsurları kullanabilir ve ürün verileri kaynağındaki tüm ürünlerle ilgili daha fazla bilgi sunabilirsiniz.
Tek öğe içeren temel bir Atom 1.0 belgesi örneği:
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>The name of your product data source</title> <link href="http://www.example.com" rel="alternate" type="text/html" /> <updated>2006-06-11T18:30:02Z</updated> <author> <name>Google</name> </author>
<id>tag:example.com,2006-06-11:/support/products</id> <entry>
<title>Red wool sweater</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Comfortable and soft, this sweater will keep you warm on those cold winter nights.</summary>
<updated>2005-10-13T18:30:02Z</updated>
<g:image_link>http://www.google.com/images/google_sm.gif</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 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 1.0'da 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.google.com/images/google_sm.gif</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 sayede, ürün verileri kaynağınızda bir ürün hakkında daha fazla bilgi ekleyebilirsiniz.
2. Bölüm: Önemli Yapılacaklar Listesi
Ürün verileri kaynağınızı göndermeden önce, dosyanızın doğru biçimlendirildiğinden emin olmanız için aşağıdaki listeyi incelemeniz kesinlikle önerilir:
Dosyanızın adı, .xml uzantısıyla bitmelidir.
Google Merchant Center hesabınıza kaydettiğiniz ürün verileri kaynağı dosyasının adı, dosyanıza atadığınız adla eşleşmelidir.
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 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 belgede yer verilen örnek giriş, Google Merchant Center XML ürün verileri kaynağı oluşturmanın temellerine daha rahat odaklanabilmeniz için basitleştirilmiştir. Atom 1.0 standardında veya kendi ad alanınızda tanımlanan diğer öğeleri içeren ürün veri kaynaklarını kabul etsek de bu öğelerin içerdiği bilgiler, işleme sırasında göz ardı edilecek ve reklamlarınızda ya da ücretsiz ürün listelemelerinizde gösterilmeyecektir. Şu an için sadece varsayılan Atom 1.0 öğelerinde ve Google Merchant Center ile Özel Google Merchant Center ad alanlarındaki özelliklerde bulunan verileri işliyoruz.