Dit document bevat richtlijnen voor het maken van een XML-productdatafeed in de Atom 1.0-indeling. We hebben standaardkenmerken gekoppeld aan hun respectieve beschrijvingen in de officiële Atom 1.0-specificatie. Zo kunt u aanvullende informatie zoeken over de componenten in onze voorbeelden. Hoewel we wel voorbeelden bieden van Atom 1.0-bestanden, geven we een minimum aan informatie over Atom 1.0 zelf.
Als u meer wilt weten over deze standaard, raden we u aan om deze specificatie te lezen over het Atom Syndication Format.
Klik hier om een Atom 1.0-voorbeeldbestand te downloaden.
Deel 1: Atom 1.0
Volgens de Atom 1.0-specificatie zijn er vijf vooraf gedefinieerde elementen op het invoerniveau: titel (title), ID (id), link (link), samenvatting (summary) en bijgewerkt (updated). Hoewel deze elementen in de Atom 1.0-standaard optioneel zijn, zijn ze verplicht voor productgegevensbronnen.
Voor productgegevensbronnen zijn ook aanvullende elementen nodig, zoals prijs en staat. Om gedetailleerdere productinformatie op te kunnen nemen, hebben we Atom 1.0 uitgebreid met de naamruimte voor het Google Merchant Center. Als u de naamruimte voor Google Merchant Center definieert, kunt u aanvullende elementen gebruiken, die kenmerken worden genoemd. Kenmerken stellen u in staat meer informatie te geven over elk product in uw productgegevensbron.
Hieronder vindt u een voorbeeld van een basisdocument voor Atom 1.0 met één artikel:
<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom"
xmlns:g="http://base.google.com/ns/1.0">
<title>De naam van uw productgegevensbron</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>Rode wollen trui</title> <id>1a</id> <link href="http://www.example.com/item1-info-page.html" /> <summary>Deze trui is comfortabel en zacht, en houdt u lekker warm tijdens koude winteravonden.</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>new</g:condition>
</entry> </feed>
De 2 belangrijkste toevoegingen in dit voorbeeld zijn de naamruimtedeclaratie en de opname van 3 kenmerken (afbeeldingslink [image_link], prijs [price], en staat [condition]).
Naamruimtedeclaratie van Google Merchant Center
De volgende naamruimtedeclaratie is vereist om kenmerken te gebruiken die alleen in de naamruimte van Google Merchant Center zijn gedefinieerd.
xmlns:g="http://base.google.com/ns/1.0"
Naast het declareren van de naamruimte voor het Google Merchant Center moet u ook een voorvoegsel toevoegen in elke kenmerktag. Dit voorvoegsel voegen we aan kenmerken toe om kenmerken in onze naamruimte te onderscheiden van elementen die zijn gedefinieerd in Atom 1.0. Het voorvoegsel dat voor de naamruimtedeclaratie is geselecteerd, is 'g':
<g:image_link>http://www.google.com/images/google_sm.gif</g:image_link>
Kenmerken in de naamruimte van het Google Merchant Center moeten dit voorvoegsel bevatten. Is dit niet het geval, dan worden de kenmerken en alle waarden van deze kenmerken genegeerd.
Kenmerken
U kunt alle relevante kenmerken gebruiken die geschikt zijn voor uw producten. Als u met deze kenmerken extra informatie opgeeft over uw producten, is de kans een stuk groter dat uw producten in zoekresultaten worden weergegeven. Daarnaast kunnen veel kenmerken die in de naamruimte van Google Merchant Center zijn gedefinieerd, meerdere keren voor een zelfde product worden gebruikt. Hierdoor kunt u meer beschikbare informatie over een product toevoegen aan uw productgegevensbron.
Deel 2: Belangrijke controles
Voordat u uw productgegevensbron indient, raden we u aan te controleren of uw bestand de juiste indeling heeft aan de hand van deze checklist:
De bestandsnaam moet eindigen op .xml.
De bestandsnaam van de productgegevensbron die u registreert in uw Google Merchant Center-account moet overeenkomen met de naam die u aan uw bestand toewijst.
Vergeet niet om naamruimtedeclaraties toe te voegen. Deze waarden moeten er precies als volgt uitzien:
- Naamruimte Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - Naamruimte aangepaste kenmerken:
xmlns:[voorvoegsel]="http://base.google.com/cns/1.0", waarbij u [voorvoegsel] vervangt door het voorvoegsel dat u in uw bestand heeft gebruikt.
Controleer of het voorvoegsel in de kenmerktags en de aangepaste kenmerktags van Google Merchant Center overeenkomt met het voorvoegsel in de naamruimtedeclaratie.
Verwijder alle kenmerken die geen waarden bevatten.
Deel 3: Laatste opmerking
We hebben de voorbeeldinvoer in dit document vereenvoudigd om ons vooral te richten op de basis: het samenstellen van een XML-productgegevensbron voor Google Merchant Center. We accepteren ook productgegevensbronnen met niet-standaardelementen van Atom 1.0 of uit uw eigen naamruimte, maar de gegevens in deze elementen worden tijdens de verwerking genegeerd en niet weergegeven in uw advertenties en gratis productvermeldingen. Op dit moment verwerken we alleen gegevens in de standaardelementen voor Atom 1.0 en in kenmerken in de naamruimtes van Google Merchant Center en de aangepaste versie van Google Merchant Center.