Block preview: janela de pré-visualização do bloco
Block preview é a janela de pré-visualização que mostra em tempo real o resultado do bloco. Ela é a mesma nas telas de configuração dos blocos de recomendação e dos blocos dinâmicos e abre pelo botão "Open in modal".
Para que serve
Ao configurar um bloco (estratégia, filtros, audiência), você quer saber logo quais produtos entram nos resultados com essas configurações. O Block preview permite verificar isso sem publicar o bloco no site e sem sair do painel de administração.
Aba Basic: lista de produtos
A janela tem três abas: Basic | Explanation | Investigate.
A primeira aba, Basic, mostra a tabela de produtos que entram nos resultados do bloco com as configurações atuais:
- Os produtos carregam automaticamente conforme você rola a tabela para baixo.
- A tabela mostra pré-visualizações dos cartões (nome, imagem, marcador, metadados resumidos).
- No bloco Similar products, a pré-visualização é gerada a partir do bloco salvo, e a tela mostra a dica "The preview is generated based on the saved block — form changes will be applied after saving". Para ver o resultado das alterações, salve o bloco primeiro.
Aba Explanation: por que o produto está nos resultados
A segunda aba, Explanation, responde à pergunta "por que este produto entrou no bloco": abaixo de cada cartão de produto aparecem badges com os motivos da seleção, por exemplo "Ordered together", "Matching attributes", "In the same section", "In the popular ranking", "Viewed", "Substituted as popular".
Os badges seguem uma ordem lógica: primeiro a substituição dos resultados (fallback para os populares), depois a seleção (por que o produto está ali), em seguida o ranqueamento (por que ele está nessa posição) e, por fim, o rebaixamento (por exemplo, "Lower — price difference": o produto foi rebaixado por causa da diferença de preço).
Explanation explica os resultados produto a produto: o que funcionou para cada cartão. Investigate mostra o quadro da requisição como um todo: qual regra de audiência foi aplicada, quais avisos o sistema gerou e se o fallback foi ativado. Se não houver motivos de seleção, a aba mostra uma mensagem como "No data for explanation". Isso é normal, por exemplo, em uma pré-visualização vazia.
Aba Investigate: diagnóstico
A terceira aba, Investigate, serve para depuração. Ela mostra o que aconteceu nos bastidores ao gerar os resultados:
| Seção na tela | O que significa |
|---|---|
| Audience rule applied | Qual regra de audiência foi aplicada à requisição atual. Veja Audience Filter (abre em uma nova aba). |
| Warnings | Diagnóstico, por exemplo: "o conjunto de atributos está vazio", "o fallback selecionou produtos fora da categoria escolhida". |
| Fallback used | Indica se o caminho de fallback foi acionado (exibição de reserva de produtos em alta). |
| Request context | Contexto da requisição: o que o sistema recebeu ao gerar a pré-visualização (ID do usuário, carrinho, categorias selecionadas etc.). |
Se não houver dados para uma seção, ela não aparece na aba Investigate. Isso não é um erro.
Simulate user (ID): pré-visualização em nome de um usuário
Na tela de configuração do bloco, a seção Context for preview define o contexto usado para gerar a pré-visualização. O campo depende do tipo de bloco:
| Tipo de bloco | Campo de contexto da pré-visualização |
|---|---|
| Trending, Recently viewed, Personal recommendations, Repeat purchase | Simulate user (ID) |
| Cart complement, Cart similar | Test cart (product IDs) |
| Wishlist similar | Test wishlist (product IDs) |
| Frequently ordered, Similar products (modo automático) | Test product ID |
Nos blocos personalizados, esse campo é Simulate user (ID) (no diagnóstico da aba Investigate, o mesmo valor aparece como simulatedUserId). Insira o ID de qualquer usuário, e a pré-visualização mostra o resultado como se a requisição tivesse vindo dele. Isso é útil para:
- verificar as recomendações personalizadas (Personal recommendations, Repeat purchase) de um cliente específico;
- reproduzir uma reclamação como "no meu bloco aparecem os produtos errados": insira o ID desse cliente e veja o que ele vê.
Sem o Simulate user (ID), a pré-visualização usa o seu próprio contexto de administrador, e nos blocos personalizados os resultados podem ficar vazios ou irrelevantes.
Direito de acesso blocks.preview
O acesso à pré-visualização do bloco é controlado por um direito próprio, blocks.preview, na árvore de direitos (abre em uma nova aba).
Assim, você pode:
- criar um papel que edita blocos sem acesso à pré-visualização (por exemplo, para gerentes de conteúdo que trabalham só com o formulário);
- ocultar de parte dos administradores dados sensíveis que podem aparecer em Investigate (seção Request context).
Conceda blocks.preview a quem configura e verifica os resultados dos blocos. A gerentes de conteúdo, apenas se eles precisarem ver os resultados reais do bloco antes da publicação.