Uma imagem, uma versão por canal

Quem faz

VisualizadorMembroGestorAdministradorProprietário

Onde

Ativos → Ver → Versões por canal

Antes de começar

A imagem precisa ter sido enviada (capítulo 11). As versões por canal nascem sozinhas a partir do arquivo original.

Você envia a imagem uma vez. A ferramenta guarda o arquivo original e gera, a partir dele, uma versão no tamanho de cada canal. A tela chama essas versões de Versões por canal, o nome da seção no detalhe do ativo e da coluna na tabela de Ativos.

O cartão de cada versão mostra o tamanho com que ela foi gravada. Uma versão do Google Shopping gerada antes da troca para 1500 × 1500, em outubro de 2026, continua em 800 × 800 até que as versões do ativo sejam regeneradas.

A VTEX fica fora dessa lista. A loja recebe a imagem quando o produto é publicado (capítulo 21), e o detalhe do ativo mostra se a loja está com a versão mais recente.

Quem tem papel de Visualizador lê tudo o que este capítulo descreve. Regenerar as versões é do Membro para cima.

Passo 1 de 3 · Confira a contagem

No detalhe do ativo, a seção Versões por canal abre com a contagem "{geradas}/{total} geradas". Se algum canal falhou, aparece ao lado a marca "{n} com falha", em vermelho. Abaixo, cada canal tem o seu cartão, com a imagem, as dimensões e o botão Copiar URL.

Passo 2 de 3 · Leia o cartão do canal que não saiu

Um cartão sem imagem está em um de três estados. Pendente quer dizer que a versão está sendo gerada agora; esse Pendente é diferente do selo de aprovação da imagem, que também pode dizer Pendente (capítulo 16). Não gerada quer dizer que nenhuma geração está em andamento para aquele canal: use Regenerar versões por canal. Falhou vem com o título "A versão para este canal falhou" e o motivo, como um endereço que não entrega a imagem ou um arquivo acima de 25 MB. A falha de um canal não derruba os outros.

Nesses casos, o botão Copiar URL fica bloqueado, e a tela diz por quê. São três motivos:

Não há endereço para copiar: a versão deste canal falhou.

O endereço fica disponível quando a versão deste canal terminar de ser gerada.

Este ativo não tem endereço público estável, e a prévia acima é uma URL assinada que expira em uma hora. Copiar esse endereço entregaria ao canal um link que morre. Peça a um administrador para gerar o endereço público deste site.

Passo 3 de 3 · Regenere as versões

Quando uma versão falhou por um problema que já foi resolvido, clique em Regenerar versões por canal, no alto da seção. A confirmação explica o que acontece:

Todas as versões por canal são reconstruídas a partir do arquivo original e substituem as atuais. O arquivo original não é alterado. Se a origem não puder ser lida, as versões atuais são mantidas e o motivo aparece aqui.

Confirme em Regenerar. O quadro Última regeneração passa a mostrar o andamento, e a tela se atualiza sozinha até a execução terminar. Enquanto corre, o estado é Na fila ou Em andamento; ao terminar, o quadro mostra o resultado: Concluída sem erro, Concluída com erro ou Falhou. Enquanto a execução corre, os cartões ainda mostram as versões anteriores.

Se já houver uma regeneração em andamento para o mesmo ativo, a tela recusa a segunda e aponta o andamento da primeira. Se a execução parar de avançar por 5 minutos, a tela para de se atualizar e pede que você recarregue a página.

Quando não há versão nenhuma

Com todos os canais vazios, a seção mostra uma de quatro frases. Cada uma pede uma atitude diferente.

A última vem com esta explicação:

As versões por canal não estão sendo geradas agora neste ambiente, e esperar não resolve. Fale com o suporte.

A mesma foto na loja VTEX

Quando o ativo está vinculado a um produto, o cartão Substituir arquivo traz a parte Na loja. Ela compara a versão do arquivo no AdCore com a que a loja recebeu na última publicação concluída, uma linha por loja:

AdCore tem v{atual}, loja tem v{na loja}, publicada em {data}

Se as duas versões forem iguais, a linha diz que AdCore e loja têm a mesma versão. Se o produto nunca teve publicação concluída, a linha diz isso.

A versão sobe quando alguém substitui o arquivo do ativo, e a troca não chega sozinha à loja. Para levar a versão nova, publique o produto de novo; o botão de envio fica logo abaixo, nesse mesmo cartão. A leitura tem um limite, que a própria tela declara:

Lido da última publicação concluída do produto. Se aquela publicação deixou esta foto de fora, a loja não tem foto nenhuma dela.