Como configurar o catálogo de produtos via XML

A importação de um catálogo de produtos via XML permite que você integre informações atualizadas de produtos em campanhas de e-mail e recomendações personalizadas na plataforma DXP. Esse guia descreve o processo de configuração e importação do XML, garantindo que seu catálogo siga o formato adequado e atenda às necessidades de marketing.

1. Requisitos para o arquivo XML

O XML deve seguir o padrão Google Shopping para ser compatível com a plataforma. Abaixo está a estrutura básica e os campos essenciais:

Exemplo de Estrutura XML

Campos Necessários:

• id_produto (id)
• nome_produto (title)
• link_produto (link)
• imagem (image_link)
• marca (brand)
• preço (price)
• parcelamento (intaliment)
• descricao_produto (description)
• ean (gtin)

*Observação: Caso seu XML não contenha algum campo opcional, como g:sale_price, você pode duplicar o campo de g:price.

2. Preparação e disponibilização do XML

• Monte o Arquivo XML: Certifique-se de que todos os campos obrigatórios estão presentes.
• Hospede o XML em uma URL Pública: A URL do arquivo XML deve estar acessível para que a plataforma possa acessar as informações do catálogo.

3. Configuração do XML na Plataforma

Após preparar o XML, siga as etapas abaixo para integrá-lo à plataforma:

1. No menu lateral à esquerda do painel, acesse a opção “Integrações”.

• Selecione a opção Importar Produtos via XML.

2. Em “Cadastrar XML”, preencha os seguintes campos:
   • URL XML: Insira a URL do seu XML no campo indicado.

• Ignorar parâmetros do link: Essa opção é para o caso de links de produtos que possuem as tags do Google Analitcs. O correto é não armazenar os dados com essas tags, e sim o link do produto original.

• A partir do primeiro caracter: Depois que você optou por ignorar os parâmetros do link, escolha qual dos caracteres como “&” e “?”, deseja ignorar. 

Exemplo abaixo:

<link>http://www.linkdeexemplo/Calcados-Femininos/Peep-Toe/12345/?utm_

source=Google_Shopping&utm_medium=Calcados_Google_Shopping&utm_

campaign=Calcados_Femininos&utm_content=Peep_Toe</link>

Nesse link de exemplo podemos observar que após o caracter “?” temos as tags do Google Analitcs (utm_medium, utm_campaign e utm_content). Nesse caso, selecione a opção “?”, após a leitura do xml pela ferramenta o link ficará assim:

http://www.linkdeexemplo/Calcados-Femininos/Peep-Toe/107100/

O mesmo se aplica para o caso do caracter “&”, veja outro exemplo com “&” abaixo:

<link>http://www.linkdeexemplo/Calcados-Femininos/Peep-Toe?id=12345&utm_source=Google_Shopping&utm_medium=Calcados_Google_Shopping&utm_campaign=Calcados_Femininos&utm_content=Peep_Toe</link>

Nesse caso, após o caracter “?” tem um “id” e o seu link precisa desse parâmetro, então selecione a opção “&” e o seu link ficará assim:

http://www.linkdeexemplo/Calcados-Femininos/Peep-Toe?id=12345

• Separador de categoria: Informe qual é o separador das categorias de seu código, escolhendo entre “>” e “|”. 

Exemplo:  

<g:product_type><![CDATA[Calçados > Calçados Femininos]]></g:product_type>

Nesse caso, selecione o “>” e ficará assim: 

Categoria: Calçados 

Sub Categoria: Calçados Femininos

• Nome da Tag Pai: Tag Pai é a tag que inicia e finaliza o arquivo xml.Quando a ferramenta não consegue ler o xml, é necessário que você insira manualmente a Tag pai para que a ferramenta consiga identificar automaticamente todos os outros campos do XML.

3. Agora clique em Cadastrar para salvar o seu XML.

4. Se for necessário, você pode gerenciar ou excluir um XML clicando em “ações desse XML”.

• Excluir XML: Essa ação remove o usuário permanentemente da plataforma.
• Editar XML: Nessa opção você pode editar os campos da integração do XML.

URL XML: Aqui você pode editar a URL do XML.

Ignorar parâmetros do link?: Aqui você pode alterar a configuração de Ignorar parâmetros do link.

Codificação: Escolha entre UTF-8 ou ISO 8859-1, de acordo com a codificação do XML.

Separador de Categoria: Aqui você pode alterar a configuração do separador de categoria.

Formato Preço: Informe o formato dos preços de seus produtos no XML. 

Os formatos disponíveis são: (1999.80), (1,999.80), (1999,80) e (1999.80).

Escolha a opção conforme descrito no seu XML, na tag price:

<g:price>139.90</g:price>

De acordo com o exemplo citado, o correto seria (1999.80).

Remover Cifrão (R$) ?: Neste campo, informe se os preços dos produtos no seu XML contêm o símbolo de cifrão ou não.

IMPORTANTE 💡

Após finalizar o cadastro do XML:

• Verifique a listagem de produtos no painel para confirmar se todos os dados foram importados corretamente.
• Realize testes de campanha para validar que os produtos estão aparecendo conforme esperado.