Como controlar quais metacampos de produto o Shoply pode usar

Seu Assistente de Compras com IA foi desenvolvido para ajudar clientes lendo as informações dos seus produtos, respondendo perguntas e fazendo recomendações.

No entanto, nem todos os dados do produto são destinados aos clientes. Alguns metacampos de produto  podem incluir informações internas (como margem de lucro), detalhes de fornecedores ou outros atributos que devem permanecer privados. Nesses casos, talvez você prefira que o Shoply não use esses metacampos ao responder perguntas de clientes.

O Shoply usa IA para determinar automaticamente quais metacampos podem ser usados ao responder perguntas de clientes. No entanto, para oferecer controle total, o Shoply permite que você defina uma lista de bloqueio (exclusão) para metacampos de produto específicos ou namespaces inteiros de metacampos.

Este guia explica por que isso é útil e como configurar.

Onde encontrar as Configurações Avançadas?

Vá até a seção “Settings” do painel administrativo do app e, em seguida, role para baixo até a seção “Advanced Settings”. Nessa seção, você pode fornecer um objeto JSON  para configurar várias definições.

Para a política de dados mais ampla, consulte quais informações o Shoply pode usar.

Configurações de lista de bloqueio

Use estas configurações para impedir que o Shoply use metacampos de produto específicos ao responder perguntas de clientes.

Para ocultar um item inteiro em vez de campos individuais, exclua produtos inteiros da indexação.

blacklist_product_fields

Uma lista de chaves exatas de metacampos (nomes de campo) que você deseja excluir. O nome do campo deve corresponder exatamente à chave do metacampo, conforme aparece dentro do Shopify.

Exemplos de chaves de metacampos:

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

Observação: se você não quiser mostrar o fornecedor do produto, precisa adicionar “brand” à lista de bloqueio, pois o Shoply usa o metacampo brand para armazenar informações do fornecedor por motivos legados.

blacklist_display_filters

Uma lista de chaves exatas de metacampos para ocultar apenas da interface de filtros/facetas. Diferentemente de blacklist_product_fields, esses campos ainda ficam disponíveis para a IA responder perguntas de clientes — eles apenas não são exibidos como filtros selecionáveis na interface de busca.

Para entender quais atributos aparecem, veja como o Shoply gera filtros de produto.

Isso é ú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 o cliente.

Exemplo:

• warehouse_region — contexto útil para a IA, mas não um filtro útil para clientes
• care_instructions — bom para respostas da IA, mas não uma categoria de filtro significativa

blacklist_namespaces

Uma lista de namespaces  inteiros que você deseja que a IA ignore.

Exemplo:

• RenterInfo

Se um metacampo pertencer a um namespace bloqueado, todos os campos nesse namespace serão excluídos automaticamente.

Isso é útil quando um namespace inteiro é interno ou sensível.

Dicas para usar a lista de bloqueio

Recomendado bloquear:

• Códigos de fornecedores
• Detalhes de armazém / inventário
• Notas internas de fulfillment
• Metacampos usados por outros apps
• Qualquer campo que não deva ficar visível para clientes

Evite bloquear campos como:

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

(Isso ajuda a IA a dar respostas melhores.)

Enriquecer dados de produto a partir de tags

split_tag_to_metafield_by

As tags do Shopify são uma forma conveniente de rotular produtos, mas são armazenadas como uma lista plana de strings e não podem ser usadas como filtros estruturados. Essa configuração permite converter tags no estilo key:value em metacampos adequados que o Shoply pode indexar e usar para filtragem.

Como funciona:

Defina split_tag_to_metafield_by com o caractere delimitador usado nas suas tags. O Shoply dividirá cada tag nesse caractere, tratará o lado esquerdo como a chave do metacampo e o lado direito como o valor, e fará a indexação de acordo.

Por exemplo, se seus produtos tiverem tags como:

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

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

Esses metacampos indexados podem então ser usados como filtros de faceta no Shoply AI Search — assim como os metacampos nativos do Shopify.

As tags que não contêm o delimitador são ignoradas por essa configuração e permanecem como tags comuns.

Exemplo de configuração:

{
  "split_tag_to_metafield_by": ":"
}

Quando usar isso:

• Sua loja já usa tags key:value para atributos (por exemplo, de uma importação em massa ou app de terceiros)
• Você quer adicionar atributos filtráveis sem criar definições formais de metacampos no Shopify
• Você precisa de uma forma rápida de expor dados estruturados de produto ao Shoply sem remarcar seu catálogo

Controlar a exibição de produtos

Use estas configurações para controlar quais informações são mostradas quando produtos são exibidos no chat ou na interface de busca.

Para alterações visuais nos campos que você mantiver, você pode personalizar o estilo do product-card com CSS.

hide_discount

Quando definido como true, percentuais de desconto (por exemplo, “-40%”) serão ocultados das exibições de produto. Isso é útil se você não quiser enfatizar descontos para clientes.

hide_price

Quando definido como true, todas as informações de preço serão ocultadas, incluindo preços originais e preços com desconto. Use isso se preferir que os clientes visitem a página do produto para ver os preços, ou se sua estratégia de precificação exigir ocultar preços na interface de chat/busca.

hide_review

Quando definido como true, as notas de avaliação não serão mostradas nas exibições de produto. Isso é útil se você não quiser que as pontuações de avaliações influenciem as decisões dos clientes na interface de chat/busca.

Exemplo de um objeto JSON válido

Aqui está 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
}

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