Referência de campo de feed de produto para OpenAI

Como funcionam os mapeamentos padrão

O feed de produtos para OpenAI usa um sistema de mapeamento orientado a dados para transformar os dados do produto B2C Commerce no formato exigido pelo OpenAI. Quando o B2C Commerce pode derivar um valor usando atributos padrão do B2C Commerce, ele cria um mapeamento padrão que especifica como o valor é derivado:

• Mapeamentos de campo: Mapeie diretamente para um único atributo de produto do B2C Commerce, como nome, marca ou preço.
• Mapeamentos derivados: Calcule valores a partir de vários atributos ou aplique transformações, como remover HTML de descrições ou formatar preços com códigos de moeda.
• Mapeamentos constantes: Use um valor fixo para todos os produtos. Por exemplo, is_eligible_checkout é sempre falso. O Checkout Instantâneo no ChatGPT não é suportado.
• Mapeamentos alternativos: Mapeie primeiro para o atributo principal e, em seguida, volte para uma alternativa se o atributo principal estiver vazio para esse produto. Por exemplo, title usa name, voltando para masterProductName se name estiver em branco.

Você pode personalizar os campos marcados como Substituíveis: Sim, em Business Manager. Campos marcados como Substituíveis: Não são gerenciados pelo sistema e visíveis na tabela Mapeamento de campo, mas você não pode alterar seus mapeamentos.

Formatação automática de campos

O B2C Commerce aplica formatação automática aos valores de campo antes que eles sejam gravados no feed. Essa formatação acontece independentemente de você manter o mapeamento padrão ou substituí-lo por um atributo diferente. Quando você substitui um mapeamento padrão, não é necessário adaptar os dados do catálogo para corresponder ao formato do OpenAI — o B2C Commerce lida com a transformação.

A formatação se aplica da seguinte maneira:

• Datas: Os valores de data e datahora são formatados para aaaa-mm-dd (ISO 8601). Datas inválidas são omitidas do feed.
• Booleanos: Os valores são convertidos em verdadeiro ou falso.
• Números: Os valores numéricos são formatados com a precisão necessária (por exemplo, inteiros sem decimais ou duas casas decimais para classificações e preços). Valores inválidos ou nulos são omitidos.
• Preços: Os valores positivos são formatados com duas casas decimais e concatenados com o código da moeda.
• Descrições: As tags HTML são removidas do texto.
• Enums: Valores como disponibilidade e age_group são validados em relação a valores permitidos predefinidos.

Herança de atributo personalizado para variantes

Quando você mapeia um atributo personalizado para um campo OpenAI, o B2C Commerce resolve automaticamente os valores de atributo para produtos variantes usando a seguinte cadeia de herança:

1. Produto variante: O B2C Commerce primeiro verifica o produto variante quanto ao valor do atributo.
2. Grupo de variação: Se a variante não tiver o valor do atributo, o B2C Commerce verificará o grupo de variação (se aplicável).
3. Produto principal: Se o grupo de variação não tiver o valor, o B2C Commerce verificará o produto mestre.

Essa cadeia de herança garante que os atributos personalizados definidos no nível do mestre ou do grupo de variação sejam herdados automaticamente por variantes sem exigir a entrada de dados duplicados.

Elegibilidade do produto

Duas camadas controlam quais produtos aparecem no feed:

• Regras de filtro de produto: Regras configuráveis de inclusão e exclusão que determinam quais produtos são enviados para o OpenAI. Por padrão, as regras correspondem a produtos que estão online e pesquisáveis, mas você pode ajustá-las. Consulte Regras de filtro de produto para o feed de produtos.
• Exclusões automáticas: Independentemente de suas regras de filtro, o B2C Commerce sempre exclui o seguinte do feed:
  • Produtos mestre (as variantes são exportadas)
  • Grupos de variação (as variantes são exportadas)
  • Lotes de produtos. O ChatGPT não pode lidar com a seleção dinâmica de componentes que os conjuntos de produtos exigem. Os pacotes, que têm componentes fixos, são suportados e enviados para o OpenAI como produtos independentes.

Derivação de preço de lista

O campo de preço é mapeado para o preço normal (lista) de um produto. O B2C Commerce não tem um conceito interno de "preço de tabela"; As equipes do Storefront implementam preços de lista usando diferentes estratégias de lista de preços. Para acomodar essa variedade, o B2C Commerce deriva o preço de tabela para o feed em duas etapas:

1. Lista de preços selecionada. Se você selecionar uma lista de preços na lista de preços na guia Configurações gerais, o B2C Commerce usará o preço dessa lista de preços. A lista suspensa contém apenas listas de preços que estão ativas e contêm preços na moeda do feed. Se você desativar posteriormente a lista de preços selecionada, reconfigure a lista de preços para apontar para uma lista de preços diferente.
2. Caminho da lista de preços de venda. Se você não selecionar uma lista de preços, o B2C Commerce derivará o preço de lista da lista de preços de venda que o mecanismo de preços do B2C Commerce seleciona para o produto. O mecanismo de preços avalia todas as listas de preços aplicáveis ao produto, não apenas as ativas, e retorna o melhor (menor) preço junto com sua lista de preços de origem. A partir dessa lista de preços de venda, o B2C Commerce aplica uma de duas regras:
   • Se a lista de preços de venda tiver uma lista de preços pai, o B2C Commerce caminhará a cadeia pai até a raiz e retornará o preço da lista de preços raiz. Isso corresponde ao comportamento padrão de SFRA e SiteGenesis vitrines.
   • Se a lista de preços de venda não tiver um controlador, o B2C Commerce retornará o preço máximo em todas as listas de preços aplicáveis para o produto. Isso corresponde ao comportamento padrão de PWA Kit vitrines.

Nota Se o preço de lista resolvido for igual ao preço de venda, o B2C Commerce preencherá somente o campo de preço e omitirá sale_price da entrada do feed desse produto. Isso evita mostrar um preço tachado no ChatGPT para produtos que não estão à venda.

Definir a lista de preços de lista na guia Configurações gerais é a maneira mais confiável de garantir que o preço de lista em seu feed corresponda ao que os compradores veem em sua vitrine, especialmente para vitrines com lógica de preços personalizada, preços baseados em zona ou listas de preços de várias moedas.

Derivação do Preço de Venda

O campo sale_price mapeia para o atributo salePrice do B2C Commerce mais a moeda configurada. O valor salePrice não é retirado de uma única lista de preços — o mecanismo de preços do B2C Commerce seleciona o melhor (menor) preço entre todas as listas de preços aplicáveis para o produto, independentemente da hierarquia da lista de preços ou da configuração de uma hierarquia.

Como o mesmo mecanismo preenche o preço que sua vitrine exibe, o valor sale_price enviado para o OpenAI corresponde ao que os compradores veem em seu site.

Se o preço de venda resolvido for igual ao preço de tabela resolvido (o campo de preço ), o B2C Commerce omitirá sale_price da entrada do feed desse produto. Isso evita mostrar um preço tachado no ChatGPT para produtos que não estão realmente à venda. Consulte Derivação de preço de lista.

Se sua loja usa lógica de preços personalizada, como seleção de lista de preços baseada em zona ou geo, o cálculo do preço de venda padrão pode não corresponder ao que os compradores veem. Definir a lista de preços na guia Configurações gerais é a maneira mais confiável de alinhar o feed com sua vitrine nesses casos.

Campos obrigatórios

Os campos a seguir são necessários para uma entrada de feed de produto válida. Produtos que não têm campos obrigatórios ainda estão incluídos no feed, mas o OpenAI pode rejeitar essas linhas individuais. Use a visualização do feed de produtos para identificar produtos com campos obrigatórios ausentes e corrigi-los antes de ativar a sincronização diária do feed. Consulte Visualizar o feed de produtos.

Aviso Se mais de 30% dos seus produtos não tiverem campos obrigatórios, a OpenAI poderá rejeitar todo o feed. Verifique se os dados do catálogo estão completos antes de ativar a sincronização diária de feed.

Nota Alguns campos obrigatórios não têm um mapeamento padrão. Configure esses campos no Business Manager antes de gerar seu feed. Eles se dividem em dois grupos:

• Configurar na guia Configurações Gerais, na seção Detalhes da Empresa:
  • seller_name: Sua loja ou marca conforme mostrado aos compradores no ChatGPT.
• Configure na guia Catálogo, na seção Mapeamento de Campo, usando Substituir com valor ou padrão constante:
  • seller_url: Um URL para a página inicial da sua loja.
  • return_policy: Um URL que aponta para sua página de política de devolução.

Campos opcionais

Os campos a seguir são opcionais e podem melhorar suas listagens de produtos no ChatGPT. Os campos opcionais são omitidos do feed quando o atributo mapeado ou o valor constante está em branco.