이벤트 수집

이 페이지에서는 SDK를 통해 플랫폼의 이벤트 데이터를 수집하는 방법을 안내합니다.

Marketap SDK의 track 메서드는 사용자의 행동 데이터를 이벤트로 기록하여 Marketap 콘솔에서 관리하고 분석할 수 있도록 지원합니다. 이 메서드는 이벤트 이름, 이벤트 속성, 그리고 아이템 속성을 사용하여 다양한 데이터를 수집할 수 있습니다.

구성요소	설명	예시
이벤트 이름	사용자 행동을 정의하는 고유 값.	mkt_purchase, open_discount_event_zone, subscription_start
이벤트 속성	이벤트에 대한 추가 정보를 제공하는 key-value 쌍.	source: homepage, amount: 49.99
아이템 속성	이벤트와 관련된 상품/서비스의 세부 정보를 제공하는 배열 형태의 속성.	mkt_items: [{ name: "T-shirt", price: 25.00, quantity: 2 }]

마켓탭에서는 이벤트, 이벤트 속성, 아이템 속성 모두 커스터마이징이 가능합니다. 관련 내용은 아래 카드를 통해 확인해주세요.

이벤트 확인하기

이벤트 속성 확인하기

마켓탭에서 자동으로 수집되는 이벤트 및 속성 확인하기

Track() 함수

Marketap SDK에서는 track() 함수를 통해 유저의 이벤트 데이터를 수집합니다.

마켓탭은 SDK 내부에서 user_id를 추적하고 있습니다. 따라서 이벤트를 측정할 때에는, user_id에 대한 값을 받지 않습니다. 이벤트가 올바르게 연결하기 위해서는 유저와 기기 관계를 설정해주어야 합니다. 관련 문서는 여기에서 자세히 확인하세요.

매개변수:

• name: 이벤트 이름 (예: open_discount_event_zone).

• properties?: 이벤트와 함께 기록할 속성.

JavaScript

mtap.track('open_discount_event_zone', {
  on_sale_item_total_price: 100.0,
  currency: 'USD',
  mkt_items: [
    {
      mkt_product_id: 'P12345',
      mkt_product_name: 'T-shirt',
      mkt_product_price: 25.0,
      mkt_quantity: 2,
      mkt_discount: 5.0,
      mkt_category1: '의류',
      mkt_category2: '남성복',
    },
    {
      mkt_product_id: 'P67890',
      mkt_product_name: 'Sneakers',
      mkt_product_price: 50.0,
      mkt_quantity: 1,
      mkt_category1: '신발',
      mkt_category2: '운동화',
    },
  ],
});

Android - Kotlin

Android - Java

IOS - Swift

Flutter - Dart