Pular para o conteúdo principal

Introdução

Registre o que seus usuários e convidados fazem e transforme isso em experiências personalizadas.

Mais informações sobre a interface do usuário do módulo https://doc.oneentry.cloud/docs/category/useractivity

🎯 O que este módulo faz?​

O módulo UserActivity permite que você monitore eventos de atividade para o usuário ou convidado atual - visualizações de produtos, visualizações de páginas, pesquisas, ações no carrinho e na lista de desejos, compras e avaliações.

Os eventos que você envia alimentam o motor de recomendação do OneEntry, que impulsiona blocos de personalização como recomendações pessoais, recentemente visualizados, compra repetida e tendências.

🚀 Início Rápido​

Inicialize o módulo a partir de defineOneEntry:


const { UserActivity } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

Registre um evento de visualização de produto (funciona para um usuário autorizado ou um convidado):

// Track that the visitor opened a product page.
const ok = await UserActivity.trackUserActivity({
  type: "product_view",
  productId: 12345,
  meta: { sourceBlock: "catalog" },
});

console.log(ok); // true on success

trackUserActivity() aceita um único objeto de corpo e resolve para true em caso de sucesso. É fire-and-forget — não bloqueie a renderização por causa disso.

✨ Conceitos Chave​

Funciona para usuários e convidados​

A atividade está ligada ao contexto atual: um usuário autorizado (via o módulo AuthProvider) ou um convidado. Para convidados, o SDK envia um cabeçalho x-guest-id para que os eventos sejam atribuídos ao visitante anônimo correto. Veja Modo convidado para mais detalhes.

Tipos de eventos​

O tipo do evento é um dos valores fixos: product_view, page_view, category_view, search, product_add_to_cart, product_remove_from_cart, product_add_to_wishlist, product_remove_from_wishlist, product_purchase, product_rating.

📋 O que você precisa saber​

  • Envie o campo que corresponde à ação: inclua productId para eventos de produto, pageId para visualizações de página/categoria e query para pesquisas.
  • O campo meta aceita dados arbitrários (bloco de origem, variante A/B, profundidade de rolagem) para suas próprias análises.
  • trackUserActivity() resolve para true em caso de sucesso - é fire-and-forget e não deve bloquear a interface do usuário.

📊 Tabela de Referência Rápida​

MétodoDescrição
trackUserActivity()Registre um evento de atividade de usuário ou convidado

❓ Perguntas Comuns (FAQ)​

Preciso autorizar o usuário para rastrear a atividade?​

Não. A atividade é registrada para o contexto atual - um usuário autorizado ou um convidado. No navegador, o SDK gera e persiste um id de convidado automaticamente; no servidor, passe um guestId por visitante.

Para que serve o campo meta?​

meta é um objeto de formato livre para qualquer informação extra que você queira anexar a um evento, como o bloco de origem, uma variante de teste A/B ou profundidade de rolagem.

🎓 Melhores Práticas​

  • Rastreie eventos à medida que acontecem, mas não bloqueie a renderização na chamada de rede.
  • Envie productId / pageId / query que corresponda ao tipo do evento.
  • Mantenha os ids de convidados estáveis para que a atividade de um convidado seja consistente entre as solicitações.

🔗 Documentação Relacionada​