A planilha das seções de banner

O que esta planilha faz — e o que ela não faz

Nos Banners de Produto, o trabalho em massa não é subir imagem: é dizer onde cada seção vale. A planilha liga, desliga, apaga e — principalmente — troca a condição de várias seções de uma vez. Criar seção nova é no painel ou pela API, porque seção nova precisa de imagem e conteúdo, que não cabem numa célula.

1. Em qualquer seção, no passo "Em quais produtos", clique em "Baixar planilha".
2. Abra no Excel ou no Google Sheets: cada linha é uma seção da loja, com a condição atual já escrita.
3. Edite a coluna condicao — e, se quiser, a ligada e a apagar.
4. Salve como CSV e clique em "Subir planilha". Ou tudo entra, ou nada entra, e cada erro vem com o número da linha.

Quer ver o formato antes de mexer na sua loja? São três seções de uma loja de calçados, uma condição diferente em cada. Baixar a planilha de exemplo

Como escrever a condição

• todos — a loja inteira.
• categoria:123 — os produtos da categoria 123. O número está na Nuvemshop, na página da categoria.
• tag:promo — os produtos com essa tag.
• desconto:30 — desconto de pelo menos 30%.
• dias:30 — cadastrados nos últimos 30 dias.
• estoque:5 — menos de 5 unidades no estoque.
• preco:19,90-49,90 — preço entre os dois. Um lado pode ficar vazio: preco:-49,90 é "até 49,90".
• esgotada — alguma variação esgotada.
• produtos:11 22 33 — os escolhidos a dedo, com os códigos separados por espaço.

!Célula vazia quer dizer "não mexa" — nunca apaga nada. Para apagar uma seção, escreva sim na coluna apagar. E se aparecer "especial" numa condição, é uma combinação criada pela API: deixe como está, que ela se mantém.

O que cada coluna quer dizer

• secao_id: o código da seção. Não mexa — é como sabemos qual é qual.
• modelo e descricao: só para você se achar. O que escrever aqui é ignorado.
• ligada: sim ou não. Vazio deixa como está.
• condicao: em quais produtos a seção aparece. Vazio deixa como está.
• apagar: escreva "sim" para apagar a seção. As imagens dela ficam guardadas por 30 dias, e o espaço volta na hora.

O mesmo, pela API

Tudo que a planilha faz — e mais: criar seção — dá para fazer por programa, com um token da sua loja. As imagens sobem primeiro, a seção referencia os códigos delas, e a cota e os limites valem iguais aos do painel.

As rotas, com exemplo em quatro linguagens, estão na referência. Abrir a referência da API