Atributos de item

Atributos são características de um item que pode fornecer informações adicionais sobre o item.

Um atributo pode ser a cor e o tamanho de um item, o nível de usuário no qual o item se torna disponível, ou um evento em um jogo.

Recursos principais:

• Filtragem de itens na loja
• Definição de variantes de itens (ex.: capacete vermelho, capacete azul) e a exibição deles no cartão do item
• Atribuição de características adicionais a um item

Exemplos de atributos de itens e seus valores:

Como funciona

1. Você cria atributos de itens e seus valores e os vincula com o item:

• através da Conta de Distribuidor ou API especificando o External ID dos atributos de itens e External ID de valores de atributos.
• através da Conta de Distribuidor especificando os atributos e seus valores no formato JSON.

2. Você usa métodos da subseção Catalog do grupo de métodos Virtual Items & Currency ou Game Keys para solicitar o item do catálogo. Os dados de atributo são retornados:

• Na matriz atributos, se houver atributos criados pela Conta de Distribuidor ou via métodos API especificando o External ID dos atributos do item e o External ID dos valores dos atributos.
• Na matriz custom_attributes, se os atributos e seus valores forem adicionados via JSON. Para fazer isso, você precisa incluir o parâmetro additional_fields com o valor custom_attributes na solicitação de recuperação do catálogo.

3. O usuário faz uma compra. Se os atributos e os valores forem adicionados via JSON, os dados sobre os atributos de itens são passados nos webhooks Successful payment of the order e Order cancellation na matriz custom_attributes.

Fluxo de integração

Você pode criar atributos de itens e seus valores do seu lado e adicioná-los ao item no formato JSON na Conta de Distribuidor.

Você pode criar atributos e seus valores no lado da Xsolla e adicioná-los aos itens. Para fazer isso:

1. Crie os atributos e seus valores.
2. Configure a conexão entre atributos e itens.

Criação e configuração de atributos de itens e seus valores

Cada atributo de item possui os seguintes parâmetros:

• External ID — é um ID de atributo único que é passado no parâmetro external_id no corpo solicitado. Forneça o ID de atributo no seu sistema ou crie um novo.
• Nome (especificado para cada idioma configurado no projeto).

• Lista de valores.

• External ID do atributo de item pai.
• External ID do valor — um ID exclusivo do valor passado no parâmetro external_id nos parâmetros de caminho. Especifique o ID do valor em seu sistema ou crie um novo.

• Nome (especificado para cada idioma configurado no projeto).

• na Conta de Distribuidor
• via métodos API

Criação de atributos e seus valores na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor.
2. Vá para Store > Catalog management.

3. Clique em Configure na seção Item attributes.
4. Clique em Create item attribute.
5. Especifique o External ID e o nome do atributo de item.
6. Clique em Save and continue.
7. Especifique todos os valores necessários para o atributo de item criado. Para cada valor, especifique o External ID. Para adicionar mais valores, clique em +.
8. Clique em Save and continue.

Criação de atributos e seus valores via métodos API

Para criar e gerenciar atributos de itens e seus valores, use os métodos na subseção Admin do grupo de métodos Item attributes.

Métodos para criar e gerenciar atributos:

• Criar atributo
• Atualizar atributo
• Obter atributo especificado
• Excluir atributo

• Obter lista de atributos para administração

• Criar valor de atributo
• Obter atributo especificado
• Atualizar valor do atributo
• Delete attribute value

Adicionando atributos a um item

Adicione os atributos e valores criados nos itens:

• pela Conta de Distribuidor
• métodos API

Adicione os atributos existentes via Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor.
2. No menu lateral, clique na Store.
3. Abra uma seção com o tipo de item necessário:
   • Itens virtuais
   • Moedas virtuais
   • Chaves de jogo
   • Conjuntos
4. Crie um novo item ou edite o existente.
5. Na seção Item attributes, defina a opção Select existing attributes or create new como On.
6. No campo Item attribute que surgir, selecione o ID correspondente ao atributo de item desejado.
7. No campo Value, selecione o ID que corresponde ao valor do atributo do item.

Adicione atributos existentes via métodos de API

No método Create virtual item ou Update virtual item, passe uma matriz de objetos com o External ID dos atributos do item e o External ID dos valores deles que serão conectados.

Exemplo de uma matriz com atributos e os valores deles:

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

Adição de atributos a partir do JSON via Conta de Distribuidor

Você pode adicionar atributos e seus valores no formato JSON ao criar ou editar todos os tipos de itens, tais como:

• pacotes de moedas virtuais
• itens virtuais, incluindo itens de tempo limitado
• chaves de jogo
• conjuntos

Para fazer isso:

1. Abra seu projeto na Conta de Distribuidor.
2. No menu lateral, clique na Store.
3. Abra uma seção com o tipo de item necessário:
   • Itens virtuais
   • Moedas virtuais
   • Chaves de jogo
   • Conjuntos
4. Crie um novo item ou edite um já existente.
5. Na seção atributos de itens, defina a opção Use JSON to add attributes como On.

6. Na área de texto exibida, adicione uma lista de atributos e seus valores no formato JSON.