데이터 업로드

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

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


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


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' 확인 후 로드해주시길 바랍니다.

2️⃣ 회원아이디 MBID를 포함한 템플릿의 열 개수를 선택하고 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

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

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


유저데이터 초기화

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

Last updated

Was this helpful?