Este documento apresenta diretrizes para a criação de um feed de dados do produto XML no formato RSS 2.0. Relacionamos os atributos padrão a suas respectivas seções na especificação RSS 2.0 oficial para ajudá-lo a encontrar informações adicionais sobre os componentes de nossos exemplos. Embora forneçamos exemplos de arquivos RSS 2.0, damos poucos detalhes sobre o RSS 2.0 em si. Se você quiser saber mais sobre esse padrão, consulte esta especificação.
Seção 1: RSS 2.0
Com base na especificação RSS 2.0, há três elementos predefinidos em cada item: título, link e descrição. Embora esses elementos sejam opcionais na norma RSS 2.0, são necessários em feeds de dados do produto.
Os feeds de dados do produto também exigem mais elementos como preço, código e estado. Para incluir esses elementos e informações mais detalhadas de um item, expandimos o RSS 2.0, adicionando o namespace de feed do Google Merchant Center. Ao definir o namespace do Google Merchant Center, você pode usar outros elementos conhecidos como "atributos", além de aumentar a quantidade de informações fornecidas para cada item do feed.
Confira abaixo um exemplo de documento padrão RSS 2.0 com apenas um item: As duas principais adições nesse exemplo são a declaração de namespace (xmlns:g="http://base.google.com/ns/1.0"
) e a inclusão de quatro atributos (link da imagem [image_link]
, preço [price]
, estado [condition]
e código [id]
).
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0">
<canal>
<title>Exemplo: Google Store</title>
<link>https://store.google.com</link>
<description>Este é um exemplo de um documento padrão RSS 2.0 com apenas um item</description>
<item>
</item><g:id>TV_123456</g:id>
<g:title>Google Chromecast com Google TV</g:title>
<g:description>Você assiste o que mais gosta com o Chromecast com Google TV em até 4K HDR</g:description>
<g:link>https://store.google.com/product/chromecast_google_tv</g:link> <g:image_link>https://images.example.com/TV_123456.png</g:image_link> <g:condition>novo</g:condition>
<g:availability>in_stock</g:availability>
<g:price>49,99 USD</g:price>
<g:shipping><g:country>EUA</g:country>
<g:service>Padrão</g:service>
<g:price>7,99 USD</g:price></g:shipping>
<g:gtin>123456789123</g:gtin>
<g:brand>Google</g:brand>
</channel>
</rss>
Faça o download do arquivo de exemplo para ter uma visão geral mais detalhada de um feed de dados do produto XML no RSS 2.0.
Faça o download do exemplo de RSS 2.0 (link em inglês)
Declaração de namespace do Google Merchant Center
A declaração de namespace a seguir é obrigatória para o uso dos atributos definidos somente no namespace do Google Merchant Center.
xmlns:g="http://base.google.com/ns/1.0"
Além de declarar o namespace do Google Merchant Center, inclua também um prefixo em cada tag de atributo. Adicionamos esse prefixo para diferenciar os atributos no nosso namespace dos elementos definidos no RSS 2.0. O prefixo escolhido para essa declaração de namespace é "g":
<g:image_link>
http://www.google.com/images/google_sm.gif</g:image_link>
Os atributos do namespace do Google Merchant Center precisam incluir o prefixo ou os atributos, e todos os valores contidos neles vão ser ignorados.
Atributos
Você pode usar todos os atributos relevantes que forem específicos aos seus produtos. Fornecer mais informações sobre os itens usando esses atributos aumenta drasticamente as chances do produto aparecer nos anúncios do Shopping e nas listagens gratuitas quando um cliente fizer uma pesquisa no Google. Além disso, muitos atributos definidos no namespace do Google Merchant Center podem ser usados mais de uma vez no mesmo produto. Isso permite que você adicione mais informações disponíveis sobre um produto no seu feed.
Seção 2: lista de verificação importante
Antes de enviar seu feed, recomendamos conferir os itens da seguinte lista para garantir a formatação correta do seu arquivo:
- O nome do arquivo deve terminar com a extensão .xml.
- O nome de arquivo do feed que você registrar em sua conta do Google Merchant Center deve corresponder ao nome que você der ao arquivo.
- Lembre-se de incluir as declarações de namespace. Esses valores precisam corresponder exatamente aos demonstrados.
- Namespace do Google Merchant Center:
xmlns:g="http://base.google.com/ns/1.0"
. - Namespace de atributos personalizados:
xmlns:[prefix]="http://base.google.com/cns/1.0"
, em que[prefix]
é substituído pelo prefixo que você incluiu no arquivo.
- Namespace do Google Merchant Center:
- Verifique se o prefixo incluído nas tags de atributo do Google Merchant Center e do Custom Google Merchant Center correspondem ao prefixo definido na declaração de namespace.
- Remova os atributos que não contiverem nenhum valor.
Seção 3: observação final
A entrada de exemplo incluída neste documento foi simplificada para esclarecer os fundamentos da criação de um arquivo de dados do produto XML. Embora aceitemos que os feeds contenham outros elementos definidos no RSS 2.0 padrão ou no seu próprio namespace, todas as informações que esses elementos tiverem vão ser ignoradas no processamento e não aparecerão nos anúncios ou nas listas. No momento, só processamos os dados contidos nos elementos padrão do RSS 1.0 e nos atributos dos namespaces do Google Merchant Center, inclusive os personalizados.