A integração de catálogo via XML permite que a Dito consuma automaticamente os produtos da sua loja para utilizá-los em comunicações personalizadas, como e-mails e notificações. Com isso, garantimos que os consumidores recebam produtos corretos, atualizados e alinhados ao seu comportamento de navegação.

• Nível de Acesso: Administrador, Editor.
  Persona: Analista de TI, Desenvolvedor, Gerente de E-commerce.

Integração: Como compartilhar o catálogo de produtos via XML do Google Merchant

O que é o Google Merchant

O Google Merchant Center é a ferramenta do Google que permite o upload do catálogo de produtos de uma loja para exibição em diferentes canais do Google, como Pesquisa, Maps e YouTube, de forma gratuita.

Padrão de dados utilizado pela Dito

A Dito utiliza o mesmo padrão de informações do Google Merchant. Isso significa que, se sua marca já utiliza o Google Merchant Center, o processo de integração com a Dito será mais simples e rápido.

Dados essenciais do XML

Para que a integração aconteça, é necessário disponibilizar um arquivo XML seguindo o padrão do Google Merchant. Esses dados são utilizados pela Dito para construir visualmente o produto dentro de notificações e e-mails.

Campos essenciais analisados no XML:

• ID
• item_group_id
• title
• description
• image_link
• price
• availability
• link

Relação entre catálogo e eventos trackeados

Utilizamos as propriedades ID e item_group_id para identificar qual produto do catálogo será incluído nas comunicações. Para que o produto correto seja exibido, um ou ambos os IDs precisam estar presentes nos eventos trackeados na Dito, como por exemplo o evento acessou-produto.

Exemplo de evento com ID do produto:

Importante: Os eventos que precisam conter os IDs do catálogo variam conforme as réguas dinâmicas contratadas pela sua marca.

Disponibilização do arquivo XML

Sua marca deverá disponibilizar:

• Um link público ou com acesso liberado para a Dito
• O XML do catálogo de produtos
• A periodicidade de atualização do arquivo

Esse link será utilizado pela nossa aplicação para buscar os dados automaticamente.

Frequência e formato do arquivo

Frequência de atualização

• Recomendado: 1x por dia
• Preferencialmente na madrugada ou início da manhã, evitando campanhas com dados desatualizados

Formatação do arquivo

• Encoding: UTF-8
• Formato: RSS 2.0 (Google Merchant)

Documentação oficial do Google Merchant: https://support.google.com/merchants/answer/160589

Observações importantes sobre os campos

g:price e g:sale_price

• Devem conter apenas valor numérico + moeda
• Exemplo válido:

<g:price>15.00 BRL</g:price>

• Separador de centavos: ponto ou vírgula

g:availability
Valores aceitos:

• in_stock
• in stock
• out of stock

Campos adicionais
É permitido adicionar mais informações, desde que sigam o padrão aceito pelo Google Merchant: https://support.google.com/merchants/answer/7052112?hl=pt-BR

Próximos passos

Após finalizar a criação do XML:

1. Preencha o formulário enviado pela Dito.
2. Informe o seu CS ou time de atendimento.
3. Nossa equipe realizará a validação do arquivo.
4. Com a validação aprovada, seguimos com a integração do catálogo.

FAQ – Perguntas Frequentes

1. Pergunta: Posso usar o mesmo XML do Google Merchant?
Resposta: Sim. A Dito utiliza o mesmo padrão de dados, desde que o arquivo siga as regras exigidas.

2. Pergunta: Qual a frequência mínima de atualização do XML?
Resposta: Recomendamos ao menos 1 atualização diária.

3. Pergunta: O que acontece se o ID do produto não estiver nos eventos?
Resposta: O produto não poderá ser corretamente associado às comunicações enviadas ao consumidor.

4. Pergunta: Posso adicionar campos personalizados no XML?
Resposta: Sim, desde que estejam dentro do padrão aceito pelo Google Merchant.

Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs)