AI Size & Fit Advisor: guia completo

AI Size & Fit Advisor recomenda o tamanho certo a partir da altura e do peso do cliente, ou das medidas tiradas com fita métrica. Este guia cobre a instalação, a configuração, as tabelas de tamanhos, o percurso do cliente, o acompanhamento das devoluções e a camada de IA opcional. Documenta a versão 1.2.0.

Instalação e atualização

1. Descarregue o arquivo do módulo a partir da sua conta DataFirefly.
2. Back office do PrestaShop, Módulos, Carregar um módulo: envie o ZIP.
3. O módulo cria as suas tabelas, regista os hooks e acrescenta o separador Catálogo > Tabelas de tamanhos.
4. Limpe a cache em Parâmetros avançados > Desempenho.

Para atualizar a partir da 1.0, instale o novo arquivo por cima do anterior. Os scripts de atualização criam as novas tabelas, migram a associação de cada tabela de tamanhos existente e registam os novos hooks.

Configuração

Abra Módulos > AI Size & Fit Advisor > Configurar. A página mostra o painel de desempenho e dois blocos de definições.

Painel de desempenho

Resume os últimos 30 dias: recomendações e clientes, encomendas após uma recomendação, parte das encomendas no tamanho recomendado, taxa de devolução no tamanho recomendado e noutro tamanho, parte das recomendações feitas só com altura e peso, parte das respostas da IA e produtos mais aconselhados.

Assistente de tamanhos

• Hook de apresentação: displayProductActions (junto ao botão de adicionar ao carrinho), displayProductAdditionalInfo, ou o hook personalizado displayDfSizeFit, que coloca onde quiser no template do produto com {hook h='displayDfSizeFit' product=$product}.
• Texto do botão: um por idioma. Deixe vazio para usar «Encontrar o meu tamanho».
• Estilo do botão: contornado, preenchido ou ligação de texto. Cor de destaque: usada no botão, no tamanho recomendado e nas opções ativas.
• Unidade das suas tabelas de tamanhos: centímetros ou polegadas. O cliente pode alternar entre cm/kg e in/lb no assistente.
• Perguntar o ajuste preferido: acrescenta a escolha justo, clássico ou largo.
• Memorizar o perfil do cliente: preenche o assistente e mostra «O seu tamanho: M» na página do produto nas visitas seguintes. Guardado no navegador e, com sessão iniciada, na conta do cliente.
• Mostrar o separador da tabela de tamanhos e Botão para selecionar o tamanho recomendado.
• Guardar recomendações (estatísticas): necessário para o painel de desempenho e o acompanhamento das devoluções.

Camada de IA

• Ativar a camada de IA: desativada, não é feita nenhuma chamada externa.
• Fornecedor de IA: Mistral, OpenAI ou Anthropic. Modelo: por exemplo mistral-small-latest, gpt-4o-mini ou claude-haiku-4-5.
• Chave API: campo oculto, guardada no servidor. Deixe vazio para manter a chave guardada.
• Chamadas de IA por visitante por hora: acima deste limite responde apenas o motor determinístico. 0 elimina o limite.
• Guardar e testar a ligação: verifica a chave e o modelo e mostra o erro do fornecedor, se existir.

Criar uma tabela de tamanhos

Abra Catálogo > Tabelas de tamanhos > Adicionar.

Começar a partir de um modelo

Seis modelos preenchem a grelha e o género: roupa de senhora (busto, cintura, anca), tops de homem (peito, cintura), calças de ganga de homem (cintura), calçado EU (comprimento do pé), criança por altura, chapéus (perímetro da cabeça). Ajuste depois os valores à sua marca. Se a loja trabalhar em polegadas, os modelos são convertidos.

Aplica-se a

• Todos os produtos: tabela predefinida.
• Categorias: assinale uma ou várias categorias na árvore.
• Marcas: selecione uma ou várias marcas.
• Produtos: pesquise produtos por nome, referência ou ID.

Quando várias tabelas correspondem a um produto, o módulo escolhe por esta ordem: a tabela do produto, a da sua marca, a da sua categoria (primeiro a predefinida, depois a mais profunda) e, por fim, a tabela «Todos os produtos».

Género e corte do modelo

• Senhora ou Homem: o módulo estima as medidas para esse tipo de corpo.
• Todos ou Unissexo: o cliente escolhe «Senhora» ou «Homem» no assistente.
• Criança: sem estimativa por constituição. Use uma coluna de altura ou peso.

O corte do modelo indica se o artigo tem tamanho normal, veste pequeno ou veste grande. O motor desloca então a recomendação em cerca de 3,5% e o cliente lê «Este modelo veste pequeno: o conselho tem isso em conta».

A grelha

• Acrescente uma coluna por medida: peito, busto, cintura, anca, largura de ombros, comprimento da manga, entrepernas, pescoço, coxa, comprimento do pé, perímetro da cabeça, altura ou peso.
• Acrescente uma linha por tamanho (S, M, L, 38, 40…) e introduza um intervalo mínimo / máximo em cada célula.
• Introduza medidas do corpo, não da peça.

Testar a tabela

Por baixo da grelha, o bloco Testar esta tabela executa o motor real sobre a grelha em edição, mesmo antes de guardar. Indique género, altura e peso: obtém o tamanho recomendado, o índice de correspondência, o tamanho vizinho e as medidas estimadas (marcadas com um asterisco).

Na lista de tabelas, a ação Duplicar cria uma cópia desativada com as mesmas associações, para derivar uma tabela por marca ou por corte.

O percurso do cliente

Na página do produto, o botão «Encontrar o meu tamanho» abre uma janela com dois separadores, «O meu tamanho» e «Tabela de tamanhos». No telemóvel abre como painel a partir da parte inferior do ecrã.

Altura e peso

Percurso predefinido. O cliente indica a altura, o peso, a constituição (magra, média ou robusta) e, se a tabela for unissexo, se compra para senhora ou homem. Não é precisa fita métrica.

As minhas medidas

O cliente introduz as medidas tiradas com fita métrica. Uma silhueta destaca a medida em curso e mostra a instrução correspondente. A altura e o peso continuam opcionais: completam as medidas deixadas em branco.

O resultado

O cliente vê o tamanho recomendado, o índice de correspondência, o tamanho vizinho a considerar, uma explicação e o detalhe por medida (bom ajuste, justo ou largo, com a indicação «estimada» quando o valor vem da altura e do peso). O botão «Escolher o tamanho M» seleciona a combinação correspondente na página do produto. O separador «Tabela de tamanhos» mostra a grelha, com o tamanho recomendado destacado, na unidade escolhida pelo cliente.

Perfil memorizado

Nas visitas seguintes, o botão da página do produto mostra logo «O seu tamanho: M». A ligação «Esquecer as minhas medidas» apaga o perfil do navegador e da conta do cliente.

Como o tamanho é calculado

1. Estimativa: sem medidas tiradas com fita, os perímetros (busto, peito, cintura, anca, pescoço, coxa) são estimados com uma regressão sobre o índice de massa corporal por género, ajustada pela constituição, e os comprimentos são proporcionais à altura.
2. Correspondência: cada tamanho recebe uma nota segundo a distância das medidas ao centro de cada intervalo, com uma penalização fora do intervalo. O ajuste preferido e o corte do modelo deslocam as medidas antes da comparação.
3. Índice de correspondência: calculado medida a medida e reduzido quando há valores estimados.
4. Tamanho vizinho: o tamanho imediatamente acima ou abaixo na grelha, do lado em que se situa o corpo do cliente.
5. IA (opcional): o fornecedor confirma ou ajusta o tamanho e escreve a explicação no idioma do cliente.

Stock, encomendas e devoluções

Com a gestão de stock ativa, o módulo verifica as combinações cujo nome corresponde aos tamanhos da tabela. Se o tamanho recomendado estiver esgotado em todas as combinações, o cliente vê «O tamanho M está esgotado de momento», o botão propõe o tamanho vizinho se estiver disponível e a página do produto mostra «O seu tamanho: M (esgotado)».

Ao validar uma encomenda, a última recomendação do cliente (30 dias) para cada produto é associada à encomenda, com o tamanho realmente encomendado. As devoluções de mercadoria pedidas pelo cliente e as notas de crédito criadas no back office marcam depois a recomendação como devolvida. É isso que alimenta a taxa de devolução do painel de desempenho.

RGPD e dados

• Os perfis e as recomendações são guardados na sua loja.
• Com o módulo psgdpr, a exportação e a eliminação dos dados de um cliente incluem o seu perfil e as suas recomendações.
• Com a camada de IA, só são enviadas ao fornecedor as medidas necessárias ao cálculo, sem nome nem e-mail.

Perguntas frequentes e resolução de problemas

O botão não aparece na página do produto. Verifique se uma tabela ativa se aplica ao produto e se o hook escolhido existe no seu tema. Com displayDfSizeFit, acrescente a chamada ao hook no template do produto.

O botão «Escolher o tamanho» não aparece. O nome do valor do atributo tem de coincidir com o do tamanho na tabela (por exemplo «M» dos dois lados).

O assistente pede mais medidas. No modo «As minhas medidas» é preciso pelo menos uma medida correspondente às colunas da tabela. No modo «Altura e peso» são obrigatórios altura, peso e género.

A taxa de devolução continua vazia. Ative «Guardar recomendações». A taxa aparece após as primeiras encomendas associadas a uma recomendação.

A IA não responde. Use «Guardar e testar a ligação» para ler o erro do fornecedor. Entretanto responde o motor determinístico.