데이터 연동 및 정합
이 페이지에서는 데이터 연동 후 정합하는 과정을 안내합니다.
사전작업
이벤트, 유저 텍소노미 개요 확인 및 연동
체크리스트를 가이드할 때에는, 아래 문서의 내용을 모두 이해하고 있다고 가정합니다. 문서에서는 텍소노미가 무엇인지, 어떻게 확인할 수 있는지에 대한 내용을 설명하고 있습니다.
Event 및 User 텍소노미 개요또한, 이미 서버 및 SDK를 통해 이벤트를 전송할 준비가 되어있어야 합니다. 만약 연동을 시작하지 않았다면, 아래 문서를 통해 서버 및 SDK를 통해 이벤트를 전송하는 방법을 확인해주세요.
SDK에서 Event 및 User 데이터 연동 방법서버에서 Event 및 User 데이터 연동 방법계정 및 프로젝트 준비
연동을 한 프로젝트와, 해당 프로젝트에 접근할 수 있는 계정을 준비해야 합니다.
데이터 분리가 필요한 경우 테스트용 프로젝트를 설정하는 것을 권장하며, 이때 두 프로젝트간의 설정 차이가 존재하지는 않는지 반드시 확인해야 합니다. 테스트 프로젝트에 존재하는 이벤트가, 프로덕션 프로젝트에 존재하지 않는 경우 이벤트 (혹은 속성이) 올바르게 연동되지 않을 수 있습니다.
연동 확인의 중요성
데이터 연동 검증은 단순한 형식적인 절차가 아니라, Marketap을 실서비스에 투입하기 전 반드시 거쳐야 하는 안전장치입니다.
첫째, 초기 오디언스의 정확도를 확보하기 위해서입니다. 잘못 매핑된 식별자나 누락된 속성으로 오디언스를 생성하면, 캠페인 대상이 엉뚱한 고객으로 오염되어 초반 성과가 급격히 하락하고 이후 모든 분석 지표의 신뢰도가 떨어집니다.
둘째, 개인정보 보호와 마케팅 규제에 대응하기 위해서입니다. 특히 수신 동의 여부나 삭제 요청이 제대로 반영되지 않으면, 불특정 다수에게 광고 메시지가 발송되어 과태료나 브랜드 신뢰도 하락 같은 법적·사업적 리스크가 발생할 수 있습니다.
셋째, 보고서와 의사결정의 기반이 되는 데이터 정확성을 보장하기 위해 필요합니다. 이벤트나 유저가 일부라도 빠지면 KPI 추세 분석이 왜곡되어 향후 마케팅 전략이 잘못된 방향으로 설계될 수 있습니다.
결국 연동 체크는 캠페인 성과, 규제 준수, 데이터 신뢰성이라는 세 축을 동시에 지키는 과정이며, 이를 통해 Marketap이 제공하는 세분화 마케팅과 분석의 가치를 온전히 누릴 수 있습니다.
단계별 연동 확인 순서
시작하기 전, 마켓탭에 적제된 이벤트를 확인하는 방법을 아래 문서를 통해 숙지해주세요.
Event, User 및 Device 연동 현황 모니터링1. 첫 이벤트 적재, 이벤트 속성 정합 확인
자동 수집 이벤트 및 속성 확인
설치 및 초기화 가이드를 따라서 SDK를 첫 설치를 했다면, Marketap SDK가 자동으로 수집하는 이벤트(mkt_start_session 및 mkt_first_visit)가 이미 적재되어 있을 것입니다.
위와 같은 이벤트를 확인하였다면 SDK를 성공적으로 설치하였습니다 🎉
이벤트가 확인되지 않나요?
SDK 설치 및 초기화 가이드에서 제공하는 Marketap SDK의 Initalize 함수 호출을 하였는지 확인해주세요.
Initialize시에 사용한 Project ID가 실제 해당 프로젝트의 ID인지 다시 확인해주세요.
Marketap은 이벤트를 수집 및 처리하는데 5~10분정도 소요됩니다.
첫 이벤트 적재 및 속성 확인
SDK의 이벤트 연동 방법 가이드를 따라서 첫 이벤트를 측정하고, 마켓탭에서 확인하여봅니다. 아래 예시는 마켓탭의 SDK를 통해 "mkt_page_view" 이벤트를 측정한 결과입니다.
Web SDK의 경우 domain, referrer 등 페이지 관련 속성을 자동으로 수집합니다.
위와 같은 이벤트 및 속성을 확인하였다면, 첫 이벤트를 성공적으로 측정하였습니다 🎉 mkt_page_view 이벤트 뿐만 아니라, 다양한 커스텀 이벤트 및 이벤트 속성을 사용할 수 있습니다.
이벤트 또는 이벤트 속성이 확인되지 않나요?
앞선 단계를 정확하게 마무리했는지 확인해주세요.
만약 커스텀 이벤트 (
mkt_로 시작하지 않는 이벤트)를 측정하였다면, 해당 이벤트가 마켓탭의 콘솔에 등록된 이벤트인지 확인해주세요.만약 속성이 확인되지 않는다면,
해당 이벤트 속성이 마켓탭의 콘솔에 등록된 이벤트 속성인지 확인해주세요.
해당 이벤트 속성의 타입이 SDK에서 요청에 사용한 값의 타입과 일치하는지 확인해주세요.
해당 이벤트 속성이 "아이템 하위" 속성인지 확인해주세요. 마켓탭은 아이템 하위 속성과 일반 속성을 구분하고 있습니다. 자세한 내용은 이벤트 수집 페이지에서 확인해주세요.
마켓탭은 등록된 이벤트가 아닌 경우 해당 이벤트를 무시합니다. (관련 문서)
2. 첫 유저 적재, 유저 속성 정합 확인
첫 유저 적재
SDK의 유저 적재 방법 가이드에 따라 SDK를 통해 login 또는 identify 함수를 실행하고, 마켓탭에서 확인하여 봅니다. (아래 예시에서는 SDK를 통해 login을 호출하였습니다.)
위와 같이 유저 목록에서 해당 user id를 확인하였다면, 첫 유저를 성공적으로 등록하였습니다 🎉
마켓탭은 이름, 전화번호, 이메일과 같은 유저 민감 정보는 분석계에서 마스킹 처리하고 있습니다.
또한, login 함수를 사용하였기 때문에 위와 같이 이벤트 목록에서 mkt_login 이벤트와 로그인한 user id를 확인할 수 있습니다.
만약 identify 함수를 통해 유저를 등록하였다면, login 이벤트는 등록되지 않습니다.
3. 시나리오에 따른 유저 id의 변화 확인
마켓탭 SDK는 유저의 등록 상태를 내부적으로 관리하면서, 이벤트를 일으킨 주체를 추적하고 있습니다. 따라서, 이벤트에서 함께 노출되는 user_id 값은 이 등록 상태를 기반으로 측정합니다. 관련된 자세한 내용은 여기 문서에서 확인해주세요.
비회원 > 로그인 > 회원 > 로그아웃 > 비회원 시나리오 확인
SDK의 유저와 기기간의 관계를 이해하고 설정한 플랫폼에서는 비회원상태의 유저가 로그인, 로그아웃 과정을 거침에 따라 발생시킨 이벤트에 user_id 값이 잘 반영되어 있어야 합니다. 아래는 올바르게 연동된 프로젝트에서 확인할 수 있는
page view(비회원) > 로그인 > page view(회원) > 로그아웃 > page view(비회원) 시나리오
의 이벤트 현황입니다.
프로젝트마다 연동된 이벤트 상황에 따라 상이할 수 있지만, 위와 같이 로그인과 로그아웃 시점 사이에서 user id를 확인하였다면, 로그인 및 로그아웃 상황을 성공적으로 연동하였습니다 🎉
다양한 로그인 방식 테스트
연동할 몰의 특성에 따라 다양한 로그인 방식이 존재할 수 있습니다.
(카카오 로그인, 네이버 로그인, 구글 로그인 등) 로그인 방식 마다 로그인이 완료된 이후에도 정상적으로 로그인 로직이 동작하는지 확인해주세요.
자동로그인 (혹은 세션에 의한 자동 로그아웃) 과 같은 로직을 사용하는 경우, 유저의 로그인 상태가 변화할 때에도 마켓탭 SDK가 유저의 연결 상태를 적절하게 유지하는지 확인해주세요.
마켓탭은 기기의 로컬 스토리지를 통해 id를 추적합니다. 따라서 자동 로그아웃이 수행된 경우에 반드시
resetIdentity함수를 호출해주어야 합니다.
이외에도 유저가 로그인되어있는 상태이지만, 마켓탭의 SDK에 user id가 등록되지 않는 시나리오가 있을지 반드시 확인해야 합니다.
4. 유저 속성의 업데이트 확인
유저 속성 업데이트
login 시점 뿐만 아니라 유저의 속성이 바뀌는 시점에도 SDK를 통해 유저 속성의 변경을 안내해야 합니다. 유저가 만약 구매를 통해 포인트를 획득하여, identify 함수를 통해 사용 가능 포인트를 2000으로 수정하였다면 아래와 같이 사용 가능한 포인트가 2000으로 업데이트 됩니다.
identify 함수 혹은 API를 사용하여 유저의 속성을 업데이트 한 뒤 현황에서 변경사항을 확인하면 유저 속성의 변경에 대한 상황을 성공적으로 연동하였습니다 🎉
유저 삭제 확인
유저 삭제 API를 통해 유저를 삭제하였다면, 데이터 처리 시간 이후에 유저 현황을 통해 유저가 삭제된 내역을 확인할 수 있습니다.
5. 액션 정합성 확인
SDK는 데이터 수집 뿐만 아니라 인앱메세지와 푸시메세지 노출 또한 담당하고 있습니다. 아래 가이드를 통해 인앱메세지 및 푸시메세지가 올바르게 동작하는지 확인해주세요.
서버를 통해 이벤트를 전송한 경우, 인앱메세지는 동작하지 않습니다.
6. 배포 후 지표 점검
지금까지
시나리오에 따라 이벤트 및 유저 데이터가 잘 수집되는 것을 확인
SDK가 캠페인 설정에 따라 메세지를 잘 노출하는 것을 확인
하였습니다. 이제 프로덕션에서 데이터를 수집할 차례입니다. 마켓탭의 SDK가 포함된 버전을 프로덕션에 배포한 뒤에 배포 사항이 잘 반영되었는지는 먼저 분석 지표를 통해 알아볼 수 있습니다.
콘솔의 인사이트 > 요약분석 탭에서는 하루 전날의 이벤트 및 유저정보를 바탕으로 요약된 분석 지표를 제공하고 있습니다. 지표에서 수집된 값 (매출액, DAU/PV 등)과 내부적으로 관리하는 데이터가 있다면, 알려진 지표와 크게 차이가 없는지 확인했다면 프로덕션에 성공적으로 배포하였습니다. 🎉
배포 프로젝트와 테스트 프로젝트가 다른 경우, 두 프로젝트의 이벤트 / 이벤트 속성 / 유저 속성 설정이 동일한지 확인해야 합니다.
이어서 진행하기
데이터를 연동하는 과정에서 자주나오는 이슈 및 해결 방법은 아래 페이지에서 확인해주세요.
데이터 연동 트러블 슈팅Last updated
Was this helpful?