Wisetracker Docs
웹사이트블로그콘솔 바로가기도입 문의이용 문의
👣 사용자 가이드
👣 사용자 가이드
  • 🛸시작하기 전에 !
    • 와이즈트래커
    • 가이드 이용 안내
    • 자주 묻는 질문 🙋🏻‍♀️
      • 회원가입
      • 어트리뷰션 링크
      • 대시보드 이용
      • 데이터
      • 오디언스
      • 카카오톡, 문자메시지
      • 앱 푸시
        • 이미지/알림 수신되지 않음 CASE
      • 개발 지원
  • 🐣와이즈트래커 시작하기
    • 회원가입 및 서비스 등록
    • 광고 성과 분석하기
      • 분석 SDK 설치
      • 매체 연동 및 활성화
      • 트래킹 링크 생성
      • 어트리뷰션 데이터 분석
    • 고객 행동 데이터 분석하기
      • 분석 SDK 설치
      • 고객 행동/속성 이벤트 연동
      • 애널리틱스 데이터 분석
      • 애널리틱스 데이터 활용
    • CRM 메시지 발송하기
      • 발신번호 등록
      • 카카오톡 채널 연동
      • 메시지 포인트 충전
      • 메시지 발송
      • 080 수신거부 번호 등록
      • 마케팅 저니 실행하기
  • 👣광고 성과 트래킹의 모든 것
    • 미디어 파트너(매체) 관리
      • 활성화 및 커스텀 채널 생성
      • 기본 설정
      • 어트리뷰션 설정 (룩백윈도우)
      • 포스트백 설정
      • 주요 미디어 파트너 설정
        • Google Ads (앱 캠페인)
        • Meta
        • Apple Search Ads
        • Naver 성과형 디스플레이 광고
        • Naver 검색광고
        • Kakao
        • Criteo
        • DV360
    • 트래킹 링크 생성하기
      • 어트리뷰션 링크 생성하기
      • 커스텀 도메인으로 브랜딩하기
    • 어트리뷰션 설정
      • iOS 14 업데이트 대응 가이드
      • 광고 에이전시 관리
  • 📊데이터 잘 활용하기
    • 서비스 핵심 성과 지표 정의
    • Attribution
      • 어트리뷰션 오버뷰
      • UA 캠페인
      • 리타게팅 캠페인
      • 리텐션
    • Analytics
      • 애널리틱스 오버뷰
      • 유저플로우
      • 전환퍼널
      • 구매자 티어
      • 디스트리뷰션
    • 커스텀 대시보드
      • 사전 정의된 대시보드 (Pre-Defined Dashboard)
        • 방문행동
        • 마케팅
        • 컨텐츠/상품
        • 유저
        • 커머스
        • 디바이스
      • 커스텀 대시보드 만들기
    • 데이터 다운로드
      • RAW 타입
      • 통계 타입
      • [legacy] 데이터 다운로드
      • 데이터 다운로드 지표 정의
    • 데이터 검증
      • 이벤트 발생 현황
  • 🧙‍♂️CRM 메시지 발송하기
    • 광고 메시지 유의사항
    • 카카오톡, 문자메시지
      • 메시지 발송 시 공통 안내사항
      • 알림톡 발송하기
      • 친구톡 발송하기
      • 문자메시지 발송하기
    • 앱 푸시
      • 앱 푸시 발송하기
      • 앱 푸시 성과 대시보드
    • 마케팅 저니 실행하기
  • 👥오디언스 생성하기
    • 오디언스 활용방법 알아보기
    • 오디언스 생성
      • 추천 오디언스 템플릿 이용하기
      • 직접 오디언스 생성하기
    • 오디언스 목록/상세/히스토리
    • 유저 관리
      • 분석서비스와의 연동
      • 유저 리스트
        • 데이터 업로드
        • 속성 필터 적용 및 그룹 생성
        • 데이터 다운로드
        • 유저 상세 화면
      • SMS 수신거부 리스트
  • ⚙️설정
    • 어플리케이션 설정
    • 메시지 설정
Powered by GitBook
On this page
  • STEP 1. 유저 데이터 속성 정의 >
  • STEP 2. 유저 데이터 업로드 >
  • ① 속성값 정의
  • 🧩사전정의 유저 속성
  • ② 직접 등록
  • ③ CSV 업로드
  • ④ API 연동
  • 유저 데이터 변경내역
  • 유저데이터 초기화

Was this helpful?

  1. 오디언스 생성하기
  2. 유저 관리
  3. 유저 리스트

데이터 업로드

유저 리스트에 유저 데이터를 업로드하면, 유저의 유니크 ID (mbid) 를 중심으로 SDK 에서 수집한 데이터와 데이터 페어링이 이루어집니다.

Previous유저 리스트Next속성 필터 적용 및 그룹 생성

Last updated 4 months ago

Was this helpful?

본격적으로 유저 데이터를 업로드하기 전, 유저 데이터 속성이 먼저 정의되어야 합니다. 아래 단계에 따라 진행해주세요! 🧭


오디언스 > 유저관리 > 유저 리스트 >유저 데이터 관리버튼을 눌러주세요.


STEP 1. 유저 데이터를 연동하기 전, 유저 데이터로 관리할 속성을 먼저 정의합니다.

① 속성값 정의

UD1 (유저속성1) 부터 UD6 (유저속성6) 까지 6개의 항목은 아래와 같이 사전 정의된 속성으로, 변경할 수 없습니다.

사전 정의 속성 이외의 추가 데이터항목이 필요한 경우, UD7 ~ UD50 속성을 정의하여 이용해주세요.

🧩사전정의 유저 속성

유저속성
값 (정의)

UD1

회원명

UD2

성별

UD3

휴대폰번호

UD4

이메일

UD5

주소

UD6

상세주소

속성 코드

사용할 속성코드를 선택합니다.

✅UD1 ~ UD6 고정 / UD50 까지 이용 가능

속성 이름

수집할 유저 데이터 속성 항목을 입력합니다. ✅UD1 ~ UD6 고정, 수정불가 / UD7 ~ UD50 커스텀 이용 가능

데이터 보관 방법

개인정보에 해당하는 속성은 암호화 적용 후 저장 옵션을 선택합니다. ⚠️해당 옵션은 이후 변경이 불가합니다. ⚠️모든 유저 속성을 암호화 처리할 경우 데이터 처리 속도가 매우 느려질 수 있습니다.

한 번 저장한 유저 속성 데이터 항목은 이후 삭제 불가합니다. 반드시 확인 후 저장해주세요.


STEP 2. 데이터 업로드

유저 데이터를 업로드하는 방법은 아래와 같습니다. 편한 방법을 선택하여 진행해주세요.

개발자 도움 필요하지 않음

개발자 도움 필요

② 직접 등록

오디언스 > 유저 관리 > 유저 데이터 관리 - 직접등록 버튼을 클릭합니다.

유저 데이터를 입력한 후, 등록 버튼을 눌러주세요.

③ CSV 업로드

1️⃣ 오디언스 > 유저 관리 > 유저 데이터 관리 - CSV 업로드 버튼을 클릭하여 CSV 템플릿 파일을 다운로드합니다.

파일 열기 시 위 이미지처럼 'UTF-8' 확인 후 로드해주시길 바랍니다.

템플릿 이용 유의사항

  • 템플릿 파일의 첫 열에는 반드시 회원 아이디(MBID)를 입력해야 합니다.

  • 불필요한 열은 삭제 후 업로드할 수 있습니다.

⚠️ 정확한 데이터가 입력되지 않을 시 오류가 발생할 수 있으니 주의해주세요.

⚠️ 메시지 발송시 속성을 변수로 사용할 수 있습니다. 해당 속성에 입력되지 않은 유저의 데이터가 있다면 공란으로 발송될 수 있습니다.

⚠️ Macro3 ‘전화번호’ 열의 셀 서식은 반드시 텍스트로 설정해주세요.

2️⃣ 회원아이디 MBID를 포함한 템플릿의 열 개수를 선택하고 CSV 파일을 업로드합니다.

  • 업로드할 템플릿의 열 개수와 일치하는지 반드시 확인해주세요.

  • 파일명은 영어로 저장해주시기 바랍니다.

  • 파일 저장 시 파일 형식은 아래와 같이 반드시 CSV (쉼표로 분리) 로 선택하여 주시기 바랍니다.

    ⚠️CSV UTF-8(쉼표로 분리) 로 설정 시 파일이 정상적으로 업로드되지 않을 수 있습니다.

예시)

아래의 파일을 업로드하는 경우, 열의 개수는 6개 로 선택합니다.

3️⃣ 업로드한 파일의 데이터가 맞게 잘 들어갔는지 확인합니다.

➊ 회원아이디(MBID) 를 비롯하여 고정값인 Macro1 ~ Macro6 의 속성명은 변경할 수 없습니다. Macro7~ Macro50 속성의 경우 변경이 가능합니다.

➋ 아래의 두 옵션 중 원하는 데이터 업로드 방식을 택하여 Start sync 버튼을 눌러주세요.

덮어쓰여져 훼손된 데이터는 복구해드리지 않으니 반드시 신중하게 진행해주세요 ! 👀

④ API 연동

METHOD
POST

HOST

https://analytics.wisetracker.co.kr/console/v1/api/userdata/apiForUserDataSync.do

Requset Parameter

*profileNo

Request Header

*authToken

Requset Body

*JSON Object

[서비스 설정] → [어플리케이션 설정]에서 서비스 번호 확인

[서비스 설정] → [메시지 설정]에서 accessToken 확인

  • mbid: 유저를 구분하는 고유(Unique)한 값입니다.

  • userdata: 유저와 관련된 데이터입니다.

  • REQUEST 예시

POST <https://analytics.wisetracker.co.kr/console/v1/api/userdata/apiForUserDataSync.do?profileNo=00000>
authToken: Q5MXn+tcAH2xxxxxxxxxxxxabcdabacdabadcdeeee=

// 첫번째 예시, Macro#1(=UD1) 칼럼을 대상으로 데이터 추가
{
  "mbid": "hongkildong",
  "userdata": {
    "UD1": "홍길동",
  }
}

// 두번째 예시, Macro#1(=UD1), Macro#3(=UD3), Macro#7(=UD7)칼럼을 대상으로 데이터 추가
{
  "mbid": "testUserId9",
  "userdata": {
    "UD1": "hongkildong",
    "UD3": "01012345678",
    "UD7": "GOLD"
  }
}
  • RESPONSE 예시

// 와이즈트래커 서버와 통신이 성공했다면, 실제 유저(User) 데이터 업로드 자체를 성공했는지와는 별개로 status와 success는 항상 200과 true가 반환됩니다. 
// 실제 성공 여부 또는 실패했다면 실패 이유는, message 키의 값을 확인해주시면 됩니다.

{
  "status": 200,
  "success": true,
  "details": "uri=/console/v1/api/userdata/apiForUserDataSync.do",
  "timestamp": "2023-07-28 13:23:53",
  "message": "유저 데이터가 업데이트 되었습니다.",
  "result": {},
  "resultCount": 0,
  "totalCount": 0,
  "lastPage": 0
}

유저 데이터 변경내역

최근 90일간 직접등록 또는 CSV 업로드 등 수동으로 유저 데이터를 업데이트한 내역에 대해 확인할 수 있습니다.


유저데이터 초기화

시스템에 저장된 유저 데이터를 모두 삭제합니다.

데이터 초기화 작업은 진행 중 취소할 수 없으며, 되돌릴 수 없으니 주의하여 사용해주시길 바랍니다.

유저 데이터 중 Macro1~ Macro6까지는 데이터의 의미가 고정되어 있습니다. Macro7 부터 Macro50 까지는 사용자가 정의해서 사용 가능합니다. 를 참고하여 각 Macro별 정확한 데이터가 업로드 되도록 합니다.

👥
직접 등록
CSV 파일 업로드
API 연동 작업
표
STEP 1. 유저 데이터 속성 정의 >
STEP 2. 유저 데이터 업로드 >
237B
UserIntegrationData_template.csv