데이터 업로드

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

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

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

① 속성값 정의

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

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

🧩사전정의 유저 속성

유저속성	값 (정의)
UD1	회원명
UD2	성별
UD3	휴대폰번호
UD4	이메일
UD5	주소
UD6	상세주소

유저속성

값 (정의)

UD1

회원명

UD2

성별

UD3

휴대폰번호

UD4

이메일

UD5

주소

UD6

상세주소

속성 코드

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

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

속성 이름

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

데이터 보관 방법

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

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

STEP 2.

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

개발자 도움 필요하지 않음

개발자 도움 필요

API 연동 작업
이벤트 호출 작업 (해당 방법에 대한 안내가 필요하다면, tech@wisetracker.co.kr 로 요청 부탁드립니다.)

② 직접 등록

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

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

③ CSV 업로드

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

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

템플릿 이용 유의사항

템플릿 파일의 첫 열에는 반드시 회원 아이디(MBID)를 입력해야 합니다.
불필요한 열은 삭제 후 업로드할 수 있습니다.
유저 데이터 중 Macro1~ Macro6까지는 데이터의 의미가 고정되어 있습니다. Macro7 부터 Macro50 까지는 사용자가 정의해서 사용 가능합니다. 표를 참고하여 각 Macro별 정확한 데이터가 업로드 되도록 합니다.

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

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

⚠️ Macro3 ‘전화번호’ 열의 셀 서식 텍스트로 지정 필요

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

업로드할 템플릿의 열 개수와 일치하는지 반드시 확인해주세요.
파일명은 영어로 저장해주시기 바랍니다.
파일형식은 반드시 CSV 이어야 합니다.

예시)

아래의 파일을 업로드하는 경우, 열의 개수는 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

METHOD

POST

HOST

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

Requset Parameter

*profileNo

Request Header

*authToken

Requset Body

*JSON Object

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

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
}