Il presente documento fornisce le istruzioni per la creazione di un'origine dati di prodotto XML nel formato Atom 0.3. Abbiamo collegato gli attributi standard alle rispettive sezioni nelle specifiche Atom 0.3 ufficiali per aiutarti a trovare ulteriori informazioni sui componenti partendo dai nostri esempi. Anche se sono presenti esempi di file Atom 0.3, abbiamo fornito dettagli minimi sul formato Atom 0.3.
Sezione 1: Atom 0.3
In base alle specifiche Atom 0.3, ci sono quattro elementi predefiniti a livello di voce: title [titolo], link [link], id [id] e modified [modificato]. Sebbene questi elementi siano facoltativi nello standard Atom 0.3, l'origine dati del prodotto li richiede.
L'origine dati del prodotto richiede anche elementi aggiuntivi come prezzo e condizione. Per includere questi elementi e informazioni più dettagliate su un prodotto, abbiamo esteso lo standard Atom 0.3 aggiungendo lo spazio dei nomi di Google Merchant Center. La definizione dello spazio dei nomi di Google Merchant Center ti consente di utilizzare elementi aggiuntivi, denominati "attributi" e aumentare la quantità di informazioni che puoi fornire su ogni prodotto di un'origine dati di prodotto.
Di seguito è riportato un documento Atom 0.3 di esempio contenente un singolo prodotto:
<?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>
Le due principali modifiche in questo esempio sono l'aggiunta della dichiarazione dello spazio dei nomi (nella terza riga) e l'inclusione di tre attributi (link immagine [image_link], prezzo [price] e condizione [condition]).
Dichiarazione dello spazio dei nomi di Google Merchant Center
La seguente dichiarazione dello spazio dei nomi è necessaria al fine di utilizzare attributi definiti solo nello spazio dei nomi di Google Merchant Center.
xmlns:g="http://base.google.com/ns/1.0"
Oltre a dichiarare lo spazio dei nomi di Google Merchant Center, è necessario includere anche un prefisso all'interno del tag di ogni attributo. Aggiungiamo questo prefisso agli attributi per distinguere gli attributi definiti nel nostro spazio dei nomi dagli elementi definiti in Atom 0.3. Il prefisso scelto per questa dichiarazione dello spazio dei nomi è "g":
<g:image_link>http://www.example.com/image1.jpg</g:image_link>Gli attributi nello spazio dei nomi di Google Merchant Center devono includere questo prefisso altrimenti gli attributi stessi, e qualsiasi valore contengano, saranno ignorati.
Attributi
Puoi utilizzare tutti gli attributi pertinenti che risultino appropriati per i tuoi prodotti. L'aggiunta di informazioni supplementari sui tuoi prodotti tramite questi attributi aumenterà notevolmente le probabilità che i tuoi prodotti vengano visualizzati nei risultati. Inoltre, molti attributi definiti nello spazio dei nomi di Google Merchant Center possono essere utilizzati più di una volta in un singolo prodotto. Ciò ti permette di aggiungere nella tua origine dati di prodotto ulteriori informazioni disponibili su un prodotto.
Sezione 2: elenco di controllo importante
Prima di inviare l'origine dati del prodotto, ti consigliamo vivamente di consultare il seguente elenco per assicurarti che il file sia formattato correttamente:
Il nome file deve terminare con l'estensione .xml.
Il nome file dell'origine dati di prodotto che registri nel tuo account Google Merchant Center deve corrispondere al nome che assegni al file.
Ricordati di includere le dichiarazioni dello spazio dei nomi. Questi valori devono corrispondere esattamente come indicato.
- Spazio dei nomi di Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0". - Spazio dei nomi degli attributi personalizzati:
xmlns:[prefix]="http://base.google.com/cns/1.0", dove [prefix] è sostituito dal prefisso che hai incluso nel tuo file.
Verifica che il prefisso incluso nei tag degli attributi di Google Merchant Center e Google Merchant Center personalizzato corrisponda al prefisso definito nella dichiarazione dello spazio dei nomi.
Rimuovi gli attributi che non contengono valori.
Sezione 3: nota finale
La voce di esempio inclusa in questo documento è stata semplificata per consentire una maggiore attenzione alle nozioni di base della creazione di un'origine dati di prodotto XML di Google Merchant Center. Sebbene accettiamo origini dati di prodotto contenenti altri elementi definiti nello standard Atom 0.3 o nel tuo spazio dei nomi, qualsiasi informazione contenuta in questi elementi verrà ignorata durante l'elaborazione e non verrà visualizzata nelle schede. Al momento elaboriamo solo i dati contenuti negli elementi Atom 0.3 predefiniti e negli attributi all'interno dello spazio dei nomi di Google Merchant Center e Google Merchant Center personalizzato.