I dette dokumentet får du veiledning om hvordan du kan opprette en XML-produktdatakilde i formatet Atom 0.3. Vi har knyttet standardattributter til deres respektive deler i de offisielle Atom 0.3-spesifikasjonene, så du kan finne mer 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 obligatoriske i produktdatakilden.
I produktdatakilden er det også påkrevd med flere elementer, inkludert pris og tilstand. 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 – såkalte «attributter» – til å oppgi mer informasjon om hvert produkt i en produktdatakilde.
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>The name of your product data source</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>Red wool sweater</title> <link href="http://www.example.com/item1-info-page.html" /> <summary>Comfortable and soft, this sweater will keep you warm on those cold winter nights.</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å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 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 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 0.3-standarden eller ditt eget navneområde, men eventuell informasjon i disse elementene ignoreres under behandlingen 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.