Avaliações de produtos
As avaliações dos clientes ajudam outras pessoas a escolher o produto, e as estrelas nos resultados de busca atraem cliques. O OneTrace.pro coleta avaliações por um link no e-mail após a compra, verifica-as com IA e mostra as publicadas na página do produto, nos widgets de recomendação, nos e-mails e nas respostas do chat com IA.
As avaliações de produtos estão disponíveis a partir do plano “Crescimento”; veja Planos. É necessário ter o catálogo de produtos (Recomendações e catálogo de produtos).
Link para avaliação
Adicione ao e-mail após a compra um link com a função review_url — por exemplo, em uma jornada uma semana depois do pedido:
Avalie sua compra: {{ review_url(event.properties.items) }}
A função aceita o id de um produto (review_url('SKU-123')), uma lista de ids ou uma lista de produtos com o campo id ou product_id — até 10 produtos. O link é pessoal e assinado: o cliente só consegue avaliar os produtos do e-mail, e a avaliação entra no perfil dele.
Na página de avaliação, o cliente dá a cada produto de uma a cinco estrelas, escreve um título e um texto, se quiser, e informa o nome que aparecerá no site. Produtos sem nota são ignorados. Pelo mesmo link é possível alterar a avaliação — a avaliação alterada passa de novo pela moderação. Cada cliente deixa uma única avaliação de cada produto.

Moderação
As avaliações novas aguardam verificação na seção Site → Avaliações de produtos. No topo ficam as filas Em moderação, Publicadas, Rejeitadas e Todas, e a caixa Somente com alertas da IA deixa só as avaliações em que a IA encontrou algo. Em cada avaliação aparecem o produto, a nota, o texto, o nome do autor e o link para o perfil do cliente.
- Publicar — a avaliação aparece no site e entra na nota do produto;
- Rejeitar — a avaliação não é mostrada, mas continua na seção;
- a lixeira exclui a avaliação de vez.
Uma função com permissão para visualizar o catálogo pode ver as avaliações; para decidir sobre elas, é preciso a permissão para gerenciar o catálogo. Cada decisão é registrada no log de auditoria do projeto; veja Configurações do projeto, plano e auditoria.

Verificação com IA
A IA verifica cada avaliação nova e coloca alertas com o motivo:
| Alerta | O que a IA encontrou |
|---|---|
| Spam | publicidade, links para outras lojas, texto sem sentido |
| Ofensas | palavrões e ofensas |
| Dados pessoais | telefones, endereços, e-mails e outros dados no texto |
Uma avaliação sem problemas recebe o alerta “IA: sem observações”. Uma nota negativa não é motivo para alerta: uma avaliação honesta de duas estrelas passa na verificação.
Ative Publicar imediatamente avaliações de 4–5★ sem alertas da IA para que as boas avaliações apareçam no site sem espera. As demais avaliações — com nota baixa, com alertas ou com um link ou número de telefone no texto — continuam aguardando um moderador.
A verificação é cobrada do saldo do projeto conforme o uso, como as outras funções de IA. Sem saldo, as avaliações não são verificadas e aguardam um moderador sem alertas.
Bloco de avaliações no site
Coloque na página do produto um elemento com o id do produto no catálogo:
<div data-cdp-reviews data-product-id="SKU-123"></div>
O rastreador mostra nele a nota média, a distribuição das notas de 5 a 1 e as avaliações publicadas, de 10 em 10, com o botão Mostrar mais. Os rótulos aparecem no idioma do visitante. Se ainda não houver avaliações, o bloco informa isso. O código pronto para um dos seus produtos e a pré-visualização do bloco ficam na seção Site → Avaliações de produtos.

- Estrelas na busca. O bloco adiciona à página a marcação schema.org — a nota e as avaliações do produto, com as quais os buscadores mostram estrelas nos resultados. Se a página já tiver a própria marcação de produto com avaliações, adicione
data-schema="false". - Cor das estrelas — atributo
data-accent="#f59e0b". - Site de página única. Se o produto da página mudar sem recarregar, altere
data-product-id— o bloco se atualiza sozinho. - Desativar o bloco no site inteiro —
cdp.init(key, { reviews: false }).
Nota nas recomendações, nos e-mails e no chat
A nota do produto — a média das avaliações publicadas — é recalculada após cada decisão do moderador e aparece:
- nos widgets de recomendação — estrelas e número de avaliações abaixo do nome do produto;
- no bloco “Produtos” do editor de e-mails — uma linha com a nota nos produtos que têm avaliações;
- nas respostas da IA no chat: o bot vê a nota dos produtos que sugere.
API
GET /api/v1/reviews?product=SKU-123— avaliações publicadas do produto, nota e distribuição das notas. Funciona com a chave de gravação e com a chave secreta; é prático para um bloco de avaliações próprio ou um aplicativo.POST /api/v1/reviews— avaliação enviada pelo servidor da loja (chave secreta com permissão para gerenciar o catálogo): o cliente é identificado por um identificador, por exemplo o e-mail. A avaliação passa pela mesma verificação e moderação. Para transferir avaliações já verificadas do sistema anterior, enviepublish: truee a data da avaliaçãodate— a avaliação será publicada na hora.
Os detalhes estão na referência da API; veja Chaves de API.
Eventos
Cada avaliação é registrada no perfil do cliente com o evento $review_submitted, com as propriedades product_id, rating e source. Com ele, é possível montar um segmento ou agradecer ao cliente em uma jornada.