Partilhar via

Entidades de dados de interações

  • Artigo

Este artigo fornece informações sobre como configurar entidades de dados de interações no contrato de dados do Intelligent Recommendations.

Revisão de entidades de dados

Uma entidade de dados é um conjunto de um ou mais ficheiros de texto de dados, cada um com uma lista de colunas (também denominados atributos) e linhas que contêm os valores reais dos dados.

O Intelligent Recommendations define grupos lógicos de entidades de dados, cada um com o seu próprio propósito.

Nota

As entidades de dados são opcionais, a menos que tenha sido explicitamente indicado o contrário, o que significa que os respetivos dados podem estar vazios ou em falta.

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

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

Interações representam o conjunto de todas as formas que um utilizador interage com os itens do catálogo. Algumas ações de utilizador comuns incluem interações transacionais (compras), vistas (clickthrough), classificações ou qualquer outra ação que ocorra entre um utilizador 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 de utilizador com itens e variantes de itens.

Atributos:

Name Tipo de dados Obrigatório Default value Comportamento de valor inválido Comentários
InteractionGroupingId Cadeia(256) Sim Entrada de largada Um ID de agrupamento para várias interações. Comprimento limitado a 256 carateres.
ItemId Cadeia(16) Sim Entrada de largada Consulte Entidades de dados obrigatórias por cenário de recomendações para ID de item.
ItemVariantId Cadeia(16) Não Entrada de largada Consulte Entidades de dados obrigatórias por cenário de recomendações para ID de variante de item.
UserId Cadeia(256) Não Entrada de largada Um valor vazio representa uma interação anónima. Comprimento limitado a 256 carateres.
InteractionType Cadeia (de carateres) Não Transação Entrada de largada Transação é o único valor válido para este atributo e não afeta os resultados da recomendação.
TimeStamp DateTime Não 1970-01-01T00:00:00.000Z Entrada de largada Consulte Entidades de dados obrigatórias por cenário de recomendações para valores de DateTime.
Atributo de Cadeia Cadeia(64) Não Entrada de largada O comprimento é limitado a 64 carateres. Um atributo de cadeia que pode ser utilizado de acordo com as necessidades da empresa e que não afeta o processo de modelação.
Atributo Duplo Duplo Não Entrada de largada Um atributo duplo que pode ser utilizado de acordo com as necessidades empresariais e que não afeta o processo de modelação.
Canal Cadeia(64) Não 0 Cortar valor Comprimento limitado a 64 carateres.
Catálogo Cadeia(64) Não 0 Cortar valor Comprimento limitado a 64 carateres.
Força Duplo Não 1.0 Entrada de largada Representa quão significativas são as interações (comparadas com outras interações). Este atributo pode ajudar a melhorar os processos de transação e o desempenho, mas a transparência e a utilização ética de dados são considerações importantes. Suportado na Melhor Ação Seguinte, Seleções do Utilizador e Semelhantes (AlgoType=MF).
IsPositive Bool Não Verdadeiro Consulte Entidades de dados obrigatórias por cenário de recomendações para valores booleanos.

Diretrizes:

  • InteractionGroupingId é o principal indicador colaborativo que agrupa itens numa única interação com vários itens. Pode ser qualquer coisa que, no âmbito do seu negócio, crie relações entre itens. Por exemplo, os itens Comprados nas mesmas interações (cesto) poderão estar ligados/relacionados, pelo que o ID da transação/cesto poderá ser adequado para este campo. Se um fator colaborativo for o utilizador (pessoa) que interage com os itens, poderá pretender copiar o UserId para este campo e tê-lo no campo UserId também.

  • Certifique-se de que a entidade de dados Interações contém interações do mesmo tipo (o tipo pode ser: gostos, transações, vistas, etc.). Para obter recomendações para vários tipos de interação, recomenda-se que um componente de modelação leia interações do mesmo tipo. A consolidação de diferentes tipos de transação no mesmo modelo obtém recomendações mistas com significados diferentes e não necessariamente pretendidos, em vez de trabalhar com modelos/contas de IR separados.

  • Os tipos de interação não suportados são ignorados.

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

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

  • As colunas Atributo Duplo, Atributo de Cadeia e Tipo de Interação listadas podem ficar vazias por agora.

  • A utilização de "0" como valor dos atributos "Canal" ou "Catálogo" resulta num erro de processamento.

  • No cenário Melhor Ação Seguinte, o atributo Força está limitado a 10 pontos. os valores superiores a 10 são substituídos por 10.

  • Exemplos de quando utilizar a força incluem:

    • Dar prioridade a produtos com uma maior probabilidade de interação (ou seja, visualizados, observados, etc.). Se preferir ter maior prioridade em compras recentes, considere a possibilidade de utilizar a API de Seleções utilizando o Algo-type RecentPurchases, que já dá prioridade às interações mais recentes de um utilizador.
    • As classificações de produtos na escala de 1 a 5 podem ser refletidas definindo a força da transação relevante como a classificação que o utilizador deu ao item.
    • Dar prioridade à duração da visualização de um vídeo dando mais força a visualizações mais longas do que a vídeos de visualizações mais curtas.

Dados de amostra:

Os cabeçalhos aparecem apenas para comodidade e não devem fazer parte dos dados reais.

InteractionGroupingId ItemId ItemVariantId UserId InteractionType Carimbo de Data/Hora Atributo de Cadeia Atributo Duplo Canal Catálogo Força IsPositive
Interação100 Item1 Item1Var1 Transação 2020-04-01T10:00:00.000Z
Interação100 Item2 Transação 2020-04-01T10:00:00.000Z 2.0
Interação101 Item2 Utilizador1 Gostar 2020-05-01T13:25:00.000Z Interação-101-RT Falso
Interação101 Item3 Utilizador2 Classificação 2020-07-12T08:45:00.000Z Europa MySale 4.0 Falso

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

Consulte também

Descrição geral do contrato de dados
Tabela de mapeamento de entidades de dad
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 utilizadores que optaram ativamente por não participar
Entidades de dados de melhoramento de recomendações
Entidades de dados de mapeamento de imagem para item
API do Intelligent Recommendations
Guia de Início Rápido: Configurar e executar o Intelligent Recommendations com dados de amostra