Dokument ten zawiera wskazówki dotyczące tworzenia źródeł danych o produktach XML w formacie Atom 1.0. Podlinkowaliśmy standardowe atrybuty do odpowiednich sekcji w oficjalnej specyfikacji Atom 1.0, aby pomóc Ci odnaleźć dodatkowe informacje o komponentach zawartych w naszych przykładach. Chociaż udostępniamy przykładowe pliki Atom 1.0, informacje o Atom 1.0 ograniczyliśmy do minimum.
Więcej informacji o tym standardzie znajdziesz w specyfikacji pod adresem Atom Syndication Format.
Aby pobrać przykładowy plik Atom 1.0, kliknij tutaj.
Sekcja 1: Atom 1.0
W oparciu o specyfikację Atom 1.0, na poziomie wstępnym jest 5 predefiniowanych elementów – tytuł, identyfikator, link, streszczenie i aktualizacja. Chociaż są one opcjonalne w standardzie Atom 1.0, źródła danych o produktach ich wymagają.
Źródła danych o produktach wymagają także dodatkowych elementów, takich jak cena czy stan. Aby można było uwzględnić inne szczegółowe informacje o produkcie, rozszerzyliśmy Atom 1.0 o przestrzeń nazw Google Merchant Center. Jej zdefiniowanie umożliwia dodanie elementów zwanych „atrybutami”, a także zwiększa ilość informacji, jakie można dodać o każdym z produktów za pomocą źródła danych o produktach.
Poniżej znajduje się przykład podstawowego dokumentu Atom 1.0 zawierającego jedną pozycję:
<?xml version="1.0"?>
<plik danych xmlns="http://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://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://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://google.com/images/google_sm.gif</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>
</entry> </plik danych>
Dwie główne zmiany w tym przykładzie to dodatkowa deklaracja przestrzeni nazw i uwzględnienie 3 atrybutów (link do zdjęcia [image_link], cena [price] i stan [condition]).
Deklaracja przestrzeni nazw Google Merchant Center
Poniższa deklaracja przestrzeni nazw jest wymagana, aby możliwe było korzystanie z atrybutów zdefiniowanych w przestrzeni nazw Google Merchant Center.
xmlns:g="http://base.google.com/ns/1.0"
Oprócz deklaracji przestrzeni nazw Google Merchant Center konieczne jest również dodanie prefiksu do każdego tagu atrybutu. Ma to na celu odróżnienie atrybutów zdefiniowanych w naszej przestrzeni nazw od elementów zdefiniowanych w Atom 1.0. Prefiks wybrany do tej deklaracji przestrzeni nazw to „g”:
<g:image_link>http://google.com/images/google_sm.gif</g:image_link>
Atrybuty w przestrzeni nazw Google Merchant Center muszą zawierać ten prefiks, w przeciwnym razie zostaną zignorowane wraz z przypisanymi do nich wartościami.
Atrybuty
Możesz zastosować dowolną liczbę atrybutów. Podanie dodatkowych informacji o Twoich produktach za ich pomocą znacznie zwiększy szanse Twoich produktów na pojawienie się w wynikach wyszukiwania. Dodatkowo wiele atrybutów zdefiniowanych w przestrzeni nazw Google Merchant Center można w ramach jednego produktu stosować więcej niż raz. Dzięki temu możesz dodać więcej istotnych informacji o produktach w źródle danych o produktach.
Sekcja 2. Ważna lista kontrolna
Przed przesłaniem źródła danych o produktach sprawdź, czy jego formatowanie jest poprawne, korzystając z poniższej listy:
Nazwa pliku musi być zakończona rozszerzeniem .xml.
Nazwa pliku źródła danych o produktach zarejestrowana na koncie Google Merchant Center musi być taka sama jak nazwa samego pliku.
Pamiętaj o umieszczeniu deklaracji przestrzeni nazw. Wartości muszą zgadzać się z poniższymi.
- Przestrzeń nazw Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - Przestrzeń nazw atrybutów niestandardowych:
xmlns:[prefix]="http://base.google.com/cns/1.0", gdzie prefiks [prefix] jest zastępowany przez prefiks zawarty w pliku.
Sprawdź, czy prefiks w tagach atrybutów w Google Merchant Center i niestandardowym Google Merchant Center zgadza się z prefiksem zdefiniowanym w deklaracji przestrzeni nazw.
Usuń atrybuty niezawierające żadnych wartości.
Sekcja 3. Uwagi końcowe
Przykładowy wpis w dokumencie został uproszczony, by lepiej zobrazować podstawy tworzenia źródła danych o produktach w formacie XML dla Google Merchant Center. Chociaż akceptujemy źródła danych o produktach zawierające inne elementy zdefiniowane w standardzie Atom 1.0 lub w Twojej własnej przestrzeni nazw, wszelkie informacje w nich zawarte będą ignorowane podczas przetwarzania i nie pojawią się w reklamach ani bezpłatnych informacjach o produkcie. Na tym etapie przetwarzane będą jedynie dane zawarte w domyślnych elementach Atom 1.0 oraz w atrybutach w przestrzeniach nazw Google Merchant Center i niestandardowego Google Merchant Center.