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.

Para quem é este artigo?

• Nível de Acesso: Administrador, Editor

Nesse artigo você vai encontrar:

O que é o Google Merchant

Plataforma do Google que permite cadastrar e gerenciar catálogos de produtos para exibição em anúncios e outros serviços do Google.

Padrão de dados utilizado pela Dito

Estrutura de dados adotada pela Dito para garantir compatibilidade, padronização e correta interpretação das informações do catálogo.

Dados essenciais do XML

Conjunto mínimo de campos obrigatórios para que os produtos sejam processados e utilizados corretamente pela plataforma.

Relação entre catálogo e eventos trackeados

Como os dados do catálogo se conectam aos eventos de navegação e compra para enriquecer análises e ativações.

Disponibilização do arquivo XML

Forma e local onde o arquivo XML deve ser hospedado para que possa ser acessado e consumido pela Dito.

Frequência e formato do arquivo

Orientações sobre a periodicidade de atualização e o padrão esperado do arquivo XML.

Próximos passos

Etapas seguintes para concluir a integração e validar o funcionamento do catálogo.

FAQ – Perguntas Frequentes sobre Integração de Catálogo via XML

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

Exemplo de estrutura do XML

Também compartilhamos via e-mail um arquivo example_xml, contendo produtos de exemplo com a formatação correta.

Abaixo, um exemplo de produto presente no XML.

Os campos devem seguir exatamente a nomenclatura e regras do Google Merchant.

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

Neste artigo, você aprendeu como estruturar e disponibilizar corretamente um XML de catálogo de produtos seguindo o padrão do Google Merchant para integração com a Dito. Com essa configuração, sua marca poderá enviar comunicações mais relevantes, personalizadas e automatizadas para seus consumidores.

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) 

Gostou, mas acha que algo pode melhorar?

Sua opinião é muito importante para nós! Se você tem alguma sugestão ou sentiu falta de algo neste módulo, queremos ouvir você.

Compartilhe suas ideias diretamente com nosso time de Produto através do link abaixo.

➡️ Acesse aqui o Portal de Ideias

FAQ – Perguntas Frequentes sobre Integração de Catálogo via XML

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

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

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

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