I dette dokumentet får du veiledning om hvordan du kan opprette en XML-produktdatakilde i formatet Atom 1.0. Vi har knyttet standardattributtene til de tilhørende delene i de offisielle spesifikasjonene for Atom 1.0, så du kan finne mer informasjon om komponentene i eksemplene våre. Selv om vi viser eksempelfiler med formatet Atom 1.0, forklarer vi lite om selve formatet Atom 1.0.
Hvis du vil vite mer om denne standarden, kan du ta en titt på spesifikasjonene i dokumentet om syndikeringsformatet Atom.
Klikk her for å laste ned en eksempelfil i formatet Atom 1.0.
Del 1: Atom 1.0
Basert på Atom 1.0-spesifikasjonen er det fem forhåndsdefinerte elementer på inngangsnivå – «title», «id», «link», «summary» og «updated». Selv om disse elementene er valgfrie i Atom 1.0-standarden, er de påkrevd i produktdatakilder.
I produktdatakilder kreves det også tilleggselementer som pris og tilstand. For å få med mer detaljert informasjon om en vare har vi utvidet Atom 1.0 ved å legge til Google Merchant Center-navneområdet. Ved å definere Google Merchant Center-navneområdet kan du bruke tilleggselementer – såkalte «attributter» – til å oppgi mer informasjon om hvert produkt i en produktdatakilde.
Nedenfor kan du se et eksempel på et enkelt Atom 1.0-dokument med én vare:
<?xml version="1.0"?>
<feed 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> </feed>
De to viktigste tilleggene i dette eksempelet er deklarasjonen av navneområdet og tre attributter: bildelink [image_link], pris [price] og tilstand [condition].
Deklarasjon av Google Merchant Center-navneområdet
Den følgende deklarasjonen av navneområdet er nødvendig for å kunne bruke attributter som bare er definert 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 ta med et prefiks i alle attributt-tagger. Vi legger til dette prefikset i attributter for å skille mellom attributter definert i navneområdet vårt og elementer definert i Atom 1.0. Prefikset for deklarasjonen av dette navneområdet er «g»:
<g:image_link>http://google.com/images/google_sm.gif</g:image_link>
Attributter i Google Merchant Center-navneområdet må inneholde dette prefikset, ellers blir attributtene (og eventuelle verdier de 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 flere ganger for det samme produktet. Dette gjør at du kan ta med enda mer informasjon om hvert produkt i datafeeden.
Del 2: Viktig sjekkliste
Før du sender inn produktdatakilden, anbefaler vi må det sterkeste at du går gjennom denne listen for å sjekke om filen er riktig formatert:
Filnavnet skal slutte på .xml.
Filnavnet du registrerer for produktdatakilden i Google Merchant Center-kontoen, må være det samme som navnet du gir filen.
Husk å ta med deklarasjoner av navneområder. Disse verdiene skal være nøyaktig slik:
- Google Merchant Center-navneområde:
xmlns:g="http://base.google.com/ns/1.0". - Navneområde for tilpassede attributter:
xmlns:[prefix]="http://base.google.com/cns/1.0", der [prefix] erstattes av prefikset du har inkludert i filen.
Sjekk at prefikset i de vanlige og tilpassede Google Merchant Center-attributtaggene stemmer med prefikset som er definert i deklarasjonen av navneområdet.
Fjern attributter som ikke inneholder noen verdier.
Del 3: Helt til slutt
Eksempelet i dette dokumentet er forenklet for å rette fokus mot de grunnleggende kunnskapene som trengs for å lage XML-produktdatakilder for Google Merchant Center. Vi godtar produktdatakilder som inneholder andre elementer som er definert i Atom 1.0-standarden eller ditt eget navneområde, men eventuell informasjon i disse elementene ignoreres under behandlingen og vises ikke i annonsene eller de kostnadsfrie produktoppføringene dine. Per nå behandler vi bare data fra standard Atom 1.0-elementer og attributter i vanlige og tilpassede Google Merchant Center-navneområder.