Dit document bevat richtlijnen voor het maken van een XML-productdatafeed in de Atom 0.3-indeling. We hebben standaardkenmerken gekoppeld aan hun respectieve beschrijvingen in de officiële specificatie van Atom 0.3. Zo kunt u aanvullende informatie zoeken over de componenten in onze voorbeelden. Hoewel we wel voorbeelden bieden van Atom 0.3-bestanden, geven we een minimum aan informatie over Atom 0.3 zelf.
Deel 1: Atom 0.3
Volgens de Atom 0.3-specificatie zijn er vier vooraf gedefinieerde elementen op het invoerniveau: titel (title), link (link), ID (id) en aangepast (modified). Hoewel deze elementen in de Atom 0.3-standaard optioneel zijn, zijn ze verplicht voor productgegevensbronnen.
In uw datafeed zijn ook aanvullende elementen nodig, zoals prijs en staat. Om gedetailleerdere productinformatie op te kunnen nemen, hebben we Atom 0.3 uitgebreid met de naamruimte voor 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 0.3 met één product:
<?xml version="1.0"?>
<feed version="0.3" xmlns="http://purl.org/atom/ns#"
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" /> <modified>2005-10-11T18:30:02Z</modified> <author> <name>Google</name> </author> <id>tag:google.com,2005-10-15:/support/products</id> <entry> <title>Rode wollen trui</title> <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> <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>nieuw</g:condition> </entry> </feed>
De 2 belangrijkste toevoegingen in dit voorbeeld zijn de naamruimtedeclaratie (in de 3e regel) 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 Google Merchant Center, moet u ook bij elke kenmerktag een voorvoegsel opnemen. Dit voorvoegsel voegen we aan kenmerken toe om kenmerken in onze naamruimte te onderscheiden van elementen die zijn gedefinieerd in Atom 0.3. Het voorvoegsel dat voor deze naamruimtedeclaratie is geselecteerd, is 'g':
<g:image_link>http://www.example.com/image1.jpg</g:image_link>Kenmerken in de naamruimte van 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 behulp van 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 3.0 of elementen uit uw eigen naamruimte, maar gegevens in deze elementen worden tijdens de verwerking genegeerd en niet weergegeven in uw productvermeldingen. Op dit moment verwerken we alleen gegevens in de standaardelementen van Atom 0.3 en in kenmerken in de naamruimten van Google Merchant Center en de aangepaste versie van Google Merchant Center.