Atom 1.0-specifikationen

Det här dokumentet ger riktlinjer för att skapa ett XML-produktdataflöde i Atom 1.0-format. Vi har länkat standardattribut till sina respektive avsnitt i den officiella Atom 1.0-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 1.0-filer, skriver vi inte mycket om själva Atom 1.0. Om du är intresserad av att läsa mer om den här standarden, föreslår vi att du läser specifikationen på the Atom Syndication Format.

Klicka här om du vill ladda ned en RSS 1.0-exempelfil.

Avsnitt 1: Atom 1.0

Enligt Atom 1.0-specifikationen finns det fem fördefinierade element på ingångsnivå – title, id, link, summary och updated. Även om dessa element är valfria i Atom 1.0-standarden måste de vara med i produktdataflöden.

Produktdataflöden måste även innehålla ytterligare element, som price och condition. För att inkludera mer detaljerad information om en vara har vi utökat Atom 1.0 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 ett flöde.

Nedan är ett exempel på ett enkelt Atom 1.0-dokument som innehåller en enda artikel:

<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"

xmlns:g="http://base.google.com/ns/1.0">
<title>Namnet på ditt dataflöde</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>Röd ylletröja</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Den här sköna och mjuka tröjan håller dig varm under de kalla vinterdagarna.</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>ny</g:condition>
</entry> </feed>

 

De två främsta tilläggen i det här exemplet är tillägget av namnrymdsdeklarationen 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 1.0. Prefixet som har valts för denna namnrymdsdeklaration är g:

<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>

Attribut i namnrymden Google Merchant Center måste ha det här prefixet, annars ignoreras attributen och de värden 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 ditt flöde.

Avsnitt 2: Viktig checklista

Innan du skickar in flödet rekommenderar vi att du går igenom följande lista och ser till att filen är korrekt formaterad:

1. Filnamnet måste avslutas med .xml.
2. Flödesfilnamnet som du registrerar i ditt Google Merchant Center-konto måste överensstämma med namnet du ger filen.
3. Kom ihåg att infoga namnrymdsdeklarationer. Dessa värden måste vara exakt desamma som dessa:
   1. Namnrymd för Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. 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.
4. Kontrollera att prefixet i Google Merchant Center- och Custom Google Merchant Center-attributtaggar matchar prefixet som definieras i namnrymdsdeklarationen.
5. 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 ett Google Merchant Center XML-dataflöde. Vi accepterar visserligen flöden som innehåller andra element som har definierats i Atom 1.0-standarden eller i din egen namnrymd, men all information som dessa element innehåller ignoreras under bearbetningen och visas inte i dina annonser eller gratis produktannonser. För närvarande bearbetar vi bara data i Atom 1.0-standardelement och i attribut i namnrymderna Google Merchant Center och Custom Google Merchant Center.