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