Atributos del artículo

Los atributos son características de un artículo que pueden proporcionar información adicional sobre el artículo.

Un atributo puede ser el color y el tamaño de un artículo, el nivel de usuario en el que el artículo está disponible o un evento en un juego.

Características principales:

• Filtrar artículos en la tienda
• Definir variantes del artículo (por ej., casco rojo, casco azul) y mostrarlas en la tarjeta de artículo
• Asignar características adicionales a un artículo

Ejemplos de atributos de artículos y sus valores:

Cómo funciona

1. Puede crear atributos de artículo y sus valores y vincularlos con el artículo:

• mediante Publisher Account o API especificando External ID de los atributos del artículo y External ID de los valores del artículo.
• mediante Publisher Account especificando los atributos y sus valores en formato JSON.

2. Utilice los métodos de la subsección del Catálogo de los grupos de métodos Artículos y moneda virtuales o Claves del juego para solicitar el catálogo de artículos. Se obtendrán los datos de los atributos:

• En la matriz de atributos si los atributos se creasen mediante la cuenta del editor o mediante los métodos API especificando el External ID de los atributos del artículo y el External ID de los valores del atributo.
• En la matriz custom_attributes si los atributos y valores se añaden mediante JSON. Para ello, tendrá que incluir el parámetro additional_fields con el valor custom_attributes en la solicitud de recuperación de catálogo.

3. El usuario realiza una compra. Si los atributos y valores se agregan mediante JSON, los datos sobre los atributos del artículo se pasarán en los webhooks Pago correcto del pedido. y Cancelación del pedido en la matriz custom_attributes.

Flujo de integración

Puede crear atributos de artículos y sus valores desde su parte y añadirlos al artículo en formato JSON en Publisher Account.

También puede crear atributos y sus valores del lado de Xolla y añadirlos a los artículos. Para ello:

1. Crear atributos y sus valores.
2. Configurar la conexión entre atributos y artículos.

Crear y configurar atributos de artículo y sus valores

Cada atributo de artículo cuenta con los parámetros siguientes:

• External ID: es un ID de atributo único que se pasa en el parámetro external_id en el cuerpo de la solicitud. Proporcione el ID del atributo en su sistema o cree uno nuevo.
• Nombre (especificado para cada idioma configurado en el proyecto).

• Lista de valores.

• External ID del atributo del artículo primario.
• External ID del valor: un ID único del valor pasado en el parámetro external_id en los parámetros de ruta. Especifique el ID del valor en su sistema o cree uno nuevo.

• Nombre (especificado para cada idioma configurado en el proyecto).

• en el Publisher Account
• mediante métodos API

Crear atributos y sus valores en Publisher Account

1. Abra su proyecto en Publisher Account.
2. Vaya a Tienda > Gestión de catálogo.

3. Haga clic en Configurar en la sección Atributos de artículo.
4. Haga clic en Crear atributo de artículo.
5. Especifique el External ID y el nombre del atributo del artículo.
6. Haga clic en Guardar y continuar.
7. Especifique todos los valores necesarios para el atributo del artículo creado. Para cada valor, especifique el External ID. Para añadir valores adicionales, haga clic en +.
8. Haga clic en Guardar y continuar.

Crear atributos y sus valores mediante métodos API

Para crear y gestionar atributos de artículos y sus valores, utilice los métodos de la subsección Admin del grupo de métodos Atributos del artículo.

Métodos para crear atributos y gestionarlos:

• Crear atributo
• Actualizar atributo
• Obtener atributo especificado
• Eliminar atributo

• Obtener la lista de atributos para administración

• Crear valor de atributo
• Eliminar todos los valores del atributo
• Actualizar valor del atributo
• Eliminar valor de atributo

Añadir atributos a un artículo

Añada los atributos y valores creados a los artículos:

• mediante los métodos de Publisher Account
• API

Añadir atributos existentes mediante Publisher Account

1. Abra su proyecto en Cuenta del editor.
2. En el menú lateral, haga clic en Store (Tienda).
3. Abra una sección con el tipo de artículo requerido:
   • artículos virtuales
   • moneda virtual
   • claves de juego
   • lotes
4. Crear un artículo nuevo o editar uno existente.
5. En la sección Atributos del artículo, cambie el conmutador Seleccionar atributos existentes o crear nuevos a On (activo).
6. En el campo que aparece Atributo de artículo, seleccione el ID correspondiente al atributo de artículo deseado.
7. En el campo Valor, seleccione el ID que corresponda al valor del atributo del artículo.

Añadir atributos existentes mediante métodos API

En el método Crear artículo virtual o Actualizar artículo virtual, pase una matriz de objetos con el External ID de los atributos del artículo y el External ID de los valores que tengan que ser conectados.

Ejemplo de una matriz con atributos y sus valores:

  "attributes": [
    {
      "external_id": "craft-materials",
      "name": {
        "en": "Craft materials"
      },
      "values": [
        {
          "external_id": "steel",
          "value": {
            "en-US": "5"
          }
        },
        {
          "external_id": "leather",
          "value": {
            "en-US": "1"
          }
        }
      ]
    }
  ],

Añadir atributos de JSON mediante la Publisher Account

Puede añadir atributos y sus valores en formato JSON al crear o editar todo tipo de artículos, como:

• paquetes de moneda virtuales
• artículos virtuales, incluyendo artículos de tiempo limitado
• claves del juego
• lotes

Para ello:

1. Abra su proyecto en Cuenta del editor.
2. En el menú lateral, haga clic en Tienda.
3. Abra una sección con el tipo de artículo requerido:
   • artículos virtuales
   • moneda virtual
   • claves del juego
   • lotes
4. Crear un artículo nuevo o editar uno existente.
5. En la sección Atributos del artículo, cambie el conmutador Usar JSON para añadir atributos a On (activo).

6. En el área de texto mostrada, añada una lista de atributos y sus valores en formato JSON.