데이터 업로드

메시지 발송 대상 설정을 위해 유저 데이터를 업로드할 수 있습니다.

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

1. 직접 등록

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

유저 데이터를 직접 등록하기 위해서는 필요한 유저 속성 구조가 갖춰진 최초 1회 이상의 CSV 업로드 또는 API 연동이 필요합니다.

2. CSV 업로드

Step 1. [오디언스] - [유저 관리] - 유저 데이터 관리 버튼-CSV 업로드 버튼을 클릭하여 CSV 템플릿 파일을 다운로드 후 양식에 맞추어 작성합니다.

1KB

User Template_WISETRACKER.csv

파일 저장 시 위 이미지처럼 'CSV UTF-8' 로 저장하고 업로드해주시길 바랍니다.

템플릿 이용 유의사항

템플릿 파일의 첫 열에는 반드시 회원 아이디(MBID)를 입력해야 합니다.
불필요한 열은 삭제 후 업로드할 수 있습니다.
파일 업로드 전 macro#n 으로 구성된 열 명칭은 변경하지 않고, 업로드 후의 Step.3 단계에서 변경합니다.

[프리셋 Macro 데이터]

유저 데이터 중 Macro#1~ Macro#6까지는 데이터의 의미가 고정되어 있습니다. 아래의 표를 참고하여 각 Macro별 정확한 데이터가 업로드 되도록 합니다.
Macro 데이터
Macro#1
회원 이름
Macro#2
성별
Macro#3
전화번호(모바일)
Macro#4
이메일
Macro#5
주소 #1
Macro#6
주소 #2 (상세)

Macro	데이터
Macro#1	회원 이름
Macro#2	성별
Macro#3	전화번호(모바일)
Macro#4	이메일
Macro#5	주소 #1
Macro#6	주소 #2 (상세)

※ 정확한 데이터가 입력되지 않을 시 오류가 발생할 수 있으니 주의 부탁드립니다.

※ 메시지 발송시 속성을 변수로 사용할 수 있습니다. 해당 속성에 입력되지 않은 유저의 데이터가 있다면 공란으로 발송되오니 참고 부탁드립니다.

※ Macro#3 ‘전화번호’열의 셀 서식 텍스트로 지정 필요

[사용자 정의 Macro 데이터]

Macro#7부터 Macro#50까지는 사용자가 정의해서 사용 가능합니다.

※ 분석 대시보드에서 활용을 원하는 경우
: 시스템에 업로드 된 데이터를 사용하여 분석 대시보드에서 활용을 원하시면 반드시 회원가입 및 로그인 완료 이벤트의 분석 코드를 적용해야 가능합니다.
: 업로드 되는 유저 데이터의 회원아이디와 분석 대상이 되는 웹, 앱에서 회원가입 및 로그인 완료 이벤트 분석을 위한 코드에서 반드시 동일한 회원 아이디값(MBID)을 사용하여야 두 개의 데이터가 하나의 회원 아이디로 매칭되어 사용이 가능합니다.

Step 2. 회원아이디 MBID를 포함한 템플릿의 열 개수를 선택하고 CSV 파일을 업로드합니다. (※ 열 개수 일치 필수, 파일명 영어 필수)

Step 3. 업로드 한 파일의 데이터를 조회하여 볼 수 있습니다.

빈칸에는 지정할 ‘속성값’을 원하는대로 입력할 수 있습니다.
프로필 이미지는 URL을 통해 업로드해주세요.
각 열에 필드 이름을 지정할 수 있습니다. 지정된 필드 이름은 오디언스를 만들거나 마케팅 액션에서 매크로 데이터로 사용됩니다.

※ 전화번호를 비롯한 개인정보에 해당하는 열은 개인정보를 꼭 체크해주세요. 암호화하여 보관됩니다.

※ 덮어쓰여져 훼손된 데이터는 복구해드리지 않습니다. 취급에 주의해주시길 바랍니다.

3. API 연동

한번이라도 CSV로 유저 데이터 업로드하기 기능을 통해 유저 데이터를 업로드하여 이미 테이블 컬럼이 만들어져 있는 상태라면, 이후에는 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
}