Qual o padrão XML para leitura de catálogo no admin SmartHint?

🔎 Para que nosso sistema de Busca Inteligente e Recomendação entregue a melhor experiência aos seus clientes, é fundamental que as informações dos seus produtos cheguem até nós de forma estruturada e atualizada.

Utilizamos como padrão a Especificação de Dados do Google Merchant Center. Esse formato é o mais difundido no e-commerce global, o que facilita sua exportação independentemente da plataforma que você utiliza.

1. Qual o formato de arquivo aceito?

Aceitamos arquivos no formato XML (RSS 2.0). O arquivo deve ser acessível via URL pública para que nosso sistema possa realizar atualizações automáticas.

2. Quais são os campos obrigatórios?

Para que a busca e recomendação funcionem, os seguintes campos são essenciais:

ID [id]: Identificador exclusivo do produto (SKU).
Título [title]: Nome claro do produto.
Link [link]: URL da página de destino.
Link da Imagem [image_link]: URL da foto principal.
Preço [price]: Valor atual do produto com a moeda (ex: BRL).
Disponibilidade [availability]: Status do estoque (in stock ou out of stock).

3. Quais são os campos essenciais para o catálogo?

Para que o sistema de busca e recomendação opere com alta performance, o XML deve conter atributos que permitam filtrar, ordenar e exibir as melhores condições de compra. Além dos dados básicos de identificação, destacamos dois campos cruciais:

Desconto à vista [g:bankslipprice ou g:bank_slip_price]: Informe o valor referente ao desconto aplicado, para pagamento á vista. Este dado é vital para que nossas vitrines inteligentes identifiquem "Valores para pagamento à vista" e criem gatilhos de urgência para o consumidor.
Parcelamento [installment]: Detalhe o número de parcelas e o valor de cada uma (ex: months: 10 e amount: 50.00 BRL). Exibir o valor da parcela nas recomendações aumenta significativamente a taxa de conversão (CTR).

4. Como devo estruturar as variantes (Cores/Tamanhos)?

Se você vende o mesmo produto em diferentes cores ou tamanhos, utilize o campo ID do grupo de itens [item_group_id]. Todos os itens que forem variações do mesmo modelo devem compartilhar o mesmo ID de grupo, mas possuir IDs individuais únicos.

Estrutura Técnica do XML

Abaixo, apresentamos o modelo simplificado que nosso sistema espera receber. Note o uso do prefixo g: para atributos específicos do Google.

XML

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
<channel>
    <title>Nome da Sua Loja</title>
    <description>Catálogo de produtos para busca e recomendação</description>
    <link>https://www.sualoja.com.br</link>
    
    <item>
        <g:id>SKU_12345</g:id>
        <g:item_group_id>MODELO_BASE_99</g:item_group_id> <g:identifier_exists>no</g:identifier_exists>
        
        <g:title>Nome do Produto - Cor - Tamanho</g:title>
        <g:description>Descrição detalhada do produto sem textos promocionais.</g:description>
        <g:link>https://www.sualoja.com.br/pagina-do-produto</g:link>
        <g:brand>Sua Marca</g:brand>
        <g:condition>new</g:condition>
        
        <g:image_link>https://cdn.sualoja.com.br/foto-principal.jpg</g:image_link>
        <g:additional_image_link>https://cdn.sualoja.com.br/foto-2.jpg</g:additional_image_link>
        
        <g:price>149.90 BRL</g:price>
        <g:sale_price>129.90 BRL</g:sale_price> <g:availability>in stock</g:availability>
        
        <g:color>Preto</g:color>
        <g:size>37</g:size>
        <g:gender>feminino</g:gender>
        <g:age_group>adult</g:age_group>
        <g:product_type>Calçados > Sandálias > Salto Alto</g:product_type>
        
        <g:installment>
            <g:months>3</g:months>
            <g:amount>43.30 BRL</g:amount>
        </g:installment>
    </item>
    </channel>
</rss>

Boas Práticas e Regras Importantes

Qualidade dos Dados:

Imagens: Use URLs de alta qualidade, sem marcas d'água ou textos sobrepostos. Formatos aceitos: JPG, PNG, WebP.
Títulos: Não escreva tudo em MAIÚSCULAS. Evite termos como "Frete Grátis" no título; use o campo próprio para isso.
Categorias: No campo product_type, use o caminho completo (ex: Feminino > Sapatos > Scarpins) para que nossa inteligência de recomendação entenda melhor a hierarquia do seu catálogo.
Preços: Certifique-se de que o preço no XML é exatamente o mesmo exibido no carrinho de compras para evitar divergências.

Pesquisa