데이터 업로드

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

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

STEP 1. 유저 데이터 속성 정의 >

STEP 2. 유저 데이터 업로드 >

---

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

---

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 파일 업로드

개발자 도움 필요

• API 연동 작업
• 이벤트 호출 작업 (해당 방법에 대한 안내가 필요하다면, [e-mail] 로 요청 부탁드립니다.)

② 직접 등록

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

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

③ CSV 업로드

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

237B

UserIntegrationData_template.csv

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

템플릿 이용 유의사항

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

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

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

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

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

⚠️ 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

profileNo

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

authToken

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

JSON Object

• 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 업로드 등 수동으로 유저 데이터를 업데이트한 내역에 대해 확인할 수 있습니다.

---

유저데이터 초기화

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

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