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

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

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

유저 속성 페이지

Do's

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

Dont's

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

관련 문서

이벤트 속성

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

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

Do's

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

Dont's

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)처리를 하고 있습니다. 반드시 전송한 데이터의 타입과 콘솔에 등록된 타입이 일치하는지 확인해주세요.

Do's

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

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이 필수
})

• 날짜, 날짜 및 시간은 완전히 구분되는 서로 다른 자료형입니다. 반드시 각 자료형에 알맞는 데이터를 전송해주세요.

• 날짜, 날짜 및 시간에서 지원하는 값 형태는 관련 문서에서 확인해주세요.

관련 문서

데이터 타입