Você está aqui:
Einstein Acompanhamento de atividades: Campos obrigatórios
Ao implementar Einstein controle de atividades para lojas híbridas ou personalizadas, inclua campos específicos para cada tipo de atividade. Este tópico lista os campos obrigatórios que Einstein APIs esperam para coleta e atribuição de dados adequadas.
Se você quiser usar Storefront Reference Architecture (SFRA) ou SiteGenesis, a vitrine rastreia os campos de atividade obrigatórios por meio das tags isobject. No entanto, se você estiver criando uma vitrine híbrida ou personalizada, certifique-se de rastrear os campos obrigatórios. O rastreamento dos campos obrigatórios permite que Einstein processe os dados.
Campos ausentes ou formatados incorretamente podem fazer com que o Einstien filtre incorretamente atividades importantes, resultando em dados incompletos em Einstein painéis e recomendações.
Campos obrigatórios para todas as atividades
Cada atividade Einstein requer estes campos base:
| Campo | Tipo | Descrição |
|---|---|---|
cookieId |
String | O identificador exclusivo da sessão do comprador. Esse valor vincula as atividades a um comprador específico. |
Reino |
String | Seu identificador de realm do B2C Commerce. |
siteId |
String | O ID do site onde a atividade ocorreu. |
Tipo de instância |
String | O tipo de instância (prd para instâncias de Production). Einstein não gera relatórios para instâncias que não são de Production. |
Activitytype |
String | O tipo de atividade. Valores válidos: viewProduct, viewReco, clickReco, addToCart, finishCheckout, viewCategory, viewSearch, clickCategory, clickSearch. |
Mais campos por tipo de atividade
Além dos campos base, cada tipo de atividade requer estes campos específicos:
| Tipo de atividade | Campos obrigatórios | Observações |
|---|---|---|
viewProduct |
|
É acionado quando um comprador visualiza uma página de detalhes do produto. Permite que os Recommenders visualizados recentemente e a personalização em tempo real. |
viewReco |
|
É acionado quando um comprador visualiza uma página que contém recomendações. Certifique-se de que o RecommenderName corresponde ao Recommender configurado no Business Manager. |
clickReco |
|
É acionado quando um comprador clica em um produto recomendado. Obrigatório para atribuição de cliques de recomendação. |
addToCart |
|
É acionado quando um comprador adiciona um produto ao carrinho. Obrigatório para atribuição relacionada ao carrinho. |
FinalizarCheckout |
|
É acionado quando um comprador conclui um pedido. Necessário para atribuição de receita e acompanhamento de conversões. |
viewCategory |
|
É acionado quando um comprador visualiza uma página de grade de categoria. |
viewPesquisar |
|
É acionado quando um comprador visualiza os resultados da pesquisa. |
clickCategoria |
|
É acionado quando um comprador clica de uma página de categoria para uma página de detalhes do produto. |
Clique em Pesquisar |
|
É acionado quando um comprador clica nos resultados da pesquisa para uma página de detalhes do produto. |
Solução de problemas
Se as atividades não estiverem aparecendo nos painéis Einstein, verifique estes problemas comuns:
- Tipo de instância de não-produção— Einstein não gera relatórios para atividades com valores de
instanceTypediferentes deprd. - Tipos de atividade ausentes ou vazios—Einstein não relata atividades sem um
activityTypeválido. - Nomes de recommender ausentes— para atividades
viewReco,clickRecoe recommendation-to-cart, umrecommenderNameausente impede a atribuição adequada. - IDs de produtos inválidos: verifique se os IDs de produtos correspondem aos IDs do catálogo de produtos.
Use a extensão do Chrome do Commerce Cloud Recommendation Validator para inspecionar os dados de atividade que estão sendo enviados de sua vitrine.
