Event

Representa as informações do evento de interação com itens enviadas usando a API PutEvents.

Conteúdos

eventType

O tipo de evento, como clicar ou download. Essa propriedade corresponde ao campo EVENT_TYPE do esquema do conjunto de dados de interações com itens e depende dos tipos de eventos rastreados.

Tipo: string

Restrições de comprimento: comprimento mínimo 1. Tamanho máximo de 256.

Obrigatório: sim

sentAt

O timestamp (no horário do Unix) no lado do cliente quando o evento ocorreu.

Tipo: carimbo de data e hora

Obrigatório: sim

eventId

Um ID associado ao evento. Se um ID de evento não for fornecido, o Amazon Personalize gerará um ID exclusivo para o evento. Um ID de evento não é usado como entrada para o modelo. O Amazon Personalize usa o ID do evento para distinguir eventos exclusivos. Todos os eventos subsequentes após o primeiro com o mesmo ID de evento não são usados no treinamento do modelo.

Tipo: string

Restrições de comprimento: comprimento mínimo 1. Tamanho máximo de 256.

Obrigatório: não

eventValue

O valor do evento que corresponde ao campo EVENT_VALUE do esquema de interações com itens.

Tipo: float

Obrigatório: não

impression

Uma lista de IDs de itens que representa a sequência de itens que você mostrou ao usuário. Por exemplo, ["itemId1", "itemId2", "itemId3"]. Forneça uma lista de itens para registrar manualmente os dados de impressões de um evento. Para obter mais informações sobre como gravar dados de impressões, consulte Gravação de dados de impressões.

Tipo: Matriz de strings

Membros da Matriz: Número mínimo de 1 item. Número máximo de 25 itens.

Restrições de comprimento: comprimento mínimo 1. Tamanho máximo de 256.

Obrigatório: não

itemId

A chave do ID do item que corresponde ao campo ITEM_ID do esquema do conjunto de dados de interações com itens.

Tipo: string

Restrições de comprimento: comprimento mínimo 1. Tamanho máximo de 256.

Obrigatório: não

metricAttribution

Contém informações sobre uma atribuição métrica associada a um evento. Para obter mais informações sobre as atribuições métricas, consulte Como medir o impacto das recomendações.

Tipo: objeto MetricAttribution

Obrigatório: não

properties

Um mapa de strings de dados específicos do evento que você pode optar por registrar. Por exemplo, se um usuário avaliar um filme em seu site, e não o ID do filme (itemId) e da avaliação (eventValue), você também poderá enviar o número de avaliações do filme feitas pelo usuário.

Cada item no mapa consiste em um par de valor de chave. Por exemplo,

{"numberOfRatings": "12"}

As chaves usam nomes em maiúsculas e minúsculas misturadas correspondentes aos campos no esquema do conjunto de dados de interações com itens. No exemplo acima, numberOfRatings corresponde ao campo “NUMBER_OF_RATINGS” definido no esquema do conjunto de dados de interações com itens.

O seguinte não pode ser incluído como uma palavra-chave para propriedades (sem distinção entre maiúsculas e minúsculas).

• userId

• sessionId

• eventType

• timestamp

• recommendationId

• impression

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.

Obrigatório: não

recommendationId

O ID da lista de recomendações que contém o item com o qual o usuário interagiu. Forneça um recommendationId para que o Amazon Personalize registre implicitamente as recomendações que você mostra ao usuário como dados de impressões. Ou forneça uma recommendationId se você usar uma atribuição métrica para medir o impacto das recomendações.

Para obter mais informações sobre como gravar dados de impressões, consulte Gravação de dados de impressões. Para obter mais informações sobre como criar atribuições métricas, consulte Como medir o impacto das recomendações.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 40.

Obrigatório: não

Ver também

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte:

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• AWS SDK para Ruby V3