Importazione di utenti singolarmente

Dopo aver completato la creazione Creazione di un set di dati e di uno schema di un set di dati Users, puoi importare singolarmente uno o più nuovi utenti nel set di dati. L'importazione individuale degli utenti consente di mantenere aggiornato il set di dati Users con importazioni in piccoli batch man mano che il catalogo cresce. Puoi importare fino a 10 utenti alla volta. Se hai un gran numero di nuovi utenti, ti consigliamo di importare prima i dati in blocco e poi di importare i dati utente singolarmente, se necessario. Per informazioni, consulta Importazione di dati direttamente nei set di dati di Amazon Personalize.

Puoi utilizzare la console Amazon Personalize, il AWS Command Line Interface (AWS CLI) o gli AWS SDK per importare utenti. Se importi un utente con lo userId stesso nome di un utente già presente nel set di dati Users, Amazon Personalize sostituisce l'utente con uno nuovo. Puoi importare fino a 10 utenti alla volta.

Per informazioni su come Amazon Personalize aggiorna i filtri per i nuovi record e su come i nuovi record influiscono sui consigli, consulta. Importazione di singoli record

Importazione di utenti singolarmente (console)

Puoi importare fino a 10 utenti alla volta. Questa procedura presuppone che tu abbia già creato un set di dati Users. Per informazioni sulla creazione di set di dati, vedere. Creazione di un set di dati e di uno schema

Per importare utenti singolarmente (console)

1. Apri la console Amazon Personalize all'indirizzo https://console.aws.amazon.com/personalize/home e accedi al tuo account.

2. Nella pagina Gruppi di set di dati, scegli il gruppo di set di dati con il set di dati Utenti in cui desideri importare l'utente.

3. Nel riquadro di navigazione, scegli Datasets.

4. Nella pagina Set di dati, scegli il set di dati Utenti.

5. Nella pagina dei dettagli del set di dati, in alto a destra, scegli Modifica set di dati e scegli Crea record.

6. Nella pagina Crea record utente, per l'immissione dei record, inserisci i dettagli dell'utente in formato JSON. I nomi e i valori dei campi dell'utente devono corrispondere allo schema utilizzato durante la creazione del set di dati Users. Amazon Personalize fornisce un modello JSON con nomi di campo e tipi di dati di questo schema.

7. Scegli Crea record. In Response, viene elencato il risultato dell'importazione e viene visualizzato un messaggio di successo o di fallimento.

Importazione di utenti singolarmente () AWS CLI

Aggiungi uno o più utenti al set di dati Users con l'PutUsersoperazione. Puoi importare fino a 10 utenti con una singola PutUsers chiamata. Questa sezione presuppone che tu abbia già creato un set di dati Users. Per informazioni sulla creazione di set di dati, vedere. Creazione di un set di dati e di uno schema

Utilizzare il put-users comando seguente per aggiungere uno o più utenti con. AWS CLI Sostituisci dataset arn con l'Amazon Resource Name (ARN) del tuo set di dati e user Id con l'ID dell'utente. Se un utente con lo stesso nome userId è già presente nel set di dati Users, Amazon Personalize lo sostituisce con quello nuovo.

Infattiproperties, per ogni campo del set di dati Users, sostituiscilo propertyName con il nome del campo del tuo schema, nel caso camel. Ad esempio, GENDER sarebbe gender e MEMBERSHIP_TYPE sarebbe. membershipType Sostituisci user data con i dati relativi all'utente. Per i dati di tipo stringa categorico, per includere più categorie per una singola proprietà, separate ogni categoria con una pipe (|). Ad esempio \"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\"}" 
    }]'

Importazione di utenti singolarmente (SDK) AWS

Aggiungi uno o più utenti al set di dati Users con l'operazione. PutUsers Se un utente con lo stesso nome userId è già presente nel set di dati Users, Amazon Personalize lo sostituisce con quello nuovo. Puoi importare fino a 10 utenti con una singola chiamata. PutUsers Questa sezione presuppone che tu abbia già creato un set di dati Users. Per informazioni sulla creazione di set di dati, vedere. Creazione di un set di dati e di uno schema

Il codice seguente mostra come aggiungere uno o più utenti al set di dati Users. Per ogni parametro del nome della proprietà, passa il nome del campo dallo schema, nel caso camel. Ad esempio, GENDER sarebbe gender e MEMBERSHIP_TYPE sarebbe. membershipType Per ogni parametro del valore della proprietà, trasmetti i dati per l'utente.

Per i dati di tipo stringa categorico, per includere più categorie per una singola proprietà, separate ogni categoria con una pipe (|). Ad esempio "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();