Este guia explica como gerar um arquivo XML contendo todo o catálogo de produtos, essencial para sincronizar seus produtos com plataformas de publicidade e venda como Google Merchant Center, TikTok Shop ou Facebook Catalog.
Como a geração do feed ocorre por meio de um endereço web específico (URL), a configuração é feita adicionando parâmetros ao próprio endereço.
1. Construção da URL Base
Para gerar o feed, você deve acessar uma URL específica do seu site. A URL base depende do formato e da plataforma de destino.
1. Identifique seu domínio (ex.: https://seusite.com).
2. Adicione o caminho do feed /api/plugin/ecommerceFeeds/.
3. Escolha o tipo de feed a ser gerado:
| Plataforma | Tipo de Feed | Exemplo de URL Base |
|---|---|---|
| Google Merchant / Standard | standard.xml | https://seusite.com/api/plugin/ecommerceFeeds/standard.xml |
| TikTok Shop | tiktok.xml | https://seusite.com/api/plugin/ecommerceFeeds/tiktok.xml |
> Nota: Se acessar esta URL sem parâmetros adicionais, será gerado o feed completo com todos os produtos ativos.
2. Configuração Avançada do Feed (Filtros e Variantes)
Você pode personalizar o conteúdo do feed adicionando parâmetros de configuração após um ponto de interrogação (?) na URL base.
2.1. Inclusão das Variantes (Tamanho, Cor, Marca)
Se seus produtos possuem variantes (ex.: tamanhos ou cores), você deve especificar quais atributos devem ser mapeados nos campos padrão do Google/TikTok (color, size, brand).
Você precisa identificar o ID numérico do atributo que representa Tamanho, Cor etc., no seu sistema de gestão de produtos.
| Objetivo | Parâmetro | Exemplo (Se o ID 5 for Cor) |
|---|---|---|
| Cor | v[c]=ID_ATRIBUTO | ?v[c]=5 |
| Tamanho | v[s]=ID_ATRIBUTO | ?v[s]=12 |
| Marca | v[b]=ID_ATRIBUTO | ?v[b]=8 |
Exemplo de URL com Variantes:
Se quiser incluir as variantes Tamanho (ID 12) e Cor (ID 5):
.../tiktok.xml?v[s]=12&v[c]=5
2.2. Filtrar por Categoria
É possível incluir ou excluir produtos com base nas categorias, usando os IDs das categorias.
| Objetivo | Parâmetro | Exemplo |
|---|---|---|
| Incluir Categorias | include_cats=ID1,ID2 | ?include_cats=1,2,5 |
| Excluir Categorias | exclude_cats=ID1,ID2 | ?exclude_cats=10,11 |
2.3. Mapeamento das Labels Personalizadas (Custom Labels)
As labels personalizadas (customlabel0 até customlabel4) são úteis para organizar os produtos em campanhas publicitárias. Você pode mapear essas labels para:
- Categorias: Para inserir a hierarquia das categorias do produto.
- Atributos: Para inserir o valor de um atributo específico (ID numérico).
- Texto Fixo: Para inserir uma string fixa.
| Label | Parâmetro | Valor Exemplo | Descrição |
|---|---|---|---|
customlabel0 | c[0] | categories | Insere o caminho completo das categorias. |
customlabel1 | c[1] | 15 | Insere o valor do Atributo com ID 15. |
customlabel2 | c[2] | Estate2024 | Insere a string fixa "Estate2024". |
3. Geração do Feed Final
Para gerar o feed, cole a URL completa no navegador (ou forneça-a à plataforma de destino).
Exemplo de URL Completa (TikTok Shop):
Gera o feed para TikTok Shop, incluindo as variantes Tamanho (ID 12) e Cor (ID 5), e mapeando customlabel0 para o caminho das categorias:
https://seusite.com/api/plugin/ecommerceFeeds/tiktok.xml?v[s]=12&v[c]=5&c[0]=categories
Uma vez aberta a URL, o sistema processará os dados e retornará diretamente o arquivo XML (ou CSV, se solicitado) que você poderá salvar ou usar para sincronização automática.
> Importante: O processo de geração do feed pode levar vários segundos (até 120 segundos, dependendo do número de produtos) para evitar interrupções.
