Atom 0.3-spesifikasjoner

Dette dokumentet inneholder retningslinjer for hvordan du kan opprette en XML-produktdatafeed i formatet Atom 0.3. Vi har knyttet standardattributter til deres respektive deler i de offisielle Atom 0.3-spesifikasjonene, så du kan finne ytterligere informasjon om komponentene vi nevner i eksemplene. Selv om vi viser eksempelfiler med formatet Atom 0.3, besørger vi svært lite informasjon om formatet Atom 0.3 i seg selv.

Del 1: Atom 0.3

Basert på Atom 0.3-spesifikasjonene er det fire forhåndsdefinerte elementer på inngangsnivå – «title», «link», «id» og «modified». Selv om disse elementene er valgfrie i Atom 0.3-standarden, er de påkrevd i datafeeden.

I datafeed er det også påkrevd med flere elementer, inkludert «price» og «condition». For at det skal være mulig å ta med disse elementene og mer detaljert informasjon om et produkt, har vi utvidet Atom 0.3 ved å legge til Google Merchant Center-navneområdet. Ved å definere Google Merchant Center-navneområdet kan du bruke tilleggselementer – kalt «attributter» – og oppgi mer informasjon om hvert enkelt produkt i en feed.

Nedenfor kan du se et eksempel på et enkelt Atom 0.3-dokument med ett 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>Navnet på datafeeden</title> <link href="http://www.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 ullgenser</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Denne myke, deilige genseren holder deg varm på kalde vinterkvelder.</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://www.example.com/image1.jpg</g:image_link> <g:price>25</g:price> <g:condition>new</g:condition>

</entry> </feed>

De to hovedtilleggene i dette eksempelet er deklarasjonen for navneområdet (på tredje linje) og følgende tre attributter: bildelink [image_link], pris [price] og tilstand [condition].

Navneområdedeklarasjon for Google Merchant Center

Den følgende deklarasjonen av navneområdedet er nødvendig for å kunne bruke attributter som er definert bare i Google Merchant Center-navneområdet.

xmlns:g="http://base.google.com/ns/1.0"

I tillegg til å deklarere Google Merchant Center-navneområdet må du også ta med et prefiks i alle attributtagger. Vi legger til dette prefikset i attributter for å kunne skille mellom attributter som er definert i navneområdet vårt, og elementer som er definert i Atom 0.3. Prefikset som er valgt for denne navneområdedeklarasjonen, er «g»:

<g:image_link>http://www.example.com/image1.jpg</g:image_link>

Attributter i Google Merchant Center-navneområdet må inneholde dette prefikset, ellers blir attributtene, og verdiene de eventuelt inneholder, ignorert.

Attributter

Du kan bruke så mange relevante attributter som produktene dine tilsier. Hvis du viser tilleggsopplysninger om produktene dine ved å bruke disse attributtene, øker sjansen betraktelig for at produktene dine vises i resultater. Dessuten kan flere av attributtene som er definert i Google Merchant Center-navneområdet, brukes gjentatte ganger for ett og samme produkt. Dette gjør at du kan ta med enda mer informasjon om et produkt i feeden din.

Del 2: Viktig sjekkliste

Vi anbefaler på det varmeste at du går punktvis gjennom denne listen før du sender inn strømmen, så du kan forsikre deg om at filen er formatert slik den skal.

1. Filnavnet skal ende med filetternavnet .xml.
2. Strømmens filnavn som du registrerer i Google Merchant Center-kontoen, må stemme overens med navnet du gir filen din.
3. Husk å ta med navneområdedeklarasjoner. Disse verdiene skal være nøyaktig slik:
   1. Google Merchant Center-navneområde: xmlns:g="http://base.google.com/ns/1.0".
   2. Navneområde for tilpasset attributt: xmlns:[prefix]="http://base.google.com/cns/1.0", der [prefix] erstattes av prefikset du har inkludert i filen din.
4. Bekreft at prefikset som er inkludert i de vanlige og tilpassede Google Merchant Center-attributtaggene, stemmer overens med prefikset som er definert i deklarasjonen av navneområdet.
5. Fjern attributter som ikke inneholder noen verdier.

Del 3: Helt til slutt

Eksemplene i dette dokumentet er forenklet for å rette fokus mot de grunnleggende kunnskapene som kreves for å lage en XML-datafeed for Google Merchant Center. Vi godtar riktignok feeder med andre elementer som er definert i Atom 0.3-standarden eller i ditt eget navneområde, men eventuelle opplysninger i disse elementene blir ignorert under behandling og vises ikke i oppføringene dine. Per nå behandler vi bare data fra standard Atom 0.3-elementer og attributter i vanlige og tilpassede Google Merchant Center-navneområder.