Atom 0.3-specificatie

Dit document bevat richtlijnen voor het maken van een XML-productdatafeed in de indeling Atom 0.3. 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 standaard voor Atom 0.3 optioneel zijn, zijn ze verplicht voor uw datafeed.

In uw datafeed zijn ook aanvullende elementen nodig, zoals prijs (price) en staat (condition). 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 feed.

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 datafeed</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. Zo kunt u meer beschikbare informatie toevoegen over een product in uw feed.

Deel 2: Belangrijke controles

U doet er goed aan te controleren of uw bestand de juiste indeling heeft voordat u uw feed indient. Let hierbij op het volgende:

1. De bestandsnaam moet eindigen op .xml.
2. De bestandsnaam van de feed die u in uw Google Merchant Center-account registreert, moet overeenkomen met de naam die u toewijst aan uw bestand.
3. Vergeet niet om naamruimtedeclaraties toe te voegen. Deze waarden moeten er precies als volgt uitzien:
   1. Naamruimte Google Merchant Center: xmlns:g="http://base.google.com/ns/1.0".
   2. 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.
4. Controleer of het voorvoegsel in de kenmerktags en de aangepaste kenmerktags van Google Merchant Center overeenkomt met het voorvoegsel in de naamruimtedeclaratie.
5. Verwijder alle kenmerken die geen waarden bevatten.

Deel 3: Laatste opmerking

De voorbeeldinvoer in dit document is vereenvoudigd, zodat de aandacht wordt gevestigd op de basis van het samenstellen van een XML-datafeed voor Google Merchant Center. Hoewel we feeds accepteren met andere elementen die in de standaard Atom 0.3 of in uw eigen naamruimte zijn gedefinieerd, wordt alle informatie in deze elementen genegeerd bij het verwerken. Deze informatie wordt niet weergegeven in uw vermeldingen. Op dit moment verwerken we alleen gegevens in de standaardelementen voor Atom 0.3 en in kenmerken in de naamruimten van Google Merchant Center en de aangepaste versie van Google Merchant Center.