Compartilhar via


Entidades de dados de interações

Este artigo oferece orientações sobre como configurar entidades de dados de suas interações no contrato de dados do Recomendações Inteligentes.

Revisão de entidades de dados

Uma entidade de dados é um conjunto de um ou mais arquivos de texto de dados, cada um com uma lista de colunas (também chamadas de atributos) e linhas contendo os valores de dados reais.

O Recomendações Inteligentes define grupos lógicos de entidades de dados, cada um com sua própria finalidade.

Observação

As entidades de dados são opcionais (a menos que explicitamente indicado de outra forma), o que significa que seus dados podem estar vazios ou totalmente ausentes.

Para obter a lista completa de entidades de dados, consulte entidades de dados.

Introdução às entidades de dados de interações

As interações representam o conjunto de todas as formas que um usuário usa para interagir com os itens do catálogo. Algumas ações de usuários comuns incluem interações transacionais (compras), visualizações, classificações ou qualquer outro tipo de interação entre um usuário e um item ou variante de item.

As seguintes entidades de dados fazem parte das entidades de dados de interações:

Interações

Nome da entidade de dados:Reco_Interactions.

Descrição: todas as interações do usuário com itens e variantes de itens.

Atributos:

Nome Tipo de dados Obrigatório Valor padrão Comportamento de valor inválido Comentários
InteractionGroupingId String(256) Sim Soltar entrada Uma ID de agrupamento para várias interações. Tamanho limitado a 256 caracteres.
ItemId String(16) Sim Soltar entrada Consulte Entidades de dados necessárias por cenário de recomendações para obter a ID do item.
ItemVariantId String(16) Não Soltar entrada Consulte Entidades de dados necessárias por cenário de recomendações para obter a ID da variante do item.
UserId String(256) Não Soltar entrada Um valor vazio representa uma interação anônima. Tamanho limitado a 256 caracteres.
InteractionType Cadeia de caracteres Não Transação Soltar entrada Transação é o único valor válido para este atributo e não afeta os resultados da recomendação.
Carimbo de Data/Hora DateTime Não 1970-01-01T00:00:00.000Z Soltar entrada Consulte Entidades de dados necessárias por cenário de recomendações para obter valores de DateTime.
Atributo de cadeia de caracteres String(64) Não Soltar entrada Tamanho limitado a 64 caracteres. Um atributo da cadeia de caracteres que pode ser usado de acordo com as necessidades dos negócios e não afeta o processo de modelagem.
Atributo duplo Duplo Não Soltar entrada Um atributo duplo que pode ser usado de acordo com as necessidades do negócio e não afeta o processo de modelagem.
Canal String(64) Não 0 Cortar valor Tamanho limitado a 64 caracteres.
Catálogo String(64) Não 0 Cortar valor Tamanho limitado a 64 caracteres.
Ponto Forte Duplo Não 1.0 Soltar entrada Representa a importância das interações (em comparação com outras interações). Esse atributo pode ajudar a melhorar os processos e o desempenho da transação, mas a transparência e o uso ético dos dados são considerações importantes. Compatível com Melhor Próxima Ação, Escolhas do Usuário e Semelhantes (AlgoType=MF).
IsPositive Bool Não Verdadeiro Consulte Entidades de dados necessárias por cenário de recomendações para obter valores boolianos.

Diretrizes:

  • InteractionGroupingId é o principal indicador colaborativo que agrupa os itens em uma única interação de vários itens. Pode ser qualquer coisa que, no escopo da sua empresa, crie relações entre os itens. Por exemplo, itens comprados nas mesmas interações (cesta) podem estar conectados/relacionados, portanto, a ID da cesta/transação pode ser uma boa opção para esse campo. Se um fator colaborativo for o usuário (pessoa) interagindo com itens, talvez você queira copiar a UserId neste campo e tê-la no campo UserId também.

  • Garanta que a entidade de dados Interações contenha interações do mesmo tipo (o tipo pode ser - curtidas, transações, visualizações, etc.). Para obter recomendações para tipos de interação variados, recomendamos que um componente de modelagem leia interações do mesmo tipo. A consolidação de diferentes tipos de transações no mesmo modelo retorna recomendações mistas com significado diferente e não necessariamente desejado do que o trabalho com modelos separados/contas IR.

  • Os tipos de interação incompatíveis são ignorados.

  • Todas as linhas de dados que representam a mesma operação (por exemplo, uma transação de vários itens) devem ter a mesma ID de agrupamento exclusiva.

  • As interações negativas (como devoluções ou descurtidas de itens) são representadas por IsPositive=False.

  • As colunas Atributo duplo, Atributo de cadeia de caracteres e Tipo de interação listadas podem ser deixadas em branco por enquanto.

  • O uso de "0" como o valor para os atributos "Canal" ou "Catálogo" acarreta um erro de processamento.

  • No cenário Próxima Melhor Ação, o atributo Intensidade é limitado a 10. Os valores acima de dez são substituídos por dez.

  • Exemplos de quando usar intensidade incluem:

    • Priorize produtos com maior probabilidade de interação (ou seja, exibidos, observados etc.). Se preferir ter maior priorização em compras recentes, considere experimentar a API Picks usando o tipo de algoritmo RecentPurchases, que já prioriza as interações mais recentes de um usuário.
    • As pontuações de classificação para produtos em escala de 1 a 5 podem ser refletidas definindo a intensidade da transação relevante como a pontuação de classificação que o usuário atribuiu ao item.
    • Priorize a duração da exibição de um vídeo atribuindo a exibições mais longas uma intensidade maior do que aos vídeos de exibições mais curtas.

Dados de exemplo:

Os cabeçalhos aparecem apenas por conveniência e não devem fazer parte dos dados reais.

InteractionGroupingId ItemId ItemVariantId UserId InteractionType Carimbo de data/hora Atributo de cadeia de caracteres Atributo duplo Canal Catálogo Ponto Forte IsPositive
Interaction100 Item1 Item1Var1 Transação 2020-04-01T10:00:00.000Z
Interaction100 Item2 Transação 2020-04-01T10:00:00.000Z 2.0
Interaction101 Item2 User1 Curtir 2020-05-01T13:25:00.000Z Interaction-101-RT Falso
Interaction101 Item3 User2 Avaliação 2020-07-12T08:45:00.000Z Europa MySale 4.0 Falso

Para obter a lista completa de entidades de dados, consulte entidades de dados.

Ver também

Visão geral do contrato de dados
Tabela Mapeamento de entidades de dados
Entidades de dados de catálogo
Entidades de dados de configuração de recomendações
Entidades de dados de listas externas
Entidades de dados de usuários recusados
Entidades de dados de enriquecimento de recomendações
Entidades de dados de mapeamentos de imagem para item
API do Recomendações Inteligentes
Guia de Início Rápido: configurar e executar o Recomendações Inteligentes com dados de exemplo