O Guia de Medidas oferece ações independentes na página de produto (PDP). A disponibilidade combina provisionamento, configuração persistida e dados do produto.
fashion.size_recommendation, com base no perfil e nas medidas do cliente.fashion.size_guide, com tamanhos e medidas configurados.fashion.size_comparison.Uma conta pode ter até três ações. Cada uma só é exposta quando o produto está provisionado, a ativação está salva e a PDP atende aos dados necessários.
</body>.Tabelas são reutilizáveis. Crie uma tabela com nome único, medidas em centímetros, linhas de tamanho e os valores aplicáveis; depois salve e vincule-a aos produtos.
Edite nome, atributos, medidas, tamanhos e valores na listagem. Duplicar cria uma cópia independente. Ao excluir uma tabela vinculada, confirme a desvinculação dos produtos.
Abra um produto de Moda, escolha a tabela de medidas e marque os tamanhos aplicáveis. Salve o produto para que o runtime receba a grade correta.
Abra o produto e use o cartão Tamanhos e medidas; depois clique em Salvar. Os ajustes complementam a tabela somente na recomendação desse produto: não alteram a tabela compartilhada, a grade exibida nem o Comparador de Tamanhos.
A recomendação exige uma tabela de medidas do corpo ou da peça com dados comparáveis. Em tabelas da peça, o tamanho M (ou o tamanho do meio) é calibrado para um corpo médio e os demais seguem a graduação da tabela; medidas planas contam em dobro no busto, cintura e quadril. O gênero da tabela escolhe esse corpo: feminino usa o corpo feminino médio; masculino, unissex ou sem gênero, o masculino. A base é calculada sobre a tabela inteira, não só sobre os tamanhos vinculados ao produto. Ajustes não habilitam tabelas somente de exibição. Trocar ou remover o vínculo preserva as correções; regiões incompatíveis ficam sem efeito até voltarem a ser usadas. A atribuição em lote não copia nem apaga ajustes individuais.
A seleção é mantida entre páginas. Se os filtros ou os vínculos mudarem, revise novamente antes de confirmar.
No painel, abra Experiência na loja › Medidas e tamanho, ative cada link e ajuste o texto e o ícone. Nada muda na loja até você clicar em Publicar alterações. Não há uma configuração global que substitua as ações individuais: o runtime só habilita uma ação quando o ID provisionado e o link correspondente estão ativos.
fashion.size_recommendation + measurements_try_on_link_enabled.fashion.size_guide + measurements_size_guide_link_enabled.fashion.size_comparison + measurements_size_comparison_enabled.Provisionamento controla quais ações a conta pode usar; os campos acima controlam quais aparecem na loja. Essas decisões são avaliadas por produto e por origem autorizada no servidor.
Em Mais ajustes de estilo, o estilo geral vale para todos os links ativos. Cada link também pode ter um estilo próprio (Estilo só de …), que herda o geral e substitui somente os campos personalizados.
O seletor contém os nove ícones atuais e a opção sem ícone. Os valores técnicos são:
sparkles — Brilhoscamera — Câmeraeye — Olhomagic — Mágicashirt — Roupaarrow-right — Seta para a direitahanger — Cabideruler — Réguatape — Fita métricanull — Nenhum (sem ícone)Os padrões são Cabide para Tamanho Ideal, Régua para Guia de Medidas e Fita métrica para Comparar tamanhos. Eles podem ser alterados sem mudar o provisionamento.
Em Onde aparecem, escolha Junto ao produto (inline na PDP) ou Flutuante no canto. No modo flutuante, escolha o canto em Canto da tela. No modo inline, o painel salva o seletor do elemento junto ao produto e o runtime insere a linha nesse ponto.
measurements_links_custom_css), é escopado à raiz.reverbs-links-row-measurements e aplica-se somente aos links de medidas; não use seletores globais para afetar a loja inteira.Use Experiência na loja › Medidas e tamanho no painel. O tema do Descubra seu tamanho e seu CSS decorativo são próprios; não reutilize CSS de VTO ou dos links da PDP. Guia, comparador e links continuam com seus controles separados.
No preview, selecione um produto Fashion da sua conta para visualizar a imagem, tabela, revisão e tamanhos vinculados reais, ou escolha explicitamente o exemplo sintético. Uma tabela real indisponível não é substituída por tamanhos fictícios. O preview não grava o perfil do shopper, não envia analytics de uso e não adiciona produtos ao carrinho; não declara estoque real sem integração nativa.
O novo fluxo é padrão para lojas já habilitadas e produtos elegíveis, sem reinstalar o snippet. Não habilita ações desligadas pelo lojista. Ao abrir, voltar ao foco e antes de adicionar ao carrinho, o contexto é revalidado; uma tabela alterada exige nova escolha. O perfil fica neste navegador por loja até “Recomeçar perfil”, que não altera o carrinho nem as configurações da loja.
O runtime consulta a elegibilidade por produto em/api/v2/widget-measurements/match. A resposta de capacidade separa cada ação, para que uma PDP possa exibir somente o que está pronto.
GET /api/v2/widget-measurements/match?userId=<UUID>&url=<URL-ENCODED>eligible: false com razão no_comparable_sizes.canVisualizeRecommendedSize indica a condição de um tamanho; canCompareSizesindica a condição para o par. comparisonSizeLabels traz os rótulos disponíveis.canShowSizeGuide e canRecommendSize continuam independentes do comparador. Uma resposta elegível somente para comparação pode ter sizes vazio.O comparador abre em modal (janela central) ou drawer (painel lateral), conforme measurements_size_comparison_display_mode. Os quatro temas disponíveis são:
default — Padrão.light — Claro.dark — Escuro.minimal — Minimalista.A escolha fica em measurements_size_comparison_theme e pode ser feita antes de ativar a ação. O banco só publica o comparador quando measurements_size_comparison_enabled efashion.size_comparison estiverem habilitados.
No fluxo Comparar tamanhos, a seleção da imagem de origem do cliente aceita JPEG/JPG, PNG, WebP, HEIC e HEIF, com limite de 10 MiB por imagem (10 × 1024 × 1024 bytes). Esse é o limite da fonte escolhida pelo cliente; arquivos válidos entre 4 e 10 MiB não são rejeitados por tamanho nessa etapa.
Antes da submissão à API, o navegador converte HEIC e HEIF para JPEG e aplica recorte (crop) e compressão. O payload já processado pode obedecer a um teto de transporte/API de 4 MiB; esse teto não reduz o limite de seleção da fonte original. Se a conversão falhar, tente outra foto.
O limite de 10 MiB é exclusivo da imagem de origem do cliente usada na comparação. Ele não altera os limites da importação de tabelas, descritos em Importar e exportar.
O snippet de medidas é separado dos runtimes de visualização. Copie o código pronto em Instalação no painel, ou substitua SEU_USER_ID pelo UUID da conta, e coloque o código uma vez no rodapé global, imediatamente antes de </body>. O atributocrossorigin="anonymous" permite o contrato CORS do runtime.
<!-- Provei Widget - Guia de Medidas -->
<script
src="https://app.provei.ai/api/v2/snippet-measurements/SEU_USER_ID"
async
crossorigin="anonymous"
></script></body> e salve.</body> e salve.</body>, publique e confirme que ele aparece uma única vez.O servidor pode retornar uma ação indisponível para uma PDP sem tabela, tamanhos aplicáveis ou imagem válida, mesmo que o snippet esteja instalado.
Use POST /api/v2/measurement-tables/importpara criar uma tabela por vez. A rota aceita CSV e arquivos visuais (PDF, JPEG/JPG, PNG e WebP) para extração. CSV usa parsing; arquivos visuais dependem do OCR disponível. Os limites desta seção são da importação de tabelas e não da imagem do cliente do fluxo Comparar tamanhos.
Use POST /api/v2/measurement-tables/import/bulkcom multipart e o campo files. O processamento envia progresso por arquivo e permite sucesso parcial: um arquivo válido pode criar sua tabela mesmo quando outro falha.
Content-Length também é obrigatório, deve ser válido e é verificado antes do multipart. Excesso retorna 413; novas requisições de lote acima do limite da janela podem retornar 429.Na linha da tabela, use Exportar para baixar um CSV com tamanhos, medidas e valores.
match; não use a abertura direta da URL no navegador como teste de elegibilidade.Verifique canVisualizeRecommendedSize,canCompareSizes e comparisonSizeLabels na resposta de match. A razão no_comparable_sizes exige revisar imagem do produto e tamanhos comparáveis; não é um problema do CSS ou do posicionamento.
Confira Content-Length, o limite da modalidade e o tipo do arquivo. Respostas 411/400 indicam cabeçalho ausente ou inválido, 413 indica tamanho excedido e 429 indica limite de frequência. No lote, consulte o resultado individual de cada arquivo.
.reverbs-links-row-measurements.Se a origem, o provisionamento, a configuração e os dados do produto estiverem corretos, envie ao suporte o horário da requisição e o código de resposta.
[email protected]