# 유저 데이터 마이그레이션

## 개요 <a href="#overview" id="overview"></a>

Marketap SDK는 설치 이후부터 발생하는 **실시간 이벤트·속성**만 수집합니다. 따라서 서비스에 이미 존재하던 고객에게 **초기 메시지·리타깃팅·세분화**를 시도하려면, 과거 데이터를 먼저 적재해야 합니다. 이 과정을 **“유저 데이터 마이그레이션”**&#xC774;라 부르며, 다음과 같은 이점을 제공합니다.

* 설치 이후에 한번도 방문하지 않은 고객들에게도 메세지를 발송할 수 있습니다.
* 유저 속성을 기반으로 세그먼트화 하여 데이터가 부족한 초기에도 정밀한 마케팅을 진행할 수 있습니다.
* 광고성 포인트, 수신 동의 이력 등의 데이터를 통해 광고성 발송 관련 규제에 대응할 수 있습니다.

## 1. 마이그레이션 범위 정의

마켓탭은 원칙적으로 “SDK가 자동 수집하는 값 + 실제 마케팅에 쓰일 핵심 속성”을 마이그레이션하는 것을 권장합니다.&#x20;

예를 들어 SDK에서 "이름, 전화번호, 광고메세지 수신 동의 여부, 등급, 관심사, 보유 포인트"를 연동하였다면, 서버를 통해 과거 유저의 데이터를 연동할 때에도 동일한 데이터를 전달하면 됩니다.

{% hint style="danger" %}
**수집된 정확한 시점을 알 수 없는 레거시 속성**(예: `legacy_interest`)은 향후 업데이트 전략을 함께 수립하세요.
{% endhint %}

{% hint style="danger" %}
유저 데이터를 연동할 때에는 반드시 유저의 **광고성 메세지 수신동의 여부**를 연동해주세요. 마켓탭은 아예 수집되지 않은 고객에 대해서 수신동의 여부를 **따로 체크하지 않습니다**. 명시적으로 "동의하지 않음"을 표시한 유저에 대해서만 광고 메세지 발송을 제한하고 있습니다. 자세한 내용은 [여기에서](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/sdk/user-profile/property#undefined) 확인해주세요.
{% endhint %}

## 2.  데이터 전송

1. 플랫폼에서 관리하는 유저 전체 (혹은 마이그레이션을 원하는 일부)를 대상으로 하여 마이그레이션 범위에 해당하는 유저 속성을 추출합니다.
2. 마켓탭은 서버로부터 데이터를 수신하는 API를 제공하고 있습니다. 해당 API를 통해 예시 요청을 보낸 뒤, 해당 요청이 마켓탭에 의도한대로 잘 수신되었는지 확인합니다.
3. 예시 요청이 성공하였따면, 마이그레이션 대상 유저들 전체를 순회하면서 마켓탭의 서버로 데이터를 전송합니다.

API를 통해 유저정보를 연동하는 방법은 아래 문서를 확인해주세요.

{% content-ref url="" %}
[](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/taxonomy/server/user-event)
{% endcontent-ref %}

## 3. 수집 내역 확인

데이터가 잘 수집되었는지 확인하는 방법은 아래 문서를 확인해주세요.

{% content-ref url="../../validation" %}
[validation](https://docs.marketap.io/t3ZS4WXNMj0HK27EtIMV/developer/taxonomy/validation)
{% endcontent-ref %}