O que "publicado" quer dizer na VTEX

O que a publicação leva à VTEX, como ler o selo da loja e o que fazer quando ela trava.

Quem faz
VisualizadorMembroGestorAdministradorProprietário
Onde
Ficha do produto → selo de publicação, ao lado de Enviar para VTEX
Antes de começar
O produto já foi enviado para a VTEX pelo caminho do capítulo 21.

O item chega à VTEX completo e inativo. A ativação cabe à equipe da loja, depois que ela define preço e estoque dentro da VTEX.

Uma loja pode estar configurada como Somente catálogo. Nela, o AdCore Turbo envia a ficha do produto, as especificações, o EAN, a categoria e as fotos liberadas para a loja (capítulo 16), e não pede a ativação do item. A tela de Integrações diz o mesmo, ao lado do selo Somente catálogo:

Nesta loja quem ativa a SKU é o time da loja, dentro da VTEX. O AdCore envia o item completo (ficha, fotos e categoria) e a SKU chega inativa, porque a VTEX não ativa uma SKU sem preço e sem estoque, e os dois são definidos na VTEX. Publicar aqui cadastra o item; não o põe à venda.

Por isso a publicação pode terminar com sucesso e o produto continuar fora da vitrine. O item existe no catálogo da VTEX, com ficha e fotos, e só aparece para o comprador depois que a equipe da loja o ativar.

Passo 1 de 3 · Leia o selo da loja

Na ficha do produto, ao lado do botão Enviar para VTEX, fica um selo por loja. Ele se atualiza sozinho enquanto a publicação avança: primeiro Enfileirado, depois Publicando, e por fim o resultado. A tabela mostra os selos mais comuns:

O selo dizO que significa
Publicadoa publicação terminou sem deixar nada para trás. Numa loja Somente catálogo, o selo vem com a nota "Preço e estoque: definidos na VTEX": preço e estoque ficam com a equipe da loja
Publicado sem preço e sem estoquenuma loja que não é Somente catálogo, o item chegou sem preço e sem estoque
Publicado, sem parte das imagenso item chegou, mas alguma foto não subiu
Publicado sem especificaçõesalguma especificação do cadastro não chegou à loja
Publicado parcialmenteo item chegou, mas algo ficou para trás
Falhoua última tentativa de publicação deu erro
Bloqueado: requer operadoras tentativas automáticas se esgotaram; veja o passo 3
Status parado: verificar de novoa tela parou de acompanhar; clique no selo para consultar outra vez
Status indisponívela tela não conseguiu ler o estado da publicação

Os outros selos nomeiam o que ficou de fora, como preço, estoque, SKUs, EAN, categorias ou a ativação do item, e a explicação ao passar o mouse diz o que fazer.

Passe o mouse sobre o selo para ler a explicação. Numa loja Somente catálogo, ela diz:

SKU criada inativa na VTEX; ativação após preço e estoque na loja. O AdCore não tenta ativar em momento nenhum neste canal: sem preço e sem estoque a VTEX recusa, e os dois são definidos na própria VTEX pela equipe da loja, que ativa o item depois.

Quando o selo nomeia algo que ficou para trás, a explicação inclui:

A publicação chegou à loja, mas deixou algo para trás: uma SKU que a VTEX recusou ou imagens que não subiram. Publicar de novo tenta só o que faltou; o que já está lá não é duplicado.

Passo 2 de 3 · Confira na VTEX e avise a equipe da loja

  1. Confira na VTEX se a ficha e as fotos chegaram.
  2. Avise a equipe da loja que o item está pronto para receber preço, estoque e ativação.
  3. Depois que eles ativarem, o item aparece na loja.

Publicar de novo entre os passos 1 e 3 não adianta: a informação já está lá. Se alguém abrir um chamado dizendo que o item não aparece na loja, o assunto é preço, estoque e ativação, com a equipe da loja.

Se a publicação importa, leia o selo e abra o item na VTEX para ver as fotos. Se algo não estiver lá e o selo não explicar, fale com o suporte e diga a hora exata em que você clicou em Enviar para VTEX. É por ela que se encontra o registro da publicação.

Passo 3 de 3 · Destrave uma publicação bloqueada

Uma publicação que falhou várias vezes seguidas para de tentar sozinha. O selo passa a indicar o bloqueio, com o botão Tentar de novo ao lado.

Passe o mouse sobre o selo antes de clicar:

As tentativas automáticas se esgotaram e a publicação parou. "Tentar de novo" libera o bloqueio e enfileira uma nova publicação; o que já está na loja não é duplicado. Leia o erro da última tentativa antes de repetir.

Corrija a causa primeiro, e só então clique em Tentar de novo. Enquanto reenvia, o botão mostra "Reenviando…".

A tela dizO que fazer
"Outro clique já reviveu esta publicação."alguém já reenviou; acompanhe o selo
"Esta publicação não está mais bloqueada."recarregue a ficha

O que o envio à loja confere, passo a passo, está em O caminho completo, do cadastro à loja.

Publicar só uma parte do produto

Depois que um produto já tem uma publicação completa numa loja, você pode mandar de novo só o que mudou. Com o produto aprovado, abaixo dos botões de publicar aparece Escolher o que publicar. O quadro O que enviar para a loja lista as partes:

  • Produto (nome, descrição, categoria, marca)
  • SKUs (nome, dimensões e vídeos)
  • Especificações
  • Código de barras (EAN)
  • Categorias adicionais
  • Imagens

Marque as partes e clique em Publicar só o marcado. Esse botão aparece só para a loja que já tem uma publicação completa do produto; para as outras, a tela avisa que a primeira publicação leva todas as partes. A tela lembra o efeito:

Só as partes marcadas vão para a loja; o resto fica como está lá. Preço e estoque nunca vão numa publicação parcial.

A primeira publicação numa loja leva sempre todas as partes, e a escolha vale a partir da segunda. Com todas as partes marcadas, o envio é a publicação completa. Numa loja Somente catálogo, o botão se chama Publicar tudo e a tela explica o que essa publicação completa leva:

Com todas as partes marcadas é a publicação completa, mesmo que a loja tenha um padrão de partes. É o «republicar tudo»: vão também as partes que não mudaram desde o último envio aceito pela loja. Nesta loja, preço e estoque são definidos pela equipe da loja na VTEX: só vão se o produto já os tiver no AdCore, e a ativação do item fica com a loja.

Nas outras lojas, o mesmo botão se chama Publicar tudo (com preço e estoque). Se a sua conta tiver ligado o ajuste que pula partes iguais (ele vem desligado), a publicação completa pelo botão simples deixa de reenviar a parte que não mudou desde o último envio aceito pela loja. A tela diz quais partes ficaram de fora e, para quem pode publicar, como mandá-las mesmo assim:

Para mandar mesmo assim, abra «Escolher o que publicar» e publique com todas as partes marcadas.

A publicação com todas as partes marcadas manda sempre tudo, e uma escolha com partes de fora manda as que você marcou. O ajuste não enxerga mudança feita direto na VTEX; é para isso que existe o «republicar tudo».

A parte SKUs também regrava a lista de vídeos do item na loja, e o capítulo 19 explica o que isso apaga.

Canais e feeds

Além da VTEX, o catálogo pode ir para canais de anúncio, como o Google, por meio de feeds. O menu Feeds reúne as duas telas: Feeds Ativos e Canais.

Canais

Um canal é um destino de publicação. A tela Canais mostra todos os destinos que o AdCore Turbo sabe atender, e o contador no topo diz quantos estão ativos neste site, no formato "{ativos} de {total} canais ativos neste site".

Cada cartão diz Ativo ou Inativo, e Configurar abre o detalhe do canal. Num canal inativo, o detalhe oferece Ativar canal a quem tem permissão de publicar. Num canal ativo, o detalhe traz o quadro Publicar, as URLs públicas dos feeds e duas abas: Histórico de Publicação e Pré-visualizar XML.

Na aba Pré-visualizar XML, escolha o feed e clique em Carregar pré-visualização. A tela mostra as primeiras 500 linhas do arquivo que o canal recebe. Um canal que publica por integração direta não tem esse arquivo, e a aba diz "Este adaptador publica via API e não expõe renderizador XML."

Feeds

O feed é a regra que escolhe quais produtos vão a um canal. No detalhe do feed ficam as contagens de ofertas, as regras, a entrega e o histórico de saúde.

Os números do detalhe do feed são os da última avaliação, e a tela avisa:

Sem produtor automático: nada reavalia estes feeds sozinho. Cada número acima é o resultado da última avaliação que alguém disparou.

Se você corrigiu um produto e o feed continua reclamando, clique em Reavaliar e publicar antes de investigar qualquer outra coisa. O botão pede confirmação, porque publica de verdade:

Isto reavalia o feed "{nome do feed}" e, se houver ofertas aprovadas, publica no canal em produção, em nome do cliente.

Quando o feed não publica nada, ele diz por quê, e cada causa tem um dono diferente:

O feed dizDe quem é o problema
"Esta regra não casou com nenhum produto, então não há campo a preencher"da regra do feed
"Todas as {n} ofertas desta regra foram recusadas."do cadastro dos produtos
"{n} ofertas estão prontas, mas a aprovação está retendo todas."de quem aprova os produtos

Uma frase pede que você não mexa no cadastro:

A última avaliação não conseguiu ler a foto de {quantidade} destes produtos: a imagem está na sua biblioteca e é a medição que está velha. Reavalie o feed (ou publique) para refazer a leitura. Não envie a imagem de novo, e não mexa na configuração de mídia.