Recomendações e catálogo de produtos

O OneTrace.pro seleciona produtos para cada cliente: populares, “comprados juntos”, semelhantes, vistos recentemente e uma seleção personalizada. As recomendações aparecem no site, nos e-mails, nas jornadas e nas campanhas. Para funcionar, elas precisam de um catálogo de produtos e de eventos de visualização, carrinho e compra.

A seção fica no menu Engajamento → Recomendações. Todos os membros do projeto podem vê-la; conectar feeds, alterar configurações e iniciar o recálculo é permitido para “Proprietário”, “Administrador” e “Gerente”.

Catálogo de produtos

No topo da página aparece quantos produtos há no catálogo, quantos estão disponíveis e quantas categorias existem. Enquanto o catálogo estiver vazio, não há o que recomendar: conecte um feed ou envie os produtos pela API.

Como conectar um feed

1. No bloco Feeds de produtos, clique em Adicionar feed.
2. Informe o Nome e a URL do feed, o link para o arquivo.
3. Escolha o Formato: YML (Yandex), Google Merchant, CSV, JSON ou JSON Lines.
4. No campo Atualização, escolha com que frequência o feed é relido: a cada 1, 3, 6 ou 12 horas, ou uma vez por dia.
5. Se o feed for protegido por senha ou token, preencha o Cabeçalho Authorization, por exemplo Bearer …. Ele é armazenado criptografado.
6. Clique em Salvar. A primeira importação começa na hora.

Em CSV e JSON, as colunas são reconhecidas pelo nome: id, name ou title, url, image, price, old_price, currency, available, category, brand (os nomes em russo para nome, preço e marca também são aceitos). As demais colunas são consideradas características do produto. O id do produto precisa ser igual ao que o site envia nos eventos; caso contrário, as ações dos clientes não serão ligadas ao catálogo.

Cada feed mostra o status (Ativo ou Falhou), o horário da última importação e o resultado: quantos produtos e categorias foram lidos e quantos foram marcados como indisponíveis. O botão Atualizar agora inicia a importação fora do agendamento. Pausar interrompe as importações agendadas (status “Pausado”), e Atualizar agora as retoma. Um feed com erro é repetido conforme o agendamento, e o texto do erro aparece abaixo dele.

O que é importante saber:

• Produtos que saíram do feed são marcados como indisponíveis, e não excluídos: o histórico de eventos deles é mantido, e um produto que volta ao feed fica disponível de novo.
• Ao excluir o feed, os produtos permanecem no catálogo.

Cópias das imagens

Nas configurações do feed, você pode ativar Copiar imagens de produtos para o nosso armazenamento. Assim, as imagens dos e-mails e widgets são carregadas pela CDN do OneTrace.pro e não dependem da disponibilidade do seu site.

• Baixar no máximo … imagens por segundo, minuto ou hora: um limite para não sobrecarregar o seu site. O padrão é 5 por segundo.
• Abaixo do feed aparece quantas imagens foram copiadas, quantas estão na fila e quantas falharam. Enquanto não houver cópia (ou se o endereço da imagem no feed mudar), é exibida a imagem original.
• As cópias contam para o limite de armazenamento de imagens do plano. Se o interruptor estiver indisponível, o armazenamento de imagens não está configurado na sua instalação.

Envio pela API

Os desenvolvedores podem enviar e excluir produtos com requisições a https://cdp.onetrace.pro/api/v1/products, até 1000 produtos e categorias por requisição. É preciso uma chave secreta com a permissão “Enviar e excluir produtos”; veja Chaves de API e Integração pelo servidor.

Eventos para os modelos

No bloco Eventos para os modelos, indique quais eventos representam ações com produtos:

Por padrão, os eventos vêm das configurações de previsões. Depois de Salvar, os modelos são recalculados.

Modelos e cálculo noturno

O cartão Modelos mostra o status (Pendente, Calculando, Pronto, Sem catálogo, Falhou), o horário do cálculo e o número de ligações entre produtos.

Os modelos são recalculados toda noite, além de logo após salvar as configurações e pelo botão Recalcular. Durante o cálculo e em caso de erro, as recomendações são fornecidas pela versão anterior.

Além das ligações, o cálculo grava nos perfis os atributos favorite_category, favorite_brand e top_products. Você pode usá-los em segmentos, por exemplo “categoria favorita: calçados”.

Tipos de recomendação

Um visitante novo, sem histórico, recebe produtos populares. Só entram nas seleções produtos disponíveis.

Verificação dos resultados

No bloco Verificar resultados, escolha o Tipo e informe o ID do produto, o ID da categoria ou o ID do perfil, conforme o tipo. Clique em Mostrar para ver os cartões dos produtos que o cliente receberá.

Relatório de efeito

A tabela Efeito no site em 30 dias mostra, para cada tipo, as impressões, os cliques, o CTR, as compras e a receita. A compra é contabilizada se o cliente comprou o produto em até 7 dias após clicar na recomendação, e a receita é calculada pelo preço do catálogo. O efeito das recomendações nos e-mails aparece nos relatórios das campanhas e das jornadas.

Onde exibir as recomendações

• No site: widgets prontos da seção “Site” ou uma chamada ao rastreador; veja Widgets de recomendação no site.
• Nos e-mails: o bloco Produtos no editor de e-mails. Nele você escolhe Quais produtos, Quantidade, o número de colunas, Mostrar preço e Botão abaixo do produto. Para os tipos “Vistos juntos”, “Comprados juntos” e “Semelhantes”, o produto vem do evento que disparou o e-mail (Propriedade do evento com o id do produto); é assim que se monta o e-mail de carrinho abandonado. Se não houver produtos adequados, o bloco não aparece no e-mail.
• Nos modelos de qualquer canal: a função recommendations():

{% for product in recommendations('personal', 4) %}
  <a href="{{ product.url }}">{{ product.name }}</a> — {{ product.price }}
{% endfor %}