# 서버에서 Event 및 User 데이터 연동 방법

## 사전 작업 <a href="#pre-work" id="pre-work"></a>

### 프로젝트 텍소노미 확인 <a href="#taxonomy" id="taxonomy"></a>

데이터를 연동하기 전, 현재 프로젝트에서 어떤 이벤트와 속성이 연동이 가능한지 확인해야 합니다. 아래 페이지에서 반드시  사용가능한 이벤트와 속성을 확인해주세요.

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

{% hint style="danger" %}
Marketap은 **정의되지 않은 이벤트와 속성을 수집하지 않습니다**. 반드시 이벤트를 연동하기 전 프로젝트에 정의된 텍소노미를 확인해주세요.
{% endhint %}

## 1. 인증

서버로 데이터를 전송하는 경우, 인증 토큰을 함께 전달해야 합니다. 먼저 아래 페이지를 참고하여 유효한 토큰을 준비해주세요.

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

## 2. 데이터 연동

{% hint style="success" %}
서버로부터 수집된 이벤트는 인앱메세지 캠페인의 조건을 만족하더라도 유저가 해당 캠페인을 확인할 수 없습니다. 따라서 마켓탭은 기본적으로 **SDK를 통한 이벤트 연동**을 권장합니다.&#x20;

SDK에서 알 수 없거나, 정확한 정합이 필요한 경우에 서버를 통한 이벤트 전달을 사용해주세요.
{% endhint %}

### 2-1 유저 및 이벤트 연동

마켓탭은 API를 통해 유저 정보를 업데이트하고, 유저의 행동 데이터를 전달할 수 있는 기능을 제공합니다.

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

이 기능을 활용하여 플랫폼 연동을 완료한 후 과거에 활동하였던 유저 데이터의 마이그레이션이 가능합니다.

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

또한, 유저가 탈퇴하거나 관련 정보를 삭제를 요구한 경우 API를 통해 삭제가 가능합니다.

{% hint style="warning" %}
유저 데이터를 삭제하는 기능은 보안상의 이유로 SDK에서 제공하지 않습니다. 탈퇴 및 삭제처리는 API를 활용해주세요.
{% endhint %}

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

마켓탭 설치 이전에 고객사에서 수집한 기기 토큰을 마이그레이션하여, 전체 대상 푸시 메시지 발송에 활용할 수 있도록 지원하는 API를 제공합니다.

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

## 3. 연동 결과 확인

서버에서 연동한 데이터도 마찬가지로 잘 반영이 되었는지 확인해야 합니다. 아래 문서를 통해 서버로 전달한 데이터가 마켓탭에 올바르게 반영되었는지 확인해주세요.

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