Pré-visualização do bloco — janela de pré-visualização do bloco
Pré-visualização do bloco — janela de pré-visualização que mostra o resultado do bloco em tempo real. Ela é a mesma nas telas de configurações de blocos recomendativos e dinâmicos e é aberta pelo botão «Abrir em modal».
Por que isso é necessário
Quando você configura um bloco (estratégia, filtros, audiência) — é importante entender imediatamente quais produtos aparecerão nos resultados com essas configurações. A pré-visualização do bloco permite verificar isso sem publicar o bloco no site, sem sair do painel de administração.
Aba Básica — lista de produtos
A janela consiste em três abas: Básica | Explicação | Investigar.
A primeira aba — Básica. Mostra uma tabela de produtos que aparecerão nos resultados do bloco com as configurações atuais:
- Os produtos são carregados automaticamente ao rolar a tabela para baixo.
- Na tabela — pré-visualizações dos cartões (nome, imagem, marcador, metadados resumidos).
- No bloco Produtos similares, a pré-visualização é construída com base no bloco salvo — na tela há uma dica "A pré-visualização é gerada com base no bloco salvo — as alterações no formulário serão aplicadas após a salvamento". Para ver o resultado das edições, salve o bloco primeiro.
Aba Explicação — por que o produto está nos resultados
A segunda aba — Explicação. Ela responde à pergunta "por que este produto específico foi incluído no bloco": sob cada cartão de produto, são exibidos badges com as razões da seleção — por exemplo, "Comprados juntos", "Atributos correspondentes", "Mesma categoria", "Em ranking de tendências", "Visualizados", "Substituídos como populares".
Os badges são organizados por sentido: primeiro a substituição dos resultados (fallback para populares), depois a seleção (por que o produto está aqui), em seguida a classificação (por que ele está nesta posição) e, por último, a diminuição (por exemplo, "Menor — diferença de preço" — o produto foi rebaixado devido à diferença de preço).
Explicação detalha os resultados para cada produto — o que funcionou para um cartão específico. Investigação mostra a visão do pedido como um todo — qual regra de audiência foi aplicada, quais avisos o sistema emitiu, se o fallback foi ativado. Se não houver razões de seleção, a aba mostrará uma mensagem do tipo "Sem dados para explicação" — isso é normal, por exemplo, para uma pré-visualização vazia.
Aba Investigação — diagnóstico
A terceira aba — Investigação — é necessária para depuração. Aqui você pode ver o que aconteceu "por trás das cenas" ao gerar os resultados:
| Seção na tela | O que significa |
|---|---|
| Regra de audiência aplicada | Qual regra de audiência foi acionada para o pedido atual. Veja Filtro de Audiência. |
| Avisos | Diagnóstico — por exemplo, "conjunto de atributos vazio", "fallback selecionou produtos que não estão na categoria escolhida". |
| Fallback utilizado | Flag: o caminho de fallback foi ativado (exibição de produtos em tendência). |
| Contexto do pedido | Contexto do pedido — o que o sistema recebeu ao construir a pré-visualização (ID do usuário, carrinho, categorias selecionadas, etc.). |
Se não houver dados para alguma seção, essa seção na aba Investigação não será exibida — isso não é um erro.
Simular usuário (ID) — pré-visualização "em nome" do usuário
Na tela de configurações do bloco, na seção Contexto para pré-visualização, é definido o contexto para o qual a pré-visualização é construída. O campo depende do tipo de bloco:
| Tipo de bloco | Campo de contexto da pré-visualização |
|---|---|
| Tendências, Recentemente visualizados, Recomendações pessoais, Recompra | Simular usuário (ID) |
| Complemento de carrinho, Similar ao carrinho | Testar carrinho (IDs dos produtos) |
| Similar à lista de desejos | Testar lista de desejos (IDs dos produtos) |
| Frequentemente pedidos, Produtos similares (modo automático) | Testar ID do produto |
Para blocos personalizados, este campo é Simular usuário (ID) (no diagnóstico da aba Investigação, esse mesmo valor é mencionado como simulatedUserId). Insira o ID de qualquer usuário — a pré-visualização construirá o resultado como se o pedido tivesse vindo dele. É útil para:
- Verificar recomendações pessoais (Recomendações pessoais, Recompra) para um cliente específico;
- Reproduzir uma reclamação do tipo "não tenho os produtos certos no bloco" — insira o ID dele e veja o que ele verá.
Sem especificar Simular usuário (ID), a pré-visualização usará seu próprio contexto de administrador, e para blocos personalizados, os resultados podem ser vazios ou irrelevantes.
Direito de acesso blocks.preview
O acesso à pré-visualização do bloco é controlado por um direito separado blocks.preview em árvore de direitos.
Isso permite:
- Dar um papel que edita blocos, sem acesso à pré-visualização (por exemplo, para gerentes de conteúdo "somente-formulário").
- Ocultar de alguns administradores dados sensíveis que podem ser revelados através da Investigação (seção Contexto do pedido).
Dê blocks.preview àqueles que configuram e verificam os resultados dos blocos. Para gerentes de conteúdo — apenas se eles precisarem ver os resultados reais do bloco antes da publicação.