Esta é a documentação apenas do Recommendations AI. Para testar a pesquisa de varejo e o console unificado de varejo na fase restrita do GA, entre em contato com a equipe de vendas do Cloud. Se você não quiser usar a pesquisa de varejo, permaneça no console de recomendações até novo aviso.

Se você estiver usando a versão v1beta do Recommendations AI, migre para a versão da API Retail.

Como solucionar problemas de integração

Nesta página, descrevemos como receber informações sobre erros que ocorreram no carregamento de dados (eventos de catálogo e de usuário) e previsões.

Se você precisar de ajuda para configurar alertas, consulte Como configurar alertas.

Introdução

É importante enviar informações precisas do catálogo e eventos do usuário para o Recommendations AI. Entender a origem dos erros de carregamento de dados e previsão ajuda você a encontrar e corrigir erros no seu site.

Como ver erros de integração agregados

Para ver os erros agregados gerados pelos processos de upload de dados e solicitações de previsão, use a página Erros.

Guia "Erros"

Clique nas guias para escolher entre Erros de catálogo de produtos, Erros de evento do usuário e Erros de previsão. O sistema também registra erros das importações de eventos/catálogos de usuários, como uma linha corrompida no arquivo do Google Cloud Storage. Nosso sistema registra até 100 erros por arquivo de importação. Defina o período de tempo em que os erros são exibidos e filtre com base no tipo de erro.

É possível clicar em um erro individual para ver os registros desse erro no Cloud Logging.

Este é um exemplo de registro de um erro individual:

Registros de erro

É possível abrir registros de erro individuais expandindo esse registro. Os registros de erros oferecem mais detalhes sobre a solicitação, incluindo payloads de solicitações e respostas e detalhes dos erros. Essas informações podem ajudar você a determinar onde a chamada de método incorreta está localizada no seu site.

Por exemplo, veja um registro de erro expandido para mostrar as informações do payload da solicitação:

Visualização detalhada do registro

Para erros de JSON inválidos, é possível ver mais informações sobre o problema expandindo o campo status:

Visualização detalhada do registro para erro JSON

Como ver o status de uma operação de integração específica

É possível ver o status de uma operação de integração específica usando o painel de atividade de integração:

  1. Acesse a página "Dados de Recommendations AI" no Console do Google Cloud.
    Acessar a página "Dados de Recommendations AI"

  2. Abra o painel de atividades de importação clicando em View Import Activity no lado direito da barra de botões.

    É possível inspecionar erros para operações específicas de integração.

  3. Clique em Ver registros na coluna "Detalhes" de qualquer operação com um erro para inspecionar os arquivos de registros no Cloud Logging.

Importar painel de atividades

Tipos de erro

  • MISSING_FIELD: um valor de campo obrigatório não foi definido. por exemplo, um item de catálogo não tem o título.
  • INVALID_TIMESTAMP: o carimbo de data/hora é inválido, por exemplo, estar muito distante no futuro ou formatado incorretamente.
  • FIELD_VALUE_TOO_SMALL: o valor no campo é menor que o mínimo necessário; por exemplo, um preço negativo.
  • INCORRECT_JSON_FORMAT: o JSON na solicitação está formatado incorretamente, como um colchete { ausente.
  • INVALID_LANGUAGE_CODE: o código do idioma está formatado incorretamente.
  • FIELD_VALUE_EXCEEDED: o valor no campo é maior que o máximo permitido.
  • INVALID_RESOURCE_ID: o ID do recurso é inválido; por exemplo, um catalog_id inexistente no nome do recurso.
  • FIELD_SIZE_EXCEEDED: o número de entradas no campo excede o limite máximo.
  • UNEXPECTED_FIELD: um campo que deveria estar vazio foi preenchido. Por exemplo, a transação para um evento de visualização da página de detalhes.
  • INVALID_FORMAT: o campo não está formatado corretamente, como uma string malformada.
  • RESOURCE_ALREADY_EXISTS: você tentou criar um recurso que já existe, como um item de catálogo criado anteriormente.
  • INVALID_API_KEY: a chave de API não corresponde ao projeto na sua solicitação.
  • INSUFFICIENT_PERMISSIONS: você não tem permissão para executar a solicitação. Esse erro geralmente está relacionado à falta de permissão do IAM necessária.
  • UNJOINED_WITH_CATALOG: a solicitação inclui um código de item de catálogo que não existe no catálogo. Verifique se o seu catálogo está atualizado.
  • BATCH_ERROR: a solicitação tem vários erros. Por exemplo, uma importação in-line com 10 itens que falharam na validação por motivos diferentes.
  • INACTIVE_RECOMMENDATION_MODEL: você consultou um modelo que não está ativo para exibição.
  • ABUSIVE_ENTITY: o ID do visitante ou do usuário associado à solicitação enviou um número anormal de eventos em um curto período.
  • FILTER_TOO_STRICT: o filtro de solicitação de previsão bloqueou todos os resultados da previsão. Os itens genéricos (não personalizados) conhecidos são retornados, a menos que a chamada especifique strictFiltering como falso. Nesse caso, nenhum item é retornado. Veja alguns motivos comuns que podem causar esse problema:

    • Você está especificando uma tag de filtro que não existe no seu catálogo. Pode levar até um dia para que uma atualização de tag de filtro entre em vigor.
    • Seu filtro é muito limitado.

Como visualizar registros diretamente

Também é possível abrir seus arquivos de registros diretamente no Logging. Por exemplo, este link abre registros para todos os erros do Recommendations AI na última hora:

Abrir registros do Recommendations AI

Como visualizar métricas de carregamento de dados de alto nível

Depois que o sistema de upload de dados estiver em execução, também será possível usar as guias "Catálogo" e "Evento" na página Dados do Recommendations AI para ver métricas de erro de alto nível dos seus dados processamento para garantir que tudo esteja funcionando sem problemas.

Também é possível adicionar alertas para saber se algo der errado com seu sistema de upload de dados.

Resumo dos dados do catálogo

As estatísticas de dados de alto nível na guia "Catálogo" mostram quantos itens foram importados, quantos estão em estoque e quando foram importados pela última vez.

Também é possível visualizar os itens do catálogo enviados e filtrar com base no ID do item.

Dados de importação do catálogo

Estatísticas de gravação de eventos do usuário

Para cada tipo de evento do usuário, você pode ver na guia "Eventos" quantos foram registrados, quantos não foram associados a um item do catálogo (eventos não incluídos) e como os números são diferentes. períodos anteriores. É possível escolher um período de um dia, uma semana e um mês, ou inserir um período personalizado.

Veja um gráfico de eventos do usuário ingeridos ao longo do tempo e filtre-o por tipo de evento.

Estatísticas de eventos do usuário

Eventos cancelados

Quando um evento de usuário ou uma solicitação de previsão se refere a um item de catálogo que não foi enviado para o Recommendations AI, ele é um evento não associado. Eventos de usuários não associados ainda são registrados e solicitações de previsão não mescladas são processadas. No entanto, nenhum deles pode ser usado para aprimorar ainda mais o modelo para previsões futuras. Por esse motivo, você precisa garantir que a porcentagem de eventos não registrados seja muito baixa para eventos de usuário e solicitações de previsão.

Veja a porcentagem de eventos de usuários não associados na guia "Evento" da página "Dados":

Eventos do usuário cancelados

Você pode ver a porcentagem de solicitações de previsão não associadas na página Canais:

Solicitações de previsão não associadas

Erros da API

Para ver um gráfico de erros da API ao longo do tempo, exibido pelo nome do método, clique em Visualizar métricas da API na barra de botões da página Erros.

A seguir