아이템 특성

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

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

주요 기능:

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

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

작동 방식

1. 아이템 특성 및 해당 값을 생성하고 이를 다음과 같이 아이템과 연결할 수 있습니다:

• 아이템 특성의 External ID 및 특성 값의 External ID 지정을 통한 게시자 계정 혹은 API를 통하여.
• JSON 형식으로 특성 및 해당 값을 지정하여 게시자 계정을 통하여.

2. 아이템 카탈로그를 요청하기 위하여 가상 아이템 및 재화의 카탈로그 세부 항목 혹은 메소드 게임 키 그룹의 메소드를 사용합니다. 다음처럼 특성 데이터가 반환됩니다:

• 특성이 아이템 특성의 External ID 및 특성 값의 External ID를 지정하여 게시자 계정이나 API 메소드를 통해 생성된 경우에는 특성 배열에.
• 특성 및 값이 JSON을 통해 생성된 경우에는 custom_attributes 배열에. 이렇게 하려면, 카탈로그 검색 요청에 additional_fields 매개 변수를 custom_attributes 값과 함께 포함시킵니다.

3. 사용자가 구매합니다. JSON을 통해 특성 및 값이 추가된 경우에는, 아이템 특성에 관한 값이 custom_attributes 배열의 성공적인 주문 결제 및 주문 취소 웹훅을 통해 전달됩니다.

통합 절차

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

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

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

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

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

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

• 값 목록.

• 부모 아이템 특성 External ID.
• 값의 External ID — 값의 고유 ID로 경로 매개 변수의 external_id 매개 변수로 전달됩니다. 시스템의 값 ID를 지정하거나 신규로 생성합니다.

• 명칭 (프로젝트에 구성된 각 언어에 대해 지정됨).

• 게시자 계정에서
• API 메소드를 통해

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

1. 게시자 계정에서 프로젝트 열기.
2. 스토어 > 카탈로그 관리로 이동.

3. 구성을 아이템 특성 섹션에서 클릭.
4. 아이템 특성 생성을 클릭.
5. External ID 및 아이템 특성 명칭을 지정.
6. 저장 및 계속을 클릭.
7. 생성된 아이템 특성에 필요한 모든 값을 지정. 모든 값에 대하여, External ID를 지정하세요. 값을 더 추가하려면, +를 클릭합니다.
8. 저장 및 계속하기를 클릭합니다.

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

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

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

• 특성 생성
• 특성 갱신
• 특정 특성 가져오기
• 특성 삭제

• 관리를 위한 특성 목록 가져오기

• 특성 값 생성
• 특성의 모든 값 삭제
• 특성 값 갱신
• 특성 값 삭제

아이템에 특성 추가

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

• Publisher Account
• API 메소드 사용

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

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

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

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

특성 및 값 배열 사례:

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

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

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

• 인게임 재화 패키지
• 시간 제한 아이템을 포함하는 가상 아이템
• 게임 키
• 번들

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

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

6. 표시 문장 영역에서, 특성 목록 및 값을 JSON 형식으로 추가합니다.