In-Game Store / Atributos del artículo

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:

Tipo de artículoNombre del atributo del artículoValor de atributo del artículo
Claves del juegoTipo de juegoNuevo, Acceso anticipado, Pronto disponible, Especial
Claves del juegoGéneroAcción, Aventuras, Casual, Simulador, Estrategia, Aventura RPG (rol)
Artículos virtualesCalidadÉpico, Legendario, Común
Artículos virtualesClaseGuerrero, Paladín, Cazador, Chamán, Druida
Moneda virtualEventoNuevo año
Moneda virtualMisiónLlevar a cabo la misión 1, Llevar a cabo la misión 2

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.
  1. 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.
  1. 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.
Nota

Al añadir atributos de artículos y sus valores desde JSON, existe un límite de 500 caracteres. No hay limitaciones en el número de atributos y valores.

Al crear atributos y sus valores en Publisher Account o mediante métodos API, habrá que tener en cuenta las limitaciones siguientes:

  • No se pueden especificar más de 20 valores por atributo de artículo
  • No se pueden configurar más de 20 atributos por artículo
  • Un artículo puede tener varios valores de un atributo pero no más de 6

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.

Cada valor de atributo de artículo cuenta con los parámetros siguientes
  • 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).

Puede crear atributos y sus valores de una de las maneras siguientes:

Crear atributos y sus valores en Publisher Account

  1. Abra su proyecto en Publisher Account.
  2. Vaya a Tienda > Gestión de catálogo.
  1. Haga clic en Configurar en la sección Atributos de artículo.
  2. Haga clic en Crear atributo de artículo.
  3. Especifique el External ID y el nombre del atributo del artículo.
  4. Haga clic en Guardar y continuar.
  5. 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 +.
  6. Haga clic en Guardar y continuar.
Nota

El número de atributos de artículo en el proyecto es ilimitado.

Sin embargo, existe un límite de 20 valores por artículo.

Después de crear los atributos y valores, podrá añadirlos a los artículos mediante API o Publisher Account.

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:

Métodos para crear valores de atributos y gestionarlos:
Aviso

Si elimina un atributo de artículo, se perderán sus valores y conexiones con el artículo.

Si eliminar un valor, se perderán sus conexiones con el artículo.

No se podrá restablecer atributos de artículo, valores o datos relacionados eliminados.

Después de crear los atributos y valores, podrá añadirlos a los artículos mediante API o Publisher Account.

Añadir atributos a un artículo

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

Añadir atributos existentes mediante Publisher Account

Para añadir atributos a un artículo:
  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.
Nota

No puede establecer más de 20 atributos por artículo.

No puede especificar más de 6 valores del mismo atributo para un 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:

Copy
Full screen
Small screen
  "attributes": [
    {
      "external_id": "craft-materials",
      "name": {
        "en": "Craft materials"
      },
      "values": [
        {
          "external_id": "steel",
          "value": {
            "en-US": "5"
          }
        },
        {
          "external_id": "leather",
          "value": {
            "en-US": "1"
          }
        }
      ]
    }
  ],
Nota
Al solicitar el catálogo de artículos utilizando 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, la respuesta también incluirá una lista de los atributos correspondientes y sus valores en la matriz de atributos.
Nota

No puede establecer más de 20 atributos por artículo.

No puede especificar más de 6 valores del mismo atributo para un artículo.

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:

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).
  1. En el área de texto mostrada, añada una lista de atributos y sus valores en formato JSON.
Nota

No hay límite en el número ni en los valores al añadir atributos en formato JSON.

Existe una limitación en la longitud máxima de JSON: 500 caracteres.

¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Valore esta página
Valore esta página
¿Hay algo en lo que podamos mejorar?

Prefiero no responder

¡Gracias por tu mensaje!
Última actualización: 10 de Octubre de 2023

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!