As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Conjuntos de dados e esquemas VIDEO\$1ON\$1DEMAND Quando você cria um grupo de conjuntos de dados de domínio para o domínio VIDEO\$1ON\$1DEMAND, cada tipo de conjunto de dados tem um esquema padrão com um conjunto de campos específicos VIDEO\$1ON\$1DEMAND obrigatórios e recomendados. Você pode usar o esquema padrão ou criar um novo com base no esquema padrão. Os dados que você importa devem corresponder ao seu esquema em formato e tipo. Use os esquemas de domínio padrão listados nas seções abaixo como guia para determinar quais dados importar para criar seu recomendador baseado em VIDEO\$1ON\$1DEMAND. Você pode adicionar outros campos. Desde que os campos não estejam listados como obrigatórios ou reservados e os tipos de dados estejam listados em [Tipos de dados do esquema](how-it-works-dataset-schema.md#personalize-datatypes), é você quem escolhe os nomes e tipos de dados dos campos. Para obter informações sobre os requisitos gerais de esquema do Amazon Personalize, como requisitos de formatação e tipos de dados de campo disponíveis, consulte [Criar arquivos JSON de esquema para esquemas do Amazon Personalize](how-it-works-dataset-schema.md). Esses requisitos aplicam-se a todos os esquemas, independentemente do domínio. Os tópicos a seguir fornecem informações sobre os campos obrigatórios e recomendados de cada conjunto de dados para o domínio VIDEO\$1ON\$1DEMAND. Cada seção do conjunto de dados inclui o esquema VIDEO\$1ON\$1DEMAND padrão no formato JSON. **Topics** + [Requisitos de esquema e conjunto de dados do domínio VIDEO\$1ON\$1DEMAND](#VIDEO-ON-DEMAND-dataset-requirements) + [Requisitos do conjunto de dados de interações com itens (domínio VIDEO\$1ON\$1DEMAND)](VIDEO-ON-DEMAND-interactions-dataset.md) + [Requisitos do conjunto de dados de usuários (domínio VIDEO\$1ON\$1DEMAND)](VIDEO-ON-DEMAND-users-dataset.md) + [Requisitos do conjunto de dados de itens (domínio VIDEO\$1ON\$1DEMAND)](VIDEO-ON-DEMAND-items-dataset.md) ## Requisitos de esquema e conjunto de dados do domínio VIDEO\$1ON\$1DEMAND Cada tipo de conjunto de dados tem um conjunto de campos obrigatórios e palavras-chave reservadas. As palavras-chave reservadas são campos opcionais e não de metadados. Esses campos são considerados reservados porque você precisa definir os campos como seu tipo de dados necessário ao usá-los. Os campos de string de caracteres categóricos reservados devem ter `categorical` definido como `true`, enquanto os campos de string de caracteres reservados não podem ser categóricos. As palavras-chave não podem estar nos seus dados. | Tipo de conjunto de dados | Campos obrigatórios | Palavras-chave reservadas | | --- | --- | --- | | Interações com itens ([esquema padrão](VIDEO-ON-DEMAND-interactions-dataset.md#VIDEO-ON-DEMAND-interactions-schema)) | USER\$1ID (`string`) ITEM\$1ID (`string`) TIMESTAMP (`long`) EVENT\$1TYPE (`string` e dependendo do [caso de uso](domain-use-cases.md) e dos tipos de eventos `Watch` e `Click`) | EVENT\$1VALUE (`float`, `null`) IMPRESSION (`string`, `null`) RECOMMENDATION\$1ID (`string`, `null`) EVENT\$1ATTRIBUTION\$1SOURCE (`string`, `null`) | | Usuários ([esquema padrão](VIDEO-ON-DEMAND-users-dataset.md#VIDEO-ON-DEMAND-users-dataset-schema)) | USER\$1ID (`string`) 1 campo de metadados (`string` categórico ou numérico) | SUBSCRIPTION\$1MODEL (`string` categórico, `null`) | | Itens ([esquema padrão](VIDEO-ON-DEMAND-items-dataset.md#VIDEO-ON-DEMAND-items-dataset-schema)) | ITEM\$1ID (`string`) CREATION\$1TIMESTAMP (`long`) GENRES (`string` categóricos) | PRICE (`float`, `null`) DURATION (`float`, `null`) GENRE\$1L2 (`string` categórico, `null`) GENRE\$1L3 (`string` categórico, `null`) AVERAGE\$1RATING (`float`, `null`) PRODUCT\$1DESCRIPTION (`string` textual, `null`) CONTENT\$1OWNER (`string` categórico, `null`) CONTENT\$1CLASSIFICATION (`string` categórico, `null`) | # Requisitos do conjunto de dados de interações com itens (domínio VIDEO\$1ON\$1DEMAND) Um *conjunto de dados de interações com itens* armazena dados históricos e em tempo real das interações entre usuários e itens do catálogo VIDEO\$1ON\$1DEMAND. Para obter mais informações sobre os tipos de dados que você pode armazenar em um conjunto de dados de interações, consulte [Dados de interações com itens](interactions-datasets.md). É necessário ter um conjunto de dados de interações com itens para todos os casos de uso, e o esquema deve ter os seguintes campos: + USER\$1ID (`string`) + ITEM\$1ID `string` + TIMESTAMP (`long`) + EVENT\$1TYPE (`string` e dependendo do [caso de uso](domain-use-cases.md) e dos tipos de eventos `Watch` e `Click`) Seu esquema também pode incluir as seguintes palavras-chave reservadas: + EVENT\$1VALUE (`float`, `null`) + IMPRESSION (`string`, `null`) + RECOMMENDATION\$1ID (`string`, `null`) Você pode adicionar outros campos, dependendo do seu caso de uso e dos seus dados. Desde que os campos não estejam listados como obrigatórios ou reservados e os tipos de dados estejam listados em [Tipos de dados do esquema](how-it-works-dataset-schema.md#personalize-datatypes), é você quem escolhe os nomes e tipos de dados dos campos. Para obter um exemplo do esquema padrão para conjuntos de dados de interações com itens para domínios VIDEO\$1ON\$1DEMAND, consulte [Esquema de interações padrão (domínio VIDEO\$1ON\$1DEMAND)](#VIDEO-ON-DEMAND-interactions-schema). Opcionalmente, adicione a palavra-chave reservada EVENT\$1VALUE se você tiver dados de valor para eventos, como a porcentagem assistida de um vídeo. Opcionalmente, adicione a palavra-chave reservada IMPRESSION se quiser incluir dados de impressões explícitas e implícitas. Para obter mais informações sobre como gravar dados de impressão, consulte [Dados de impressões](interactions-datasets.md#interactions-impressions-data). O número total máximo de campos de metadados opcionais que podem ser adicionados a um conjunto de dados de interações com itens, combinado com o número total de tipos de eventos *distintos* nos dados de interações com itens, é dez. Os campos de metadados incluídos nessa contagem são os campos EVENT\$1TYPE, EVENT\$1VALUE junto com quaisquer campos de metadados personalizados que você adicionar ao seu esquema. O número máximo de campos de metadados excluindo campos reservados, como IMPRESSION, é 5. Os valores categóricos podem ter no máximo 1.000 caracteres. Se você tiver uma interação com um valor categórico acima de mil, sua tarefa de importação do conjunto de dados falhará. Para obter mais informações sobre requisitos mínimos e limites máximos de dados para um conjunto de dados de interações com itens para o domínio VIDEO\$1ON\$1DEMAND, consulte [Cotas de serviço](limits.md#limits-table). Para obter informações sobre os requisitos gerais de esquema do Amazon Personalize, como requisitos de formatação e tipos de dados de campo disponíveis, consulte [Criar arquivos JSON de esquema para esquemas do Amazon Personalize](how-it-works-dataset-schema.md). Esses requisitos aplicam-se a todos os esquemas, independentemente do domínio. ## Esquema de interações padrão (domínio VIDEO\$1ON\$1DEMAND) Veja a seguir o esquema de domínio VIDEO\$1ON\$1DEMAND padrão para conjuntos de dados de interações com itens. ``` { "type": "record", "name": "Interactions", "namespace": "com.amazonaws.personalize.schema", "fields": [ { "name": "USER_ID", "type": "string" }, { "name": "ITEM_ID", "type": "string" }, { "name": "EVENT_TYPE", "type": "string" }, { "name": "TIMESTAMP", "type": "long" } ], "version": "1.0" } ``` # Requisitos do conjunto de dados de usuários (domínio VIDEO\$1ON\$1DEMAND) Um *conjunto de dados de usuários* armazena metadados sobre seus usuários. Isso pode incluir informações como idade, interesse, gênero e associação de fidelidade para cada item. Para obter informações sobre os tipos de dados de usuário que você pode importar para o Amazon Personalize, consulte [Metadados do usuário](users-datasets.md). Para obter informações sobre os requisitos de esquema do Amazon Personalize, consulte [Criar arquivos JSON de esquema para esquemas do Amazon Personalize](how-it-works-dataset-schema.md). Esses requisitos aplicam-se a todos os esquemas, independentemente do domínio. Um conjunto de dados de usuários é opcional para todos os casos de uso do VIDEO\$1ON\$1DEMAND. Se você tiver dados de usuário, recomendamos criar um conjunto de dados de usuários para obter as recomendações mais relevantes. Se você criar um conjunto de dados de usuários, seu esquema deverá incluir os seguintes campos. + USER\$1ID + 1 campo de metadados (`string` categórico ou numérico) Você pode adicionar outros campos, dependendo do seu caso de uso e dos seus dados. Desde que os campos não estejam listados como obrigatórios ou reservados e os tipos de dados estejam listados em [Tipos de dados do esquema](how-it-works-dataset-schema.md#personalize-datatypes), é você quem escolhe os nomes e tipos de dados dos campos. Para obter um exemplo do esquema padrão para conjuntos de dados de usuários para domínios VIDEO\$1ON\$1DEMAND, consulte [Esquema de usuários padrão (domínio VIDEO\$1ON\$1DEMAND)](#VIDEO-ON-DEMAND-users-dataset-schema). Um campo `SUBSCRIPTION_MODEL` está incluído no esquema padrão. Esse campo é uma palavra-chave reservada opcional e deve ter um tipo `string` com categórico definido como `true`. Para obter as recomendações melhores, recomendamos que você mantenha esse campo em seu esquema se tiver informações do modelo de assinatura sobre cada um dos seus usuários em seus dados. Os dados que você importa devem corresponder ao seu esquema. ## Usar dados categóricos Para usar dados categóricos, adicione um campo do tipo `string` e defina o atributo categórico do campo como `true` em seu esquema. Em seguida, inclua os dados categóricos no arquivo CSV em massa e nas importações de registros individuais. Para usuários com várias categorias, separe cada valor usando a barra vertical '\$1'. Por exemplo, para um campo SUBSCRIPTION\$1MODEL, seus dados de um usuário podem ser estudante\$1mensal\$1desconto. Os valores categóricos podem ter no máximo 1.000 caracteres. Se você tiver um usuário com um valor categórico com mais de 1.000 caracteres, sua tarefa de importação do conjunto de dados falhará. ## Esquema de usuários padrão (domínio VIDEO\$1ON\$1DEMAND) Veja a seguir o esquema de domínio VIDEO\$1ON\$1DEMAND padrão para conjuntos de dados de usuários. ``` { "type": "record", "name": "Users", "namespace": "com.amazonaws.personalize.schema", "fields": [ { "name": "USER_ID", "type": "string" }, { "name": "SUBSCRIPTION_MODEL", "type": "string", "categorical": true } ], "version": "1.0" } ``` # Requisitos do conjunto de dados de itens (domínio VIDEO\$1ON\$1DEMAND) Um *conjunto de dados de itens* armazena metadados sobre os itens do seu catálogo. Isso pode incluir informações como preço, gênero e disponibilidade para cada item. Para obter informações sobre os tipos de dados de item que você pode importar para o Amazon Personalize, consulte [Metadados de itens](items-datasets.md). Para obter informações sobre os requisitos gerais de esquema do Amazon Personalize, como requisitos de formatação e tipos de dados de campo disponíveis, consulte [Criar arquivos JSON de esquema para esquemas do Amazon Personalize](how-it-works-dataset-schema.md). Esses requisitos aplicam-se a todos os esquemas, independentemente do domínio. Um conjunto de dados de itens é necessário para alguns casos de uso (consulte [Casos de uso VIDEO\$1ON\$1DEMAND](VIDEO_ON_DEMAND-use-cases.md)). Mesmo quando opcional, ainda recomendamos criar um conjunto de dados de itens para obter as recomendações mais relevantes. Se você criar um conjunto de dados de itens, seu esquema deverá incluir os seguintes campos: + ITEM\$1ID + GENRES (`string` categóricos) + CREATION\$1TIMESTAMP (no formato de hora Unix epoch) Seu esquema também pode incluir as seguintes palavras-chave reservadas. Cada palavra-chave lista o tipo de dados necessário e se ela permite dados nulos. Adicionar o tipo nulo é opcional. + PRICE (float) + DURATION (float) + GENRE\$1L2 (`string` categórico, `null`) + GENRE\$1L3 (`string` categórico, `null`) + AVERAGE\$1RATING (`float`, `null`) + PRODUCT\$1DESCRIPTION (`string` textual, `null`) + CONTENT\$1OWNER (`string` categórico,`null`): a empresa proprietária do vídeo. Por exemplo, os valores podem ser HBO, Paramount e NBC. + CONTENT\$1CLASSIFICATION (`string` categórico, `null`): a classificação do conteúdo. Por exemplo, os valores podem ser G, PG, PG-13, R, NC-17 e sem classificação. Para obter as recomendações melhores, recomendamos que você mantenha uma quantidade desses campos em seu esquema equivalente aos dados que você tiver. Os dados que você importa devem corresponder ao seu esquema. O número máximo de colunas de metadados é 100. Você pode adicionar outros campos, dependendo do seu caso de uso e dos seus dados. Desde que os campos não estejam listados como obrigatórios ou reservados e os tipos de dados estejam listados em [Tipos de dados do esquema](how-it-works-dataset-schema.md#personalize-datatypes), é você quem escolhe os nomes e tipos de dados dos campos. Use as palavras-chave reservadas GENRE\$1L2 e GENRE\$1L3 para itens com várias categorias de vários níveis. Para obter mais informações, consulte [Usar dados categóricos](#VIDEO-ON-DEMAND-items-categorical-data). Para obter informações sobre metadados textuais e categóricos, consulte [Preparar metadados do item para treinamento](items-datasets.md). Para obter um exemplo do esquema padrão para conjuntos de dados de itens para domínios ECOMMERCE, consulte [Esquema de itens padrão (domínio VIDEO\$1ON\$1DEMAND)](#VIDEO-ON-DEMAND-items-dataset-schema). ## Usar dados categóricos Para usar dados categóricos, adicione um campo do tipo `string` e defina o atributo categórico do campo como `true` em seu esquema. Em seguida, inclua os dados categóricos no arquivo CSV em massa e nas importações de itens individuais. Os valores categóricos podem ter no máximo 1.000 caracteres. Se você tiver um item com um valor categórico com mais de 1.000 caracteres, sua tarefa de importação do conjunto de dados falhará. Para itens com várias categorias, separe cada valor com a barra vertical '\$1'. Por exemplo, para um campo GENRES, seus dados de um item podem ser `Action|Crime|Biopic`. Se você tiver vários níveis de dados categóricos e alguns itens tiverem várias categorias para cada nível na hierarquia, adicione um campo para cada nível e acrescente um indicador de nível após cada nome de campo: GENRES, GENRE\$1L2, GENRE\$1L3. Isso permite filtrar recomendações com base em subcategorias, mesmo que um item pertença a várias categorias de vários níveis. Por exemplo, um vídeo pode ter os seguintes dados para cada nível de categoria: + GENRES: Ação\$1Aventura + GENRE\$1L2: Crime\$1Faroeste + GENRE\$1L3: biografia Neste exemplo, o vídeo está na hierarquia ação > crime > biografia *e* na hierarquia aventura > faroeste > biografia. Recomendamos usar apenas até L3, mas você pode usar mais níveis, se necessário. Para mais informações sobre como criar e usar filtros, consulte [Como filtrar recomendações e segmentos de usuários](filter.md). ## Esquema de itens padrão (domínio VIDEO\$1ON\$1DEMAND) Veja a seguir o esquema padrão para conjuntos de dados de itens para o domínio VIDEO\$1ON\$1DEMAND. ``` { "type": "record", "name": "Items", "namespace": "com.amazonaws.personalize.schema", "fields": [ { "name": "ITEM_ID", "type": "string" }, { "name": "GENRES", "type": [ "string" ], "categorical": true }, { "name": "CREATION_TIMESTAMP", "type": "long" } ], "version": "1.0" } ```