데이터 업로드

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

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

1. 직접 등록

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

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

2. CSV 업로드

Step 1. [오디언스 관리] - [Users] - 유저 데이터 관리 버튼-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
}