# 이벤트 수집

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

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

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

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>이벤트 확인하기</td><td><a href="event/predefined">predefined</a></td></tr><tr><td>이벤트 속성 확인하기</td><td><a href="event/property">property</a></td></tr><tr><td>마켓탭에서 자동으로 수집되는 이벤트 및 속성 확인하기</td><td><a href="event/auto-collect">auto-collect</a></td></tr></tbody></table>

## `Track()` 함수

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

{% hint style="success" %}
마켓탭은 SDK 내부에서 user\_id를 추적하고 있습니다. 따라서 이벤트를 측정할 때에는, user\_id에 대한 값을 받지 않습니다. 이벤트가 올바르게 연결하기 위해서는 유저와 기기 관계를 설정해주어야 합니다. 관련 문서는 [여기](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/taxonomy/sdk/user-profile/device)에서 자세히 확인하세요.
{% endhint %}

**매개변수**:

* name: 이벤트 이름 (예: open\_discount\_event\_zone).
* properties?: 이벤트와 함께 기록할 속성.

{% tabs %}
{% tab title="JavaScript" %}

```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: '운동화',
    },
  ],
});
```

{% endtab %}

{% tab title="Android - Kotlin" %}

```kotlin
Marketap.track(
    event = "open_discount_event_zone",
    properties = mapOf(
        "on_sale_item_total_price" to 100.0,
        "currency" to "USD",
        "mkt_items" to listOf(
            mapOf(
                "mkt_product_id" to "P12345",
                "mkt_product_name" to "T-shirt",
                "mkt_product_price" to 25.0,
                "mkt_quantity" to 2,
                "mkt_discount" to 5.0,
                "mkt_category1" to "의류",
                "mkt_category2" to "남성복"
            ),
            mapOf(
                "mkt_product_id" to "P67890",
                "mkt_product_name" to "Sneakers",
                "mkt_product_price" to 50.0,
                "mkt_quantity" to 1,
                "mkt_category1" to "신발",
                "mkt_category2" to "운동화"
            )
        )
    )
)
```

{% endtab %}

{% tab title="Android - Java" %}

```java
Marketap.track(
    "open_discount_event_zone",
    new HashMap<String, Object>() {{
        put("on_sale_item_total_price", 100.0);
        put("currency", "USD");
        put("mkt_items", Arrays.asList(
            new HashMap<String, Object>() {{
                put("mkt_product_id", "P12345");
                put("mkt_product_name", "T-shirt");
                put("mkt_product_price", 25.0);
                put("mkt_quantity", 2);
                put("mkt_discount", 5.0);
                put("mkt_category1", "의류");
                put("mkt_category2", "남성복");
            }},
            new HashMap<String, Object>() {{
                put("mkt_product_id", "P67890");
                put("mkt_product_name", "Sneakers");
                put("mkt_product_price", 50.0);
                put("mkt_quantity", 1);
                put("mkt_category1", "신발");
                put("mkt_category2", "운동화");
            }}
        ));
    }}
);
```

{% endtab %}

{% tab title="IOS - Swift" %}

```swift
Marketap.track(
    eventName: "open_discount_event_zone",
    eventProperties: [
        "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": "운동화"
            ]
        ]
    ]
)
```

{% endtab %}

{% tab title="Flutter - Dart" %}

```dart
Marketap.track(
  "open_discount_event_zone",
  eventProperties: {
    "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": "운동화",
      },
    ],
  },
);

```

{% endtab %}
{% endtabs %}