Directives et exigences relatives à l'attribution d'une métrique

Amazon Personalize ne commence à calculer et à signaler l'impact des recommandations qu'une fois que vous avez créé une attribution métrique. Pour créer l'historique le plus complet possible, nous vous recommandons de créer une attribution métrique avant d'importer vos données d'interactions. Lorsque vous créez une tâche d'importation d'un ensemble de données pour un ensemble de données d'interactions entre articles à l'aide de la console Amazon Personalize, vous avez la possibilité de créer une attribution de métrique dans un nouvel onglet. Vous pouvez ensuite retourner à la tâche d'importation pour la terminer.

Une fois que vous avez créé une attribution de métrique et enregistré des événements ou importé des données en masse incrémentielles, vous devrez payer un certain CloudWatch coût mensuel par métrique. Pour plus d'informations sur CloudWatch les tarifs, consultez la page de CloudWatch tarification d'Amazon. Pour arrêter d'envoyer des métriques à CloudWatch, supprimez l'attribution des métriques.

Pour évaluer l'impact des recommandations au fil du temps, continuez à importer des données au fur et à mesure que les clients interagissent avec les recommandations. Si vous avez déjà importé des données, vous pouvez toujours créer une attribution métrique et commencer à mesurer l'impact des recommandations. Toutefois, Amazon Personalize ne signalera pas les données que vous avez importées avant de les créer.

Les directives et les exigences relatives à la génération de rapports avec une attribution métrique sont les suivantes :

• Vous devez autoriser Amazon Personalize à accéder aux données et à les saisir CloudWatch. Pour obtenir des exemples de stratégie, consultez Donner à Amazon Personalize l'accès à CloudWatch.

• Pour publier des métriques sur Amazon S3, autorisez Amazon Personalize à écrire dans votre compartiment. Vous devez également indiquer le chemin du compartiment dans votre attribution de métriques. Pour obtenir des exemples de stratégie, consultez Permettre à Amazon Personalize d'accéder à votre compartiment Amazon S3.

• Pour publier des statistiques sur CloudWatch, les enregistrements doivent dater de moins de 14 jours. Si vos données sont anciennes, ces enregistrements ne seront pas inclus dans les calculs ou les rapports.

• L'importation d'événements dupliqués (événements correspondant exactement à tous les attributs) peut entraîner des comportements inattendus, notamment des indicateurs inexacts. Nous vous recommandons de supprimer les enregistrements dupliqués de toutes les données en bloc avant l'importation, et d'éviter d'importer des événements dupliqués lors de l'PutEventsopération.

• Votre jeu de données sur les interactions entre objets doit comporter une EVENT_TYPE colonne.

• Vous ne pouvez pas créer de rapports métriques pour les données d'un jeu de données d'interactions Action.

• Vous pouvez créer au maximum une attribution de mesures par groupe de jeux de données. Chaque attribution de métrique peut comporter au maximum 10 métriques.

Pour comparer les sources, chaque événement d'interaction doit inclure un recommendationId oueventAttributionSource. Vous pouvez fournir au maximum 100 sources d'attribution d'événements uniques. Pour obtenir des exemples de code PutEvents, consultez Statistiques relatives aux événements et rapports d'attribution.

• Si vous fournissez unrecommendationId, Amazon Personalize détermine automatiquement la campagne ou le recommandateur source et l'identifie dans les rapports d'une colonne EVENT_ATTRIBUTION_SOURCE.

• Si vous fournissez les deux attributs, Amazon Personalize utilise uniquement leeventAttributionSource.

• Si vous ne fournissez pas de source, Amazon Personalize l'étiquette SOURCE_NAME_UNDEFINED dans les rapports.

Donner à Amazon Personalize l'accès à CloudWatch

Important

Lorsque vous accordez des autorisations, Amazon Personalize place et valide une petite quantité de données. CloudWatch Cela entraînera un coût unique de moins de 0,30$. Pour plus d'informations sur CloudWatch les tarifs, consultez la page de CloudWatch tarification d'Amazon.

Pour donner accès à Amazon Personalize CloudWatch, associez une nouvelle politique AWS Identity and Access Management (IAM) à votre rôle de service Amazon Personalize qui accorde au rôle l'autorisation d'utiliser l'PutMetricDataaction pour CloudWatch. L'exemple de politique suivant octroie PutMetricData des autorisations.

JSON

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cloudwatch:PutMetricData"
      ],
      "Resource": "*"
    }
  ]
}

Permettre à Amazon Personalize d'accéder à votre compartiment Amazon S3

Pour autoriser Amazon Personalize à accéder à votre compartiment Amazon S3, procédez comme suit :

• Associez une politique IAM à votre rôle de service Amazon Personalize qui accorde au rôle l'autorisation d'utiliser l'PutObjectaction sur votre compartiment.

  JSON

  {
      "Version": "2012-10-17",
      "Id": "PersonalizeS3BucketAccessPolicy",
      "Statement": [
          {
              "Sid": "PersonalizeS3BucketAccessPolicy",
              "Effect": "Allow",
              "Action": [
                  "s3:PutObject"
              ],
              "Resource": [
                  "arn:aws:s3:::amzn-s3-demo-bucket",
                  "arn:aws:s3:::amzn-s3-demo-bucket/*"
              ]
          }
      ]
  }
  

• Attachez une politique de compartiment à votre compartiment Amazon S3 de sortie qui accorde au principe Amazon Personalize l'autorisation d'utiliser les PutObject actions.

  Si vous utilisez AWS Key Management Service (AWS KMS) pour le chiffrement, vous devez autoriser Amazon Personalize et votre rôle de service Amazon Personalize IAM à utiliser votre clé. Pour de plus amples informations, veuillez consulter Autoriser Amazon Personalize à utiliser votre AWS KMS clé.

  JSON

  {
      "Version": "2012-10-17",
      "Id": "PersonalizeS3BucketAccessPolicy",
      "Statement": [
          {
              "Sid": "PersonalizeS3BucketAccessPolicy",
              "Effect": "Allow",
              "Principal": {
                  "Service": "personalize.amazonaws.com"
              },
              "Action": [
                  "s3:PutObject"
              ],
              "Resource": [
                  "arn:aws:s3:::amzn-s3-demo-bucket",
                  "arn:aws:s3:::amzn-s3-demo-bucket/*"
              ]
          }
      ]
  }