Controlar quais metacampos de produtos  o Shoply pode utilizar

O seu Assistente de Compras com IA foi concebido para ajudar os clientes, lendo as informações dos seus produtos, respondendo a perguntas e fazendo recomendações.

No entanto, nem todos os dados dos produtos se destinam aos clientes. Alguns metacampos de produtos  podem incluir informações internas (como a margem de lucro), dados de fornecedores ou outros atributos que devem permanecer privados. Nestes casos, pode preferir que o Shoply não utilize esses metacampos ao responder às perguntas dos clientes.

O Shoply utiliza IA para determinar automaticamente quais metacampos podem ser utilizados ao responder às perguntas dos clientes. No entanto, para lhe dar controlo total, o Shoply permite-lhe definir metacampos de produtos específicos ou namespaces inteiros de metacampos como lista negra (excluir).

Este guia explica por que motivo isto é útil e como configurar esta opção.

Onde encontrar as Definições avançadas?

Aceda à secção “Definições” da consola de administração da aplicação e, em seguida, desça até à secção “Definições avançadas”. Nesta secção, pode fornecer um objeto JSON  para configurar várias definições.

Definições da lista negra

Utilize estas definições para impedir que o Shoply utilize metacampos de produtos específicos ao responder às perguntas dos clientes.

blacklist_product_fields

Uma lista de chaves exatas de metacampos (nomes dos campos) que pretende excluir. O nome do campo tem de corresponder exatamente à chave do metacampo tal como aparece no Shopify.

Exemplos de chaves de metacampos:

• start_date
• product_type
• backstock_number
• upc
• shipping_lead_time
• brand

Nota: se não quiser mostrar o fornecedor do produto, tem de adicionar “brand” à lista negra, pois, por motivos históricos, o Shoply utiliza o metacampo brand para armazenar as informações do fornecedor.

blacklist_display_filters

Uma lista de chaves exatas de metacampos a ocultar apenas na interface de filtros/facetas. Ao contrário de blacklist_product_fields, estes campos continuam disponíveis para a IA responder às perguntas dos clientes — simplesmente não são apresentados como filtros selecionáveis na interface de pesquisa.

Isto é útil quando um metacampo contém informações valiosas sobre o produto que a IA deve conhecer, mas que não fazem sentido como filtro visível para os clientes.

Exemplo:

• warehouse_region — contexto útil para a IA, mas um filtro pouco útil para os clientes
• care_instructions — útil para as respostas da IA, mas não é uma categoria de filtro relevante

blacklist_namespaces

Uma lista de namespaces inteiros  que pretende que a IA ignore.

Exemplo:

• RenterInfo

Se um metacampo pertencer a um namespace incluído na lista negra, todos os campos desse namespace são excluídos automaticamente.

Isto é útil quando um namespace inteiro contém informações internas ou sensíveis.

Sugestões para criar uma lista negra

Recomenda-se colocar na lista negra:

• Códigos de fornecedores
• Dados do armazém / informações de inventário
• Notas internas sobre o processamento de encomendas
• Metacampos utilizados por outras aplicações
• Qualquer campo que não deva estar visível para os clientes

Evite colocar na lista negra campos como:

• Título do produto
• Descrição
• Material
• Tamanho, dimensões ou especificações
• Ingredientes
• Instruções de manutenção
• Nomes/opções de variantes

(Estes campos ajudam a IA a dar respostas melhores.)

Enriquecer os dados dos produtos com etiquetas

split_tag_to_metafield_by

As etiquetas do Shopify são uma forma prática de identificar produtos, mas são armazenadas como uma lista simples de strings e não podem ser utilizadas como filtros estruturados. Esta definição permite converter etiquetas no formato key:value em metacampos adequados que o Shoply pode indexar e utilizar para filtragem.

Como funciona:

Defina split_tag_to_metafield_by como o caráter delimitador utilizado nas suas etiquetas. O Shoply dividirá cada etiqueta nesse caráter, tratará o lado esquerdo como a chave do metacampo e o lado direito como o valor, indexando-os em conformidade.

Por exemplo, se os seus produtos tiverem etiquetas como:

material:aluminum
color:matte-black
compatible-with:iPhone 15

Definir o delimitador como ":" produzirá os seguintes metacampos:

Estes metacampos indexados podem depois ser utilizados como filtros de facetas no Shoply AI Search — tal como os metacampos nativos do Shopify.

As etiquetas que não contenham o delimitador são ignoradas por esta definição e permanecem como etiquetas normais.

Exemplo de configuração:

{
  "split_tag_to_metafield_by": ":"
}

Quando utilizar esta opção:

• A sua loja já utiliza etiquetas key:value para atributos (por exemplo, provenientes de uma importação em massa ou de uma aplicação de terceiros)
• Pretende adicionar atributos filtráveis sem criar definições formais de metacampos no Shopify
• Precisa de uma forma rápida de disponibilizar dados estruturados dos produtos ao Shoply sem voltar a etiquetar o seu catálogo

Controlar a apresentação dos produtos

Utilize estas definições para controlar que informações são apresentadas quando os produtos são mostrados no chat ou na interface de pesquisa.

hide_discount

Quando definido como true, as percentagens de desconto (por exemplo, “-40%”) são ocultadas da apresentação dos produtos. Isto é útil se não quiser dar destaque aos descontos para os clientes.

hide_price

Quando definido como true, todas as informações de preço são ocultadas, incluindo os preços originais e os preços com desconto. Utilize esta opção se preferir que os clientes visitem a página do produto para consultar os preços ou se a sua estratégia de preços exigir que estes sejam ocultados na interface de chat/pesquisa.

hide_review

Quando definido como true, as classificações das avaliações não são apresentadas nos produtos. Isto é útil se não quiser que as pontuações das avaliações influenciem as decisões dos clientes na interface de chat/pesquisa.

Exemplo de um objeto JSON válido

Eis um exemplo totalmente válido:

{
  "blacklist_product_fields": [
    "profit_margin",
    "inventory_level"
  ],
  "blacklist_display_filters": [
    "product_type",
    "category_name",
    "warehouse_region",
    "care_instructions"
  ],
  "blacklist_namespaces": [
    "SupplierInfo"
  ],
  "split_tag_to_metafield_by": ":",
  "hide_discount": true,
  "hide_price": false,
  "hide_review": false
}

Pode remover os itens de que não precisa ou adicionar as suas próprias chaves e namespaces de metacampos. Defina as opções hide_* como true ou false, de acordo com as suas preferências.