Event 및 User 정보 연동

1. 유저 데이터 연동

Marketap Open API에서는 사용자를 새로 등록하고, 그 속성을 업데이트 할 수 있습니다.

구성요소	설명	예시
유저 ID	유저를 고유하게 식별하는 값	user_id
유저 속성	유저의 속성에 대한 세부 정보를 나타내는 key-value 쌍	mkt_name: "홍길동", mkt_phone_number: "01012345678" mkt_text_message_opt_in: true

마켓탭에서는 기본적으로 지원하는 속성 외에도 필요한 유저 속성의 커스터마이징이 가능합니다. 관련 내용은 아래 페이지를 통해 확인해주세요.

유저 속성

유저를 삭제에 관련된 내용은 아래 페이지를 통해 확인해주세요.

유저 삭제하기 (탈퇴)

해당 API를 통해, 플랫폼이 기존에 수집하였던 유저 데이터를 쉽게 마이그레이션 할 수 있습니다. 관련 내용은 아래 페이지를 통해 확인해주세요.

유저 데이터 마이그레이션

유저 데이터를 연동할 때에는 반드시 유저의 광고성 메세지 수신동의 여부를 연동해주세요. 마켓탭은 아예 수집되지 않은 고객에 대해서 수신동의 여부를 따로 체크하지 않습니다. 명시적으로 "동의하지 않음"을 표시한 유저에 대해서만 광고 메세지 발송을 제한하고 있습니다. 자세한 내용은 여기에서 확인해주세요.

요청 예시

여기 문서에서 정확한 API 스펙을 확인하고, 요청을 테스트로 보내볼 수 있습니다.

매개변수:

• user_id: 유저의 id

• properties?: 업데이트할 유저의 속성

{
  "profiles": [
    {
      "user_id": "test-user-123",
      "properties": {
        "mkt_birth": "1999-05-07",
        "mkt_name": "GilDong Hong"
      }
    }
  ]
}

2. 이벤트 데이터 연동

Marketap Open API는 사용자의 행동 데이터를 이벤트로 기록하여 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 }]

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

이벤트 확인하기

이벤트 속성 확인하기

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

요청 예시

여기 문서에서 정확한 API 스펙을 확인하고, 요청을 테스트로 보내볼 수 있습니다.

매개변수:

• user_id?: 이벤트를 일으킨 유저의 id, null일 경우 비회원 이벤트 입니다.

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

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

  • mkt_items?: 이벤트와 관련된 아이템 속성, 리스트로 전달해야 합니다.

• timestamp?: 이벤트가 일어난 시간

시간을 직접 입력하는 경우,현재 기준 최대 한시간 차이를 권장합니다. 수집 시간과 실제 이벤트시간의 차이가 큰 경우 개발팀에게 문의해주세요.

{
  "events": [
    {
      "user_id": "test-user-123",
      "event_name": "open_discount_event_zone",
      "properties": {
        "mkt_page_url": "http://localhost:3000/checkout",
        "mkt_search_query": "검색",
        "mkt_items": [
          {
            "mkt_product_id": "PRODUCT_1",
            "mkt_product_name": "멋진 운동화",
            "mkt_category1": "운동화",
            "mkt_category2": "신발"
          }
        ]
      },
      "timestamp": "2025-02-02T05:30:11.052Z"
    }
  ]
}

3. 기기 데이터 연동

아래 API를 통해 기기 토큰을 등록하거나 업데이트할 수 있으며, 사용자 정보와의 매칭 정보를 함께 관리할 수 있습니다. 이를 통해 SDK 연동 이전에도 기존 고객 기기 토큰을 활용한 푸시 메시지 발송이 가능합니다.

유저 및 이벤트 정보 전송

해당 API를 통해, 플랫폼이 기존에 수집하였던 유저 데이터를 쉽게 마이그레이션 할 수 있습니다. 관련 내용은 아래 페이지를 통해 확인해주세요.

기기 데이터 마이그레이션

요청 예시

여기 문서에서 정확한 API 스펙을 확인하고, 요청을 테스트로 보내볼 수 있습니다.

매개변수:

• user_id?: 유저의 id

• tokens: 업데이트할 디바이스의 토큰

• platform: 디바이스의 플랫폼 (IOS / ANDROID / WEB)

{
  "profiles": [
    {
      "user_id": "test-user-123",
      "device": {
        "tokens": "fSVrgIChQiuGOMQ4KEkY2C:APA91bH7CB9JcSxQ4RElRyceXtq7d6qQL2Dr_OvPSkBClCeZSQ8CaYhqyHFyu_wUPKqoVtZWLUXoyrByYeW84I_EKaGPtxZD",
        "platform": "ANDROID"
      },
      "timestamp": "2025-02-06T05:30:11.052Z"
    }
  ]
}