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.

Importer des utilisateurs individuellement

Une fois que vous Création d'un schéma et d'un jeu de données avez créé un jeu de données Utilisateurs, vous pouvez importer individuellement un ou plusieurs nouveaux utilisateurs dans le jeu de données. L'importation individuelle d'utilisateurs vous permet de maintenir votre jeu de données Utilisateurs à jour grâce à des importations par petits lots à mesure que votre catalogue s'agrandit. Vous pouvez importer jusqu'à 10 utilisateurs à la fois. Si vous avez un grand nombre de nouveaux utilisateurs, nous vous recommandons d'importer d'abord les données en masse, puis d'importer les données utilisateur individuellement si nécessaire. Consultez Importation de données en masse dans Amazon Personalize à l'aide d'une tâche d'importation de jeux de données.

Vous pouvez utiliser la console Amazon Personalize, AWS Command Line Interface (AWS CLI), ou AWS SDKspour importer des utilisateurs. Si vous importez un utilisateur userId identique à un utilisateur figurant déjà dans votre ensemble de données Utilisateurs, Amazon Personalize le remplace par le nouveau. Vous pouvez importer jusqu'à 10 utilisateurs à la fois.

Pour plus d'informations sur la manière dont Amazon Personalize met à jour les filtres pour les nouveaux enregistrements et sur la manière dont les nouveaux enregistrements influencent les recommandations, consultezImportation d'enregistrements individuels.

Importer des utilisateurs individuellement (console)

Vous pouvez importer jusqu'à 10 utilisateurs à la fois. Cette procédure suppose que vous avez déjà créé un jeu de données Users. Pour plus d'informations sur la création de jeux de données, consultezCréation d'un schéma et d'un jeu de données.

Importer des utilisateurs individuellement (AWS CLI)

Ajoutez un ou plusieurs utilisateurs à votre jeu de données Users avec l'PutUsersopération. Vous pouvez importer jusqu'à 10 utilisateurs en un seul PutUsers appel. Cette section part du principe que vous avez déjà créé un ensemble de données Utilisateurs. Pour plus d'informations sur la création de jeux de données, consultezCréation d'un schéma et d'un jeu de données.

Utilisez la put-users commande suivante pour ajouter un ou plusieurs utilisateurs avec AWS CLI. dataset arnRemplacez-le par le nom de ressource Amazon (ARN) de votre ensemble de données et user Id par l'ID de l'utilisateur. Si un utilisateur correspondant userId figure déjà dans votre ensemble de données Users, Amazon Personalize le remplace par le nouveau.

En properties effet, pour chaque champ de votre jeu de données Utilisateurs, remplacez le propertyName par le nom du champ de votre schéma en cas de chameau. Par exemple, GENDER serait gender et MEMBERSHIP _ TYPE seraitmembershipType. Remplacez user data par les données de l'utilisateur. Pour les données de chaîne catégorielles, afin d'inclure plusieurs catégories pour une seule propriété, séparez chaque catégorie par un tube (|). Par exemple, \"Premium Class|Legacy Member\".

aws personalize-events put-users \
  --dataset-arn dataset arn \
  --users '[{
      "userId": "user Id", 
      "properties": "{\"propertyName\": "\user data\"}" 
    }, 
    {
      "userId": "user Id", 
      "properties": "{\"propertyName\": "\user data\"}" 
    }]'

Importer des utilisateurs individuellement (AWS SDKs)

Ajoutez un ou plusieurs utilisateurs à votre jeu de données Users avec l'PutUsersopération. Si un utilisateur correspondant userId figure déjà dans votre ensemble de données Users, Amazon Personalize le remplace par le nouveau. Vous pouvez importer jusqu'à 10 utilisateurs en un seul PutUsers appel. Cette section part du principe que vous avez déjà créé un ensemble de données Utilisateurs. Pour plus d'informations sur la création de jeux de données, consultezCréation d'un schéma et d'un jeu de données.

Le code suivant montre comment ajouter un ou plusieurs utilisateurs à votre jeu de données Utilisateurs. Pour chaque paramètre de nom de propriété, transmettez le nom du champ de votre schéma en cas de chameau. Par exemple, GENDER serait gender et MEMBERSHIP _ TYPE seraitmembershipType. Pour chaque paramètre de valeur de propriété, transmettez les données à l'utilisateur.

Pour les données de chaîne catégorielles, pour inclure plusieurs catégories pour une seule propriété, séparez chaque catégorie par un tube (|). Par exemple, "Premium class|Legacy Member".

SDK for Python (Boto3)

import boto3

personalize_events = boto3.client(service_name='personalize-events')

personalize_events.put_users(
    datasetArn = 'dataset arn',
    users = [{
      'userId': 'user ID',
      'properties': "{\"propertyName\": \"user data\"}"   
      },
      {
      'userId': 'user ID',
      'properties': "{\"propertyName\": \"user data\"}"   
      }]
)

SDK for Java 2.x

public static int putUsers(PersonalizeEventsClient personalizeEventsClient,
                         String datasetArn,
                         String user1Id,
                         String user1PropertyName,
                         String user1PropertyValue,
                         String user2Id,
                         String user2PropertyName,
                         String user2PropertyValue) {

    int responseCode = 0;
    ArrayList<User> users = new ArrayList<>();

    try {
        User user1 = User.builder()
          .userId(user1Id)
          .properties(String.format("{\"%1$s\": \"%2$s\"}", user1PropertyName, user1PropertyValue))
          .build();

        users.add(user1);

        User user2 = User.builder()
          .userId(user2Id)
          .properties(String.format("{\"%1$s\": \"%2$s\"}", user2PropertyName, user2PropertyValue))
          .build();

        users.add(user2);

        PutUsersRequest putUsersRequest = PutUsersRequest.builder()
          .datasetArn(datasetArn)
          .build();

        responseCode = personalizeEventsClient.putUsers(putUsersRequest).sdkHttpResponse().statusCode();
        System.out.println("Response code: " + responseCode);
        return responseCode;

    } catch (PersonalizeEventsException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return responseCode;
}

SDK for JavaScript v3

import {
  PutUsersCommand,
  PersonalizeEventsClient,
} from "@aws-sdk/client-personalize-events";

const personalizeEventsClient = new PersonalizeEventsClient({
  region: "REGION",
});

// set the put users parameters
var putUsersParam = {
  datasetArn:
    "DATASET ARN",
  users: [
    {
      userId: "userId",
      properties: '{"column1Name": "value", "column2Name": "value"}',
    },
    {
      userId: "userId",
      properties: '{"column1Name": "value", "column2Name": "value"}',
    },
  ],
};
export const run = async () => {
  try {
    const response = await personalizeEventsClient.send(
      new PutUsersCommand(putUsersParam)
    );
    console.log("Success!", response);
    return response; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();