Det här dokumentet ger riktlinjer för att skapa en XML-produktdatakälla i Atom 0.3-format. Vi har länkat standardattribut till sina respektive avsnitt i den officiella Atom 0.3-specifikationen för att hjälpa dig att hitta ytterligare information om de komponenterna i våra exempel. Även om vi ger exempel på Atom 0.3-filer, skriver vi inte mycket om själva Atom 0.3.
Avsnitt 1: Atom 0.3
Enligt Atom 0.3-specifikationen finns det fyra fördefinierade element på postnivå – title [titel], link [länk], id [id] och modified [ändrat]. Även om dessa element är valfria i Atom 0.3-standarden måste de vara med i produktdatakällan.
Produktdatakällan kräver även ytterligare element, såsom price och condition. För att inkludera dessa element och mer detaljerad information om en produkt har vi utökat Atom 0.3 genom att lägga till namnrymden Google Merchant Center. Om du definierar namnrymden Google Merchant Center kan du använda ytterligare element, kallade attribut, som ökar mängden information som går att ge om varje produkt i en produktdatakälla.
Nedan finns ett exempel på ett enkelt Atom 0.3-dokument som innehåller en enda produkt:
<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"
xmlns:g="http://base.google.com/ns/1.0"><title>Namnet på din produktdatakälla</title> <link href="http://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>Röd ylletröja</title> <link href="http://example.com/item1-info-page.html" /> <summary>Mjuk och skön ylletröja som håller dig varm under kalla vinterkvällar.</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://example.com/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition> </entry> </feed>
De två främsta tilläggen i det här exemplet är tillägget av namnrymdsdeklarationen (på den tredje raden) och tre attribut (bildlänk [image_link], pris [price] och skick [condition]).
Namnområdesdeklaration för Google Merchant Center
Följande namnområdesdeklaration krävs för att använda attribut som bara är definierade i namnområdet Google Merchant Center.
xmlns:g="http://base.google.com/ns/1.0"
Förutom att deklarera namnrymden Google Merchant Center måste du också inkludera ett prefix inom varje attributtagg. Vi lägger till detta prefix i attribut för att särskilja attribut som definieras i vår namnrymd från element som definieras i Atom 0.3. Prefixet som har valts för denna namnrymdsdeklaration är g:
<g:image_link>http://example.com/image1.jpg</g:image_link>Attribut i namnområdet Google Merchant Center måste ha det här prefixet, annars ignoreras attributen och värdena de innehåller.
Attribut
Du kan använda så många relevanta attribut som är specifika för dina produkter. Om du lämnar kompletterande information om dina produkter genom att använda dessa attribut ökar chanserna avsevärt att de visas i resultat. Dessutom kan många attribut som definieras i namnrymden Google Merchant Center användas mer än en gång i samma produkt. Detta innebär att du kan lägga till mer tillgänglig information om en produkt i din produktdatakälla.
Avsnitt 2: Viktig checklista
Innan du skickar din produktdatakälla rekommenderar vi starkt att du går igenom följande lista för att se till att filen har korrekt format:
Filnamnet måste avslutas med .xml.
Filnamnet på produktdatakällan som du registrerar i ditt Google Merchant Center-konto måste överensstämma med namnet du ger filen.
Kom ihåg att infoga namnrymdsdeklarationer. Dessa värden måste vara exakt desamma som dessa:
- Namnrymd för Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - Namnrymd för anpassade attribut:
xmlns:[prefix]="http://base.google.com/cns/1.0", där [prefix] ersätts av det prefix du har inkluderat i din fil.
Kontrollera att prefixet i Google Merchant Center- och Custom Google Merchant Center-attributtaggar matchar prefixet som definieras i namnrymdsdeklarationen.
Ta bort attribut som inte innehåller några värden.
Avsnitt 3: En sista anmärkning
Postexemplet i det här dokumentet har förenklats för att ge tydligare fokus på grunderna i hur man konstruerar en Google Merchant Center XML-produktdatakälla. Även om vi accepterar produktdatakällor som innehåller andra element definierade i Atom 0.3-standarden eller i din egen namnrymd, kommer all information som dessa element innehåller att ignoreras under bearbetningen och de kommer inte att visas i din produktinformation. För närvarande bearbetar vi bara data i Atom 0.3-standardelement och i attribut i namnrymderna Google Merchant Center och Custom Google Merchant Center.