아이템 특성

특성은 아이템에 대한 추가적인 정보를 제공할 수 있는 아이템의 특징입니다.

특성은 아이템의 색상이나 크기, 아이템을 사용할 수 있는 사용자 레벨, 게임 내 이벤트일 수 있습니다.

주요 기능:

  • 스토어의 아이템 필터링
  • 아이템 변형 정의 (예를 들어, 붉은 헬멧, 파란 헬멧) 및 아이템 카드에 이를 표시
  • 추가적인 특징을 아이템에 할당

아이템 특성 및 해당 값의 예:

아이템 유형아이템 특성 이름아이템 특성 값
게임 키게임 유형신규, 빠른 액세스, 출시 예정, 스페셜
게임 키장르액션, 모험, 캐주얼, 시뮬레이터, 전략, RPG
가상 아이템품질에픽, 전설적인, 일반
가상 아이템클래스전사, 협객, 사냥꾼, 샤먼, 드루이드
인게임 재화이벤트새해
인게임 재화퀘스트퀘스트 완료 1, 퀘스트 완료 2

작동 방식

  1. 아이템 특성 및 해당 값을 생성하고 이를 다음과 같이 아이템과 연결할 수 있습니다:
  • 아이템 특성의 External ID 및 특성 값의 External ID 지정을 통한 게시자 계정 혹은 API를 통하여.
  • JSON 형식으로 특성 및 해당 값을 지정하여 게시자 계정을 통하여.
  1. 아이템 카탈로그를 요청하기 위하여 가상 아이템 및 재화카탈로그 세부 항목 혹은 메소드 게임 키 그룹의 메소드를 사용합니다. 다음처럼 특성 데이터가 반환됩니다:
  • 특성이 아이템 특성의 External ID 및 특성 값의 External ID를 지정하여 게시자 계정이나 API 메소드를 통해 생성된 경우에는 특성 배열에.
  • 특성 및 값이 JSON을 통해 생성된 경우에는 custom_attributes 배열에. 이렇게 하려면, 카탈로그 검색 요청에 additional_fields 매개 변수를 custom_attributes 값과 함께 포함시킵니다.
  1. 사용자가 구매합니다. JSON을 통해 특성 및 값이 추가된 경우에는, 아이템 특성에 관한 값이 custom_attributes 배열의 성공적인 주문 결제주문 취소 웹훅을 통해 전달됩니다.

통합 절차

여러분 측에서 아이템 특성 및 해당 값을 생성하고 이를 게시자 계정에서 JSON 형식으로 아이템에 추가할 수 있습니다.

또한 엑솔라 측에서도 특성 및 해당 값을 생성하고 아이템에 추가할 수 있습니다. 이렇게 하려면:

  1. 특성 및 해당 값을 생성.
  2. 특성과 아이템 사이의 연결 설정.
알림

JSON으로 아이템 특성 및 해당 값 추가 시, 500자의 제한이 있습니다. 특성 및 값의 수에는 제한이 없습니다.

게시자 계정 혹은 API 메소드를 통해 아이템을 생성할 때, 다음의 제한 사항이 적용됩니다:

  • 하나의 아이템 특성에 대하여 20개 이하의 값만 지정할 수 있습니다
  • 각 아이템에 대하여 20개 이하의 특성만 구성할 수 있습니다
  • 하나의 아이템은 하나의 특성에 6개 이하의 값만 가질 수 있습니다

아이템 특성 및 값 생성과 설정

개별 아이템 특성에는 다음과 같은 매개변수가 있습니다:

  • External ID — 고유의 특성 ID로 요청 본문의 external_id 매개 변수에 전달됩니다. 시스템에 특성 ID를 제공하거나 새롭게 생성합니다.
  • 명칭 (프로젝트에 구성된 각 언어에 대해 지정됨).
  • 값 목록.

개별 아이템 특성 값에는 다음 매개 변수가 있습니다:
  • 부모 아이템 특성 External ID.
  • 값의 External ID — 값의 고유 ID로 경로 매개 변수의 external_id 매개 변수로 전달됩니다. 시스템의 값 ID를 지정하거나 신규로 생성합니다.
  • 명칭 (프로젝트에 구성된 각 언어에 대해 지정됨).

아이템 특성 및 값은 다음과 같이 생성할 수 있습니다:

게시자 계정에서 특성 및 값 생성

  1. 게시자 계정에서 프로젝트 열기.
  2. 스토어 > 카탈로그 관리로 이동.
  1. 구성아이템 특성 섹션에서 클릭.
  2. 아이템 특성 생성을 클릭.
  3. External ID 및 아이템 특성 명칭을 지정.
  4. 저장 및 계속을 클릭.
  5. 생성된 아이템 특성에 필요한 모든 값을 지정. 모든 값에 대하여, External ID를 지정하세요. 값을 더 추가하려면, +를 클릭합니다.
  6. 저장 및 계속하기를 클릭합니다.
알림

프로젝트의 아이템 특성 수에는 제한이 없습니다.

그리고, 특성 별로 값은 20개로 제한됩니다.

특성 및 값 생성 후, API 혹은 게시자 계정을 통해 이를 아이템에 추가할 수 있습니다.

API 메소드를 통한 특성 및 값 생성

아이템 특성 및 값을 생성하고 관리하기 위하여, 메소드의 아이템 특성 그룹의 관리자 세부 항목에 있는 메소드를 사용하세요 .

특성을 생성하고 관리하기 위한 메소드:

특성 값을 생성하고 관리하기 위한 메소드:
주의

아이템 특성을 삭제하면 해당 값과 아이템 관련 연결도 사라지게 됩니다.

값을 삭제하면, 아이템 관련 연결은 사라집니다.

삭제된 아이템 특성, 값 혹은 관련 데이터는 복원할 수 없습니다.

특성 및 값 생성 후, API 혹은 게시자 계정을 통해 이를 아이템에 추가할 수 있습니다.

아이템에 특성 추가

항목에 생성된 특성 및 값 추가:

게시자 계정을 통한 기존 특성 추가

아이템에 특성 추가 방법:
  1. 프로젝트를 게시자 계정에서 엽니다.
  2. 사이드 메뉴에서 스토어를 클릭합니다.
  3. 필수 아이템 유형 섹션 열기:
    • 가상 아이템
    • 인게임 재화
    • 게임 키
    • 번들
  4. 새 아이템을 생성하거나 기존 것을 편집합니다.
  5. 아이템 특성 섹션에서, 기존 특성 선택 혹은 신규 생성 토글을 켜기로 바꿉니다.
  6. 표시된 아이템 특성 필드에서, 원하는 아이템 특성에 해당하는 ID를 선택합니다.
  7. 필드에서, 원하는 아이템 값에 해당하는 ID를 선택합니다.
알림

아이템에 대해 20개를 초과하는 특성을 설정할 수 없습니다.

하나의 아이템에 6개를 초과하는 같은 특성값을 지정할 수 없습니다.

API 메소드를 통해 기존 특성 추가

가상 아이템 생성 혹은 가상 아이템 갱신 메소드에서, 개체 배열과 아이템 특성의 External ID 및 연결이 필요한 값의 External ID을 전달합니다.

특성 및 값 배열 사례:

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"
          }
        }
      ]
    }
  ],
알림
가상 아이템 및 재화카탈로그 세부 항목 혹은 게임 키 메소드 그룹의 메소드를 사용하여 아이템 카탈로그를 요청하는 경우, 응답은 또한 상응하는 특성 및 그 값을 특성 배열에 포함합니다.
알림

아이템에 대해 20개를 초과하는 특성을 설정할 수 없습니다.

하나의 아이템에 6개를 초과하는 같은 특성값을 지정할 수 없습니다.

게시자 계정을 통해 JSON으로 특성 추가

다음과 같은 모든 유형의 아이템 생성 및 편집 시 특성 및 해당 값을 JSON 형식으로 추가할 수 있습니다:

이렇게 하려면 다음을 수행합니다:

  1. 프로젝트를 게시자 계정에서 엽니다.
  2. 사이드 메뉴에서 스토어를 클릭합니다.
  3. 필수 아이템 유형 섹션 열기:
    • 가상 아이템
    • 인게임 재화
    • 게임 키
    • 번들
  4. 새 아이템을 생성하거나 기존 것을 편집합니다.
  5. 아이템 특성 섹션에서, JSON을 사용하여 특성 추가 토글을 켜기로 바꿉니다.
  1. 표시 문장 영역에서, 특성 목록 및 값을 JSON 형식으로 추가합니다.
알림

JSON 형식으로 특성을 추가할 때, 그 값의 수는 무제한입니다.

JSON 최대 길이는 500자입니다.

이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!
마지막 업데이트: 2023년 10월 10일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!