Tento dokument obsahuje pokyny k vytvoření zdroje produktových dat v XML pro formát Atom 1.0. Na pomoc s nalezením dalších informací o komponentách z našich příkladů jsme do standardních atributů vložili odkazy na odpovídající části v oficiální specifikaci formátu Atom 1.0. Uvádíme sice příklady souborů ve formátu Atom 1.0, avšak o samotném formátu Atom 1.0 příliš mnoho informací neposkytujeme.
Pokud o tomto standardu chcete získat další informace, přečtěte si tuto specifikaci ve syndikačním formátu Atom.
Ukázkový soubor ve formátu Atom 1.0 můžete stáhnout kliknutím sem.
Část 1: Atom 1.0
Na základě specifikace formátu Atom 1.0 existuje na základní úrovni pět předem definovaných prvků – název, ID, odkaz, shrnutí a aktualizace. Ačkoli jsou tyto prvky ve standardu Atom 1.0 nepovinné, zdroje produktových dat je vyžadují.
Zdroje produktových dat vyžadují také další prvky, jako je cena a stav. Aby bylo možné uvést o položce více informací, rozšířili jsme formát Atom 1.0 o jmenný prostor služby Google Merchant Center. Vymezení jmenného prostoru služby Google Merchant Center vám umožňuje používat další prvky, které se nazývají atributy. Díky tomu lze o každém produktu ve zdroji produktových dat poskytnout větší množství informací.
Níže je uveden příklad základního dokumentu ve formátu Atom 1.0. Dokument obsahuje jedinou položku:
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>Název zdroje produktových dat</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>Červený vlněný svetr</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Tento pohodlný měkký svetr vás zahřeje o chladných zimních večerech.</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>new</g:condition>
</entry> </feed>
V tomto příkladu jsou použity dva důležité přidané prvky – deklarace jmenného prostoru a tři atributy (url obrázku [image_link], cena [price] a stav [condition]).
Deklarace jmenného prostoru služby Google Merchant Center
Atributy vymezené pouze ve jmenném prostoru služby Google Merchant Center lze použít jen za předpokladu, že je uvedena následující deklarace oboru názvů.
xmlns:g="http://base.google.com/ns/1.0"
Kromě deklarace jmenného prostoru služby Google Merchant Center musí také každá značka atributu obsahovat zvláštní předponu. Tuto předponu přidáváme k atributům a odlišujeme tak atributy definované v našem oboru názvů od prvků definovaných ve standardu Atom 1.0. Předpona vybraná pro tento obor názvů je „g“:
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>
Pokud atributy ze jmenného prostoru služby Google Merchant Center tuto předponu neobsahují, budou tyto atributy i všechny jejich hodnoty ignorovány.
Atributy
Můžete použít tolik relevantních atributů, kolik jich pro své produkty potřebujete. Uvedete-li doplňující informace o produktech pomocí těchto atributů, výrazně zvýšíte šanci, že se vaše produkty zobrazí ve výsledcích vyhledávání. Řadu atributů stanovených ve jmenném prostoru služby Google Merchant Center je možné použít více než jednou u jednoho produktu. Do zdroje produktových dat tak můžete přidat více dostupných informací o produktu.
Část 2: Kontrolní seznam
Před odesláním zdroje produktových dat doporučujeme projít si následující seznam, který pomůže zajistit správné formátování souboru:
Název souboru musí končit příponou .xml.
Název souboru zdroje produktových dat, který zaregistrujete v účtu služby Google Merchant Center, se musí shodovat s názvem přiřazeným souboru.
Nezapomeňte uvést deklarace jmenného prostoru. Tyto hodnoty musí přesně odpovídat níže uvedenému:
- Jmenný prostor služby Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - Jmenný prostor vlastních atributů:
xmlns:[prefix]="http://base.google.com/cns/1.0", kde část [prefix] je nahrazena předponou, kterou jste vložili do souboru.
Ověřte, jestli se předpona uvedená ve značkách atributů služeb Google Merchant Center a Custom Google Merchant Center shoduje s předponou uvedenou v deklaraci jmenného prostoru.
Odeberte atributy, které neobsahují žádné hodnoty.
Část 3: Závěrečná poznámka
Příklad záznamu uvedeného v tomto dokumentu byl zjednodušen, aby bylo možné věnovat více pozornosti základům sestavování zdroje produktových dat pro službu Google Merchant Center v jazyce XML. Ačkoli přijímáme zdroje produktových dat obsahující i další prvky definované ve standardu Atom 1.0 nebo ve vašem vlastním jmenném prostoru, informace, které tyto prvky obsahují, budou při zpracování ignorovány a v reklamách ani v neplacených záznamech produktu se zobrazovat nebudou. Teď zpracujeme pouze data obsažená ve výchozích prvcích formátu Atom 1.0 a atributech ve jmenném prostoru služby Google Merchant Center a Custom Google Merchant Center.