Voltar

Padrão de feed

v1.0

Banners dinâmicos (carrossel, grade ou destaque) são montados a partir dos seus produtos. Para funcionar com qualquer nicho, todo anunciante disponibiliza os dados neste formato único.

1. Formato JSON

Disponibilize uma URL que responda com o JSON abaixo. A plataforma lê essa URL periodicamente (a cada 15 minutos, configurável) e guarda os itens em cache. Se a sua API ficar fora do ar, o banner continua funcionando com a última versão válida.

{
  "version": "1.0",
  "items": [
    {
      "id": "CAR-1029",
      "title": "Toyota Corolla XEi 2.0",
      "image_url": "https://loja.com/fotos/corolla.jpg",
      "url": "https://loja.com/carros/corolla-1029",
      "price": 119900.00,
      "sale_price": 114900.00,
      "currency": "BRL",
      "description": "Único dono, revisado",
      "badge": "Oferta",
      "available": true,
      "priority": 10,
      "attributes": [
        { "label": "Ano", "value": "2022" },
        { "label": "Km", "value": "35.000" },
        { "label": "Câmbio", "value": "Automático" }
      ]
    }
  ]
}

2. Campos

CampoObrigatórioTipoRegra
idSimtextoIdentificador único do item dentro do feed (até 100 caracteres).
titleSimtextoTítulo exibido no banner (até 80 caracteres).
image_urlSimURLImagem HTTPS em JPG, PNG, WEBP ou GIF, com no mínimo 300px de largura.
urlSimURLPágina de destino do clique (HTTPS).
priceNãonúmeroPreço. Use ponto como separador decimal: 119900.00
sale_priceNãonúmeroPreço promocional. O banner mostra o preço original riscado.
currencyNãotextoCódigo da moeda com 3 letras. Padrão: BRL
descriptionNãotextoLinha de apoio (até 150 caracteres).
badgeNãotextoSelo curto: “Novo”, “Oferta” (até 20 caracteres).
availableNãobooleanoPadrão true. Itens com false não aparecem no banner.
priorityNãointeiroMaior aparece primeiro e com mais frequência. Padrão 0.
attributesNãolistaAté 4 pares { label, value }. É aqui que entra o que é específico do seu nicho.

Exemplo de atributos de um imóvel, no mesmo padrão:

{ "label": "Quartos", "value": "3" },
{ "label": "Área", "value": "92 m²" }

3. Regras gerais

4. Sem API? Use CSV ou cadastro manual

Mesmas colunas do JSON. Os atributos viram attr1_label, attr1_value … até attr4_value. Separador vírgula ou ponto e vírgula.

id,title,image_url,url,price,sale_price,currency,description,badge,available,priority,attr1_label,attr1_value,attr2_label,attr2_value
CAR-1029,"Toyota Corolla XEi 2.0",https://loja.com/fotos/corolla.jpg,https://loja.com/carros/corolla-1029,119900,114900,BRL,"Único dono",Oferta,true,10,Ano,2022,Km,35.000

5. Validação