구매

trackPurchase/trackRevenue

구매 이벤트를 기록합니다. trackPurchase의 경우 이벤트 이름이 자동으로 mkt_purchase로 설정됩니다.

trackRevenue의 경우 전달된 이벤트 이름을 사용합니다.

매개변수:

• name: 이벤트 이름

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

• revenue: 매출 값

JavaScript

mtap.trackPurchase(100.0, {
  payment_method: 'credit_card',
  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: '운동화',
    },
  ],
});
// ...
mtap.trackRevenue('ad_click_revenue', 50.0, {
  ad_platform: 'Google',
});

Android - Kotlin

Android - Java

IOS - Swift

Flutter - Dart

Best Practice

구매 측정은 모든 영역에서 중요한 요소입니다. 마켓탭은 구매 측정을 위해 아래와 같은 속성들을 기본으로 제공하고 있습니다. (mkt_revenue, mkt_order_id, mkt_payment_method, mkt_currency, item 속성들)

mtap.track('mkt_purchase', {
  mkt_revenue: 50.0,
  mkt_order_id: 'MY_ORDER_1234',
  mkt_payment_method: 'NAVER_PAY',
  mkt_currency: 'KRW'
  mkt_items: [
    {
      mkt_product_id: 'P12345',
      mkt_product_name: 'T-shirt',
      mkt_product_price: 25.0,
      mkt_quantity: 2,
      mkt_discount: 20.0,
      mkt_category1: '의류',
      mkt_category2: '남성복',
      mkt_brand: 'MY_CUSTOM_BRAND'
    }
  ],
});

1. mkt_revenue

mkt_revenue 값은 구매 이벤트에서 가장 핵심적인 속성입니다. 이 값은 플랫폼에서 구매 이벤트 매출을 계산하는 기준이 되며, 한눈에 보기 화면의 매출 지표와 마켓탭 자유 분석의 이벤트 가치 측정에 활용됩니다.

2. mkt_order_id

mkt_order_id 값은 자유 분석에서 주문 수치를 측정할 때 사용합니다. order_id 값이 없는 경우, 주문 수를 측정할 때 값이 노출되지 않을 수 있습니다.

3. 상품 속성 (mkt_product_name, mkt_product_id, mkt_quantity)

mkt_product_name, mkt_product_id는 제품을 구분할 때 자주 사용되는 속성입니다. 한눈에 보기 화면에서 가장 많이 구매된 제품, 조회된 제품, 장바구니에 담긴 제품을 집계할 때 mkt_product_name 값을 기준으로 활용합니다. 따라서 이 값이 누락되면 해당 지표가 표시되지 않을 수 있습니다.

mkt_quantity는 제품이 구매된 횟수를 측정할 때 사용됩니다. 따라서 이 값이 누락되면, 제품이 판매된 횟수와 실제 횟수에 오차가 발생할 수 있습니다.

상품 조회와 장바구니 담기 이벤트에 대한 자세한 설명은 아래 카드를 통해 확인해주세요.

상품 조회 / 장바구니 추가 / 위시리스트 추가