Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Préparation des métadonnées d'action pour la formation

Une action est une activité génératrice d'engagement ou de revenus que vous souhaiterez peut-être recommander à vos utilisateurs. Les actions peuvent inclure l'installation de votre application mobile, la création d'un profil de membre, l'adhésion à votre programme de fidélité ou l'inscription à des e-mails promotionnels. Vous importez les données relatives à vos actions dans un ensemble de données Amazon Personalize Actions. Les exemples de données relatives à une action incluent l'identifiant unique de l'action, la valeur estimée de l'action ou l'horodatage d'expiration de l'action.

Si vous utilisez Next-Best-Action, vous devez importer les métadonnées des actions. Avec cette recette, Amazon Personalize prédit la meilleure action suivante à partir des actions que vous importez dans votre ensemble de données Actions. Aucune autre recette ou cas d'utilisation n'utilise de métadonnées d'action. Vous ne pouvez pas créer de jeu de données Actions dans un groupe de jeux de données de domaine.

Lors de la formation, Amazon Personalize n'utilise pas de données d'actions de chaîne non catégoriques, telles que les titres ou les tags des actions. Cependant, l'importation de ces données peut toujours améliorer les recommandations. Pour de plus amples informations, veuillez consulter Données de chaîne non catégoriques.

Les données relatives à vos actions groupées doivent se trouver dans un CSV fichier. Chaque ligne du fichier doit représenter une action unique. Une fois que vous avez terminé de préparer vos données, vous êtes prêt à créer un JSON fichier de schéma. Ce fichier indique à Amazon Personalize la structure de vos données. Pour de plus amples informations, veuillez consulter Création de JSON fichiers de schéma pour les schémas Amazon Personalize.

Les sections suivantes fournissent plus d'informations sur la façon de préparer les métadonnées de vos actions pour Amazon Personalize. Pour les directives relatives au format des données en masse pour tous les types de données, consultez les directives relatives au format des données en masse

Exigences relatives aux données d'action

Les données d'action requises pour Amazon Personalize sont les suivantes.

Données d'horodatage d'expiration des actions

L'horodatage d'expiration d'une action indique la date à laquelle une action n'est plus valide. Vous fournissez les données d'horodatage d'expiration des actions au format Unix Epoch Time, en secondes. Si une action a expiré, Amazon Personalize ne l'inclura pas dans les recommandations.

Spécifiez un horodatage d'expiration pour vos actions si vous souhaitez limiter leur apparition dans les recommandations à une certaine période. Par exemple, vous pouvez avoir une application qui lance une campagne d'adhésion pendant un mois donné. Vous pouvez définir un horodatage d'expiration pour l'action d'inscription à la fin du mois en question. Amazon Personalize cesse automatiquement de recommander cette action lorsque cette date est atteinte.

Si vous définissez l'horodatage d'expiration à une date antérieure pour une nouvelle action, ou si vous mettez à jour l'horodatage d'une action à une date antérieure, la suppression de l'action des recommandations peut prendre jusqu'à 2 heures.

Répéter les données de fréquence

Les données de fréquence de répétition indiquent le nombre de jours qu'Amazon Personalize doit attendre pour recommander une action particulière après qu'un utilisateur interagisse avec celle-ci, en fonction de l'historique de l'utilisateur dans votre ensemble de données d'interactions avec les actions. Vous spécifiez la fréquence de répétition d'une action en jours, avec un maximum de 30 jours.

Par exemple, vous pouvez avoir une application de commerce électronique dans laquelle chaque utilisateur crée un compte et un profil. Si vous avez une complete profile action et que vous souhaitez attendre une semaine après qu'un utilisateur interagisse avec elle avant de la recommander à nouveau, vous devez spécifier une durée de 7 jours pour l'action. REPEAT_FREQENCY Au bout de 7 jours, Amazon Personalize commence à envisager les mesures à prendre pour obtenir des recommandations.

Si vous ne fournissez pas de fréquence de répétition pour une action, Amazon Personalize ne fixera aucune limite quant au nombre de fois qu'elle apparaît dans les recommandations.

Données de valeur

Les données de valeur sont la valeur commerciale ou l'importance de chaque action. Une action value peut être comprise entre 1 et 10, 10 étant l'action la plus précieuse de votre ensemble de données.

Par exemple, vous pouvez avoir deux actions, l'une pour vous inscrire à votre abonnement de base et l'autre pour vous inscrire à votre service premium. Pour le service de base, vous pouvez spécifier une valeur de 5 et pour la prime, une valeur de10.

Amazon Personalize utilise les données de valeur comme entrée pour déterminer la meilleure action à recommander à vos utilisateurs. Par exemple, si un utilisateur est également susceptible d'effectuer une action ou une autre, Amazon Personalize classe l'action ayant la valeur la plus élevée dans les recommandations.

Données d'horodatage de création

Amazon Personalize utilise les données d'horodatage de création (au format Unix Epoch, en secondes) pour calculer l'âge d'une action et ajuster les recommandations en conséquence.

Si vous ne disposez pas de données d'horodatage de création, Amazon Personalize déduit ces informations à partir de toutes les données d'interaction entre actions. Il utilise l'horodatage des données d'interaction les plus anciennes de l'action comme horodatage de création de l'action. Si une action ne contient aucune donnée d'interaction, son horodatage de création est défini comme l'horodatage de la dernière interaction du set d'entraînement, et Amazon Personalize considère qu'il s'agit d'une nouvelle action.

Métadonnées catégoriques

Amazon Personalize utilise des métadonnées catégoriques concernant les actions, telles que le caractère saisonnier ou l'exclusivité des actions, pour identifier les modèles sous-jacents qui révèlent les meilleures actions pour vos utilisateurs. Vous définissez votre propre plage de valeurs en fonction de votre cas d'utilisation. Les métadonnées catégorielles peuvent être rédigées dans n'importe quelle langue.

Vous pouvez importer des données catégorielles et les utiliser pour filtrer les recommandations en fonction des attributs d'une action. Pour plus d'informations sur les recommandations de filtrage, consultezRecommandations de filtrage et segments d'utilisateurs.

Les valeurs catégorielles peuvent comporter un maximum de 1 000 caractères. Si vous avez une action avec une valeur catégorique de plus de 1 000 caractères, votre tâche d'importation de jeu de données échouera.

Données de chaîne non catégoriques

À l'exception de l'actionIDs, Amazon Personalize n'utilise pas de données de chaîne non catégoriques lors de l'entraînement, telles que le nom d'une action, les mots clés relatifs à l'action ou les balises. Amazon Personalize peut toutefois l'utiliser pour filtrer les recommandations. Vous pouvez créer des filtres pour inclure ou supprimer des actions dans les recommandations sur la base de données de chaîne non catégoriques. Pour plus d'informations sur les filtres, consultez Recommandations de filtrage et segments d'utilisateurs. Les valeurs non catégoriques peuvent comporter un maximum de 1 000 caractères.

Exemple de métadonnées d'actions

Les métadonnées des premières lignes d'action d'un CSV fichier peuvent ressembler à ce qui suit.

ACTION_ID,VALUE,MEMBERSHIP_LEVEL,CREATION_TIMESTAMP,REPEAT_FREQUENCY
1,10,Deluxe|Premium,1510003267,7
2,5,Basic,1580003267,7
3,5,Preview,1590003267,3
4,10,Deluxe|Platinum,1560003267,4
...
...

La colonne ACTION_ID est obligatoire. La MEMBERSHIP_LEVEL colonne est un champ de chaîne catégorique. Les REPEAT_FREQUENCY champs VALUECREATION_TIMESTAMP, et sont des mots clés réservés avec les types requis.

Une fois que vous avez terminé de préparer vos données, vous êtes prêt à créer un JSON fichier de schéma. Ce fichier indique à Amazon Personalize la structure de vos données. Pour de plus amples informations, veuillez consulter Création de JSON fichiers de schéma pour les schémas Amazon Personalize. Voici à quoi ressemblerait le JSON fichier de schéma pour les exemples de données ci-dessus.

{
  "type": "record",
  "name": "Actions",
  "namespace": "com.amazonaws.personalize.schema",
  "fields": [
    {
      "name": "ACTION_ID",
      "type": "string"
    },
    {
      "name": "VALUE",
      "type": [
        "null",
        "long"
      ]
    },
    
    {
      "name": "MEMBERSHIP_LEVEL",
      "type": [
        "null",
        "string"
      ],
      "categorical": true
    },
    
    {
      "name": "CREATION_TIMESTAMP",
      "type": "long"
    },
    {
      "name": "REPEAT_FREQUENCY",
      "type": [
        "long",
        "null"
      ]
    }
  ],
  "version": "1.0"
}