Importación de usuarios de forma individual

Una vez que haya terminado Creación de un conjunto de datos y un esquema para crear un conjunto de datos de usuarios, puede importar individualmente uno o más usuarios nuevos en el conjunto de datos. La importación individual de usuarios le permite mantener actualizado su conjunto de datos de usuarios con importaciones de lotes pequeños a medida que su catálogo crece. Puede importar hasta 10 usuarios a la vez. Si tiene una gran cantidad de usuarios nuevos, le recomendamos que primero importe los datos de forma masiva y, a continuación, los importe individualmente según sea necesario. Consulte Importación de datos directamente a conjuntos de datos de Amazon Personalize.

Puedes usar la consola Amazon Personalize, el AWS Command Line Interface (AWS CLI) o AWS los SDK para importar usuarios. Si importa un usuario con el mismo userId que un usuario que ya se encuentra en su conjunto de datos de usuarios, Amazon Personalize lo sustituye por el nuevo elemento. Puede importar hasta 10 usuarios a la vez.

Para obtener información sobre cómo Amazon Personalize actualiza los filtros de los nuevos registros y cómo los nuevos registros influyen en las recomendaciones, consulte Importación de registros de individuales.

Importación de usuarios de forma individual (consola)

Puede importar hasta 10 usuarios a la vez. En este procedimiento, se presupone que ya ha creado un conjunto de datos de usuarios. Para obtener información sobre cómo crear conjuntos de datos, consulte Creación de un conjunto de datos y un esquema.

Para importar usuarios de forma individual (consola)

1. Abra la consola de Amazon Personalize en https://console.aws.amazon.com/personalize/home e inicie sesión en su cuenta.

2. En la página Grupos de conjuntos de datos, elija el grupo de conjuntos de datos con el conjunto de datos de usuarios al que desee importar el usuario.

3. Elija Conjuntos de datos en el panel de navegación.

4. En la página Conjuntos de datos, elija el conjunto de datos de usuarios.

5. En la página de detalles del conjunto de datos, en la parte superior derecha, elija Modificar conjunto de datos y Crear registro.

6. En la página Crear registros de usuario, para la entrada de registro, introduzca los detalles del usuario en formato JSON. Los nombres y valores de los campos del usuario deben coincidir con el esquema que utilizó al crear el conjunto de datos de usuarios. Amazon Personalize proporciona una plantilla JSON con nombres de campos y tipos de datos de este esquema.

7. Elija Crear registros. En Respuesta, se muestra el resultado de la importación y un mensaje de éxito o error.

Importación de usuarios de forma individual (AWS CLI)

Agregue uno o más usuarios a su conjunto de datos de usuarios mediante la operación PutUsers. Puede importar hasta 10 usuarios con una sola llamada PutUsers. En esta sección se supone que ya ha creado un conjunto de datos de usuarios. Para obtener información sobre cómo crear conjuntos de datos, consulte Creación de un conjunto de datos y un esquema.

Use el siguiente comando put-users para añadir uno o más usuarios con la AWS CLI. Sustituya dataset arn por el nombre de recurso de Amazon (ARN) de su conjunto de datos y user Id por el ID del usuario. Si un usuario con el mismo userId ya se encuentra en su conjunto de datos de usuarios, Amazon Personalize lo sustituye por el nuevo.

Para properties, para cada campo de su conjunto de datos de usuarios, sustituya propertyName por el nombre del campo de su esquema en formato camel case. Por ejemplo, GENDER sería gender y MEMBERSHIP_TYPE sería membershipType. Sustituya user data por los datos del usuario. En el caso de los datos de cadena categóricos, para incluir varias categorías para un sola propiedad, separe cada categoría con un separador vertical (|). Por ejemplo, \"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\"}" 
    }]'

Importación de usuarios de forma individual (AWS SDK)

Agregue uno o más usuarios a su conjunto de datos de usuarios mediante la operación PutUsers. Si un usuario con el mismo userId ya se encuentra en su conjunto de datos de usuarios, Amazon Personalize lo sustituye por el nuevo. Puede importar hasta 10 usuarios con una sola llamada PutUsers. En esta sección se supone que ya ha creado un conjunto de datos de usuarios. Para obtener información sobre cómo crear conjuntos de datos, consulte Creación de un conjunto de datos y un esquema.

El siguiente código muestra cómo añadir uno o más usuarios a su conjunto de datos de usuarios. Para cada parámetro de nombre de propiedad, pase el nombre del campo de su esquema en formato camel case. Por ejemplo, GENDER sería gender y MEMBERSHIP_TYPE sería membershipType. Para cada parámetro de valor de propiedad, pase los datos al usuario.

En el caso de los datos de cadena categóricos, para incluir varias categorías para un sola propiedad, separe cada categoría con un separador vertical (|). Por ejemplo, "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();