Prova virtual por IA para WooCommerce: documentação

O que o plugin faz

O DF Google Try-On acrescenta um botão de prova virtual às suas fichas de produto WooCommerce. A cliente carrega uma fotografia ou usa a webcam, e a inteligência artificial gera uma imagem dela a usar a peça de roupa. A pré-visualização aparece numa modal, sem nunca sair da ficha de produto.

Requisitos

• WordPress 6.2 ou superior, WooCommerce 7.0 ou superior
• PHP 7.4 ou superior, com a extensão OpenSSL ativa
• Um projeto Google Cloud com a faturação ativa
• A API Vertex AI ativada nesse projeto
• Uma conta de serviço com a função Vertex AI User

Etapa 1: preparar a Google Cloud

Ativar a API Vertex AI

Na consola da Google Cloud, selecione o seu projeto, vá à biblioteca de API e ative a Vertex AI API. Verifique que a faturação está mesmo ativa no projeto: sem ela, todas as chamadas falham.

Criar a conta de serviço

1. Abra a secção IAM e administração, e depois Contas de serviço.
2. Crie uma conta de serviço (o nome não importa, por exemplo woocommerce-tryon).
3. Atribua-lhe a função Vertex AI User. Não conceda uma função mais ampla do que o necessário.
4. No separador Chaves, crie uma chave do tipo JSON e descarregue o ficheiro.

Escolher uma região

O modelo tem de estar disponível na região que indicar. O valor predefinido us-central1 é o mais seguro. Se quiser uma região europeia, verifique previamente a disponibilidade do modelo Virtual Try-On na documentação da Google, porque a cobertura regional evolui.

Etapa 2: instalar o plugin

1. No WordPress, vá a Plugins, Adicionar, Carregar plugin.
2. Selecione o ficheiro ZIP fornecido, instale e ative.
3. Aparece um novo menu: WooCommerce, Google Try-On.

Etapa 3: configurar

Todas as definições estão em WooCommerce, Google Try-On.

Ligação à Google

• Identificador do projeto GCP: o identificador do projeto, não o nome de apresentação.
• Região: por exemplo us-central1.
• JSON da conta de serviço: cole o conteúdo integral do ficheiro descarregado. O plugin valida o JSON na gravação e recusa uma chave mal formada.

Na gravação, a cache do token de acesso é limpa automaticamente: uma alteração de chave é portanto tida em conta de imediato.

Apresentação

• Ativar a prova: interruptor geral. Enquanto estiver desassinalado, nada aparece do lado da loja.
• Texto do botão: o texto apresentado na ficha de produto.
• Categorias elegíveis: limita o widget a determinadas categorias. Deixe vazio para autorizar todos os produtos.

Segurança e custos

• Filtro de segurança: nível de filtragem aplicado pela Google às imagens. O ajuste mais estrito é recomendado numa loja pública.
• Marca de água: acrescenta a marca de água SynthID da Google às imagens geradas. Recomendado, para assinalar que se trata de uma imagem sintética.
• Limite mensal: número máximo de provas bem-sucedidas por mês civil. Coloque 0 para não limitar, mas lembre-se de que cada geração é faturada.
• Texto de consentimento: a mensagem apresentada ao lado da caixa de seleção obrigatória.

O contador do mês em curso aparece no topo da página de definições.

Etapa 4: controlar a apresentação produto a produto

Na ficha de um produto, separador Geral dos dados do produto, uma definição Prova virtual propõe três valores:

• Auto: segue as categorias configuradas globalmente.
• Apresentar sempre: força a apresentação, mesmo fora das categorias elegíveis.
• Nunca apresentar: oculta o widget, seja qual for a configuração global.

Como funciona do lado técnico

O percurso de uma prova é o seguinte:

1. A cliente abre a modal e fornece uma fotografia, por importação ou captura pela webcam. A imagem é redimensionada no navegador, pelo lado maior, antes de qualquer envio.
2. Assinala a caixa de consentimento, obrigatória: sem ela, o pedido é recusado pelo servidor.
3. O servidor verifica o token de segurança, o produto, a limitação por endereço IP e o limite mensal.
4. O plugin assina um token JWT em RS256 com a chave privada da conta de serviço, troca-o por um token de acesso OAuth2 e coloca-o em cache até perto da expiração.
5. A fotografia e a imagem do produto são enviadas ao modelo Vertex AI, que devolve a imagem gerada.
6. A imagem é devolvida ao navegador e apresentada na modal.

A imagem da peça nunca é fornecida pelo navegador: é sempre lida no servidor a partir da ficha de produto. Isso impede um visitante de desviar o serviço para provar uma imagem arbitrária.

Dados pessoais e RGPD

A fotografia da cliente é um dado pessoal. O plugin foi concebido em conformidade:

• A fotografia nunca é guardada no seu servidor, nem na biblioteca de multimédia, nem na base de dados. Transita em memória durante o tempo da chamada.
• A imagem gerada é devolvida diretamente ao navegador e também não é guardada.
• Uma caixa de consentimento explícito, cujo texto redige, tem de ser assinalada antes de qualquer processamento.
• A fotografia é transmitida à Google, que atua como subcontratante. Mencione essa transferência na sua política de privacidade, indicando a finalidade e o destinatário.

Controlar os custos

Cada prova bem-sucedida corresponde a uma geração de imagem faturada pela Google. Estão integradas três salvaguardas:

• O limite mensal, que bloqueia as novas gerações depois de atingido.
• Uma limitação por endereço IP, que impede as chamadas em rajada.
• O uso exclusivo da imagem do produto no servidor, que proíbe qualquer uso desviado do serviço.

O contador é reposto automaticamente a cada novo mês civil. Vigie em paralelo o orçamento na consola da Google Cloud, onde pode definir alertas de faturação.

Resolução de problemas

O botão não aparece

Verifique por esta ordem: o interruptor geral está ativo, o identificador do projeto e o JSON estão preenchidos, o produto pertence a uma categoria elegível ou está forçado em Apresentar sempre, e o produto tem mesmo uma imagem principal.

Mensagem de erro de autenticação

A chave JSON é inválida ou incompleta, ou a conta de serviço não tem a função Vertex AI User. Volte a colar o ficheiro completo e verifique a função na consola da Google Cloud. Verifique também que a extensão OpenSSL está disponível no seu alojamento.

Nenhuma imagem gerada

O modelo pode recusar uma fotografia demasiado escura, desfocada, recortada ao rosto, ou com várias pessoas. Peça uma fotografia nítida, bem iluminada, de preferência de corpo inteiro e de frente. Um filtro de segurança muito estrito também pode bloquear certas imagens.

Erro de região ou de modelo não encontrado

O modelo não está disponível na região introduzida. Volte a us-central1 e verifique a disponibilidade regional do modelo na documentação da Google.

O serviço indica estar em plena capacidade

O limite mensal foi atingido. Aumente-o nas definições, ou espere pelo mês seguinte. O contador do mês em curso está visível no topo da página de definições.

Perguntas frequentes

É preciso instalar o Composer?

Não. O plugin usa um autoloader nativo e assina a autenticação da Google em PHP puro, através do OpenSSL.

O plugin é compatível com HPOS?

Sim, a compatibilidade com o armazenamento de encomendas de alto desempenho está declarada.

Funciona em telemóvel?

Sim. A captura usa a câmara frontal quando o navegador o permite, e a importação de fotografia está sempre disponível.

É possível provar outra coisa que não roupa?

O modelo foi treinado para roupa vestida. Os resultados em acessórios, calçado ou objetos são muito menos fiáveis. Restrinja o widget às suas categorias de vestuário.

O que acontece se desinstalar o plugin?

A desinstalação elimina as definições, o token em cache e os contadores mensais. A definição por produto é conservada, para não perder nada em caso de reinstalação.