Diretrizes e requisitos para uma atribuição de métrica
O Amazon Personalize começa a calcular e relatar o impacto das recomendações somente depois que você cria uma atribuição métrica. Para criar o histórico mais completo, recomendamos criar uma atribuição métrica antes de importar seus dados de interações. Ao criar um trabalho de importação do conjunto de dados de interações com itens usando o console do Amazon Personalize, há a opção de criar uma atribuição de métrica em uma nova guia. Em seguida, você pode retornar ao trabalho de importação para concluí-lo.
Depois de criar uma atribuição de métrica e registrar eventos ou importar dados incrementais em lote, você incorrerá em alguns custos mensais do CloudWatch por métrica. Para obter informações sobre a definição de preço do CloudWatch, consulte a página Definição de preço do Amazon CloudWatch
Para ver o impacto das recomendações ao longo do tempo, continue importando dados à medida que os clientes interagem com as recomendações. Se você já importou dados, ainda pode criar uma atribuição métrica e começar a medir o impacto das recomendações. No entanto, o Amazon Personalize não reportará dados que você importou antes de criá-los.
Veja a seguir as diretrizes e os requisitos para gerar relatórios com uma atribuição métrica:
-
Você deve conceder permissão ao Amazon Personalize para acessar e colocar dados no CloudWatch. Para obter exemplos de políticas, consulte Conceder acesso ao Amazon Personalize ao CloudWatch.
-
Para publicar métricas no Amazon S3, dê permissão ao Amazon Personalize para gravar em seu bucket. Você também deve fornecer o caminho do bucket em sua atribuição métrica. Para obter exemplos de políticas, consulte Conceder ao Amazon Personalize acesso ao bucket do Amazon S3.
-
Para publicar métricas no CloudWatch, os registros devem ter menos de 14 dias. Se seus dados forem mais antigos, esses registros não serão incluídos em cálculos ou relatórios.
-
A importação de eventos duplicados (eventos que correspondem exatamente a todos os atributos) pode levar a um comportamento inesperado, incluindo métricas imprecisas. Recomendamos que você remova registros duplicados de todos os dados em massa antes da importação e evite importar eventos duplicados com a operação
PutEvents. -
O conjunto de dados de interações com itens deve ter uma coluna
EVENT_TYPE. -
Não é possível criar relatórios de métricas para dados em um conjunto de dados de interações com ações.
-
Você pode criar no máximo uma atribuição métrica por grupo de conjuntos de dados. Cada atribuição de métrica pode ter no máximo 10 métricas.
Para comparar fontes, cada evento de interação deve incluir um recommendationId ou um eventAttributionSource. Você pode importar no máximo 100 fontes de atribuição de eventos exclusivas. Para obter exemplos de código do PutEvents, consulte Métricas de eventos e relatórios de atribuição.
-
Se você fornecer um
recommendationId, o Amazon Personalize determinará automaticamente a campanha ou o recomendador de origem e os identificará nos relatórios em uma coluna EVENT_ATTRIBUTION_SOURCE. -
Se você fornecer os dois atributos, o Amazon Personalize usará somente o
eventAttributionSource. -
Se você não fornecer uma fonte, o Amazon Personalize rotula a fonte
SOURCE_NAME_UNDEFINEDnos relatórios.
Tópicos
Conceder acesso ao Amazon Personalize ao CloudWatch
Importante
Quando você concede permissões, o Amazon Personalize coloca e valida uma pequena quantidade de dados no CloudWatch. Isso acarretará um custo único de menos de US$ 0,30. Para obter mais informações sobre a definição de preço do CloudWatch, consulte a página Definição de preço do Amazon CloudWatch
Para dar acesso ao Amazon Personalize ao CloudWatch, anexe uma nova política do IAM (AWS Identity and Access Management) ao seu perfil de serviço Amazon Personalize que conceda à função permissão para usar a ação PutMetricData para o CloudWatch. O exemplo de política a seguir concede permissões PutMetricData.
Conceder ao Amazon Personalize acesso ao bucket do Amazon S3
Conceder ao Amazon Personalize acesso ao bucket do Amazon S3:
-
Anexe uma política do IAM ao seu perfil de serviço Amazon Personalize que conceda à função permissão para usar a ação
PutObjectem seu bucket. -
Anexe uma política de bucket ao seu bucket do Amazon S3 que conceda a permissão do princípio do Amazon Personalize para usar as ações
PutObject.Se você usa o AWS Key Management Service (AWS KMS) para criptografia, conceda permissão ao Amazon Personalize e ao seu perfil de serviço de IAM do Amazon Personalize para usar sua chave. Para obter mais informações, consulte Como conceder permissão ao Amazon Personalize para usar sua chave AWS KMS.
