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.
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" }
]
}
]
}| Campo | Obrigatório | Tipo | Regra |
|---|---|---|---|
| id | Sim | texto | Identificador único do item dentro do feed (até 100 caracteres). |
| title | Sim | texto | Título exibido no banner (até 80 caracteres). |
| image_url | Sim | URL | Imagem HTTPS em JPG, PNG, WEBP ou GIF, com no mínimo 300px de largura. |
| url | Sim | URL | Página de destino do clique (HTTPS). |
| price | Não | número | Preço. Use ponto como separador decimal: 119900.00 |
| sale_price | Não | número | Preço promocional. O banner mostra o preço original riscado. |
| currency | Não | texto | Código da moeda com 3 letras. Padrão: BRL |
| description | Não | texto | Linha de apoio (até 150 caracteres). |
| badge | Não | texto | Selo curto: “Novo”, “Oferta” (até 20 caracteres). |
| available | Não | booleano | Padrão true. Itens com false não aparecem no banner. |
| priority | Não | inteiro | Maior aparece primeiro e com mais frequência. Padrão 0. |
| attributes | Não | lista | Até 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²" }Authorization: Bearer … ou X-API-Key), configurada na campanha.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