# 이벤트 속성 혹은 유저 속성이 누락되는 경우

## 1. 속성 텍소노미 설정 오류

마켓탭 콘솔의 설정 > 고객 데이터 연동 > 이벤트 속성, 유저 속성 페이지를 통해 해당 프로젝트에서 사용 가능한 속성 목록을 확인할 수 있습니다. `mkt_` 로 시작하는 이벤트는 마켓탭이 기본적으로 등록한 속성이며, 이외에도 필요한 속성을 속성 추가하기를 통해 설정할 수 있습니다.

<figure><img src="https://260547158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTQoY0rYrzNUQxhlUfYFm%2Fuploads%2FKds4Ae50nsv4gMQplFym%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-17%20%E1%84%8B%E1%85%A9%E1%84%8C%E1%85%A5%E1%86%AB%2011.55.16.png?alt=media&#x26;token=a956fb65-97dc-45de-8309-1309112caa86" alt=""><figcaption><p>유저 속성 페이지</p></figcaption></figure>

#### Do's

```kotlin
Marketap.identify("user_123", {
    "mkt_gender": "Male"  // 마켓탭이 자동으로 등록한 유저 속성
})
Marketap.track("mkt_purchase", {
    "is_event_purchase": true // 마켓탭의 콘솔에 커스텀하게 등록한 이벤트 속성
}) 
```

#### Dont's

```javascript
Marketap.identify("user_123", {
    "invalid_property": "Male"  // 마켓탭의 콘솔에 없는 유저 속성
})
Marketap.track("mkt_purchase", {
    "invalid_property": true // 마켓탭의 콘솔에 없는 이벤트 속성
}) 
```

#### 관련 문서

{% content-ref url="../../sdk/event/property" %}
[property](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/taxonomy/sdk/event/property)
{% endcontent-ref %}

## 2. 이벤트와 이벤트 아이템 속성 오류

마켓탭은 이벤트의 단순 속성과, 이벤트의 아이템 속성을 구분하고 있습니다. 이벤트 속성 페이지에서 \[상품] 태그가 붙어있는 속성은 반드시 `mkt_items` 하위에서만 사용해야 합니다.

<figure><img src="https://260547158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTQoY0rYrzNUQxhlUfYFm%2Fuploads%2FvgjDLu1kqWPLr71ykaBq%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-17%20%E1%84%8B%E1%85%A9%E1%84%8C%E1%85%A5%E1%86%AB%2011.59.42.png?alt=media&#x26;token=de9f7e4a-d2ad-4b5f-a5e1-0f224fa17ec1" alt=""><figcaption></figcaption></figure>

#### Do's

```kotlin
Marketap.track("mkt_purchase", {
    "mkt_items": [{
        "mkt_brand": "Marketap", // 마켓탭이 자동으로 등록한 이벤트 아이템 속성
        "is_item_in_sale": false // 마켓탭의 콘솔에 커스텀하게 등록한 이벤트 아이템 속성
    }]
}) 
```

#### Dont's

```javascript
Marketap.track("mkt_purchase", {
    "mkt_brand": "Marketap" // 이벤트 아이템 속성을 이벤트에서 사용함
    "mkt_items": [{
        "mkt_revenue": 1000.0, // 이벤트 속성을 아이템 속성에서 사용함
    }]
}) 

Marketap.track("mkt_purchase", {
    "mkt_items": { // mkt_items가 배열 형태가 아님
        "mkt_revenue": 1000.0,
    }
}) 
```

## 데이터 타입 확인

마켓탭은 정확한 데이터 처리를 위해 모든 속성의 타입을 관리합니다. 따라서, 타입이 맞지 않는 데이터가 전송되는 경우 값 없음 (null)처리를 하고 있습니다. 반드시 전송한 데이터의 타입과 콘솔에 등록된 타입이 일치하는지 확인해주세요.

<figure><img src="https://260547158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTQoY0rYrzNUQxhlUfYFm%2Fuploads%2FDsaf2XhKaTedYPntIJaS%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-07-17%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%2012.07.19.png?alt=media&#x26;token=7fe5ae82-2296-46e8-9387-1efead68e73e" alt=""><figcaption></figcaption></figure>

#### Do's

```kotlin
Marketap.track("mkt_purchase", {
    "mkt_items": [{
        "mkt_brand": "Marketap", // "문자열" 타입으로 올바르게 전송
        "is_item_in_sale": false // 콘솔에 등록된 "참/거짓" 타입으로 올바르게 전송
    }],
    "my_date_property": "2025-01-01",
    "my_date_time_property": "2025-01-01T12:01:00Z"
}) 
```

#### Dont's

```javascript
Marketap.track("mkt_purchase", {
    "mkt_items": [{
        "mkt_brand": 130982, // "문자열" 타입에 숫자를 전송함. "130982"로 수정 필요
        "is_item_in_sale": "false" // 콘솔에 등록된 "참/거짓" 타입이 아닌 문자열 값을 전송함.
    }],
    "my_date_property": "2025-01-01T12:01:00Z", // date 타입은 datetime 값을 넣을 수 없음
    "my_date_property2": "2025년 1월 1일" // date타입의 형식에 맞지 않음
    "my_date_property3": "2025/01/01" // date타입의 형식에 맞지 않음
    "my_date_time_property": "2025-01-01", // datetime 타입은 date 값을 넣을 수 없음
    "my_date_time_property": "2025-01-01 12:01:00" // datetime 타입은 timezone이 필수
})
```

{% hint style="danger" %}

* 날짜, 날짜 및 시간은 완전히 구분되는 서로 다른 자료형입니다. 반드시 각 자료형에 알맞는 데이터를 전송해주세요.
* 날짜, 날짜 및 시간에서 지원하는 값 형태는 [관련 문서](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/sdk/data-type#datetime)에서 확인해주세요.
  {% endhint %}

#### 관련 문서

{% content-ref url="../../sdk/data-type" %}
[data-type](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/taxonomy/sdk/data-type)
{% endcontent-ref %}