유저 정보 연동하기

블럭스 서비스에 유저 정보를 연동하는 방법을 소개합니다.

유저 정보는 CRM 메시지를 누구에게 보낼지 결정하고, 메시지 내용을 개인화하기 위해 꼭 필요한 데이터입니다.

예를 들어 “마케팅 수신 동의를 한 유저”만 골라서 메시지를 보내고 싶거나, “포인트가 1만 이상인 유저”에게만 혜택 메시지를 보내거나, “{{ name }}님, 쿠폰이 도착했어요!”처럼 유저 이름을 문구에 삽입할 때 필요합니다.

유저 정보는 크게 두 가지로 나뉘어요.

구분	설명	예시
기본 유저 정보	메시지 발송에 꼭 필요한 필수 유저 정보	전화번호, 이메일, 수신 동의, 성별, 나이 등
커스텀 유저 정보	메시지 내용을 개인화하기 위해 선택적으로 연동할 수 있는 유저 정보	이름, 생년월일, 잔여 포인트 등

예시 데이터

user_id	기본 유저 정보 (`user_properties`)	커스텀 유저 정보 (`custom_user_properties`)
1234567891	{ "phone_number": "01012341234", "email_address": "user1@blux.ai" }	{ "is_coupon_available": false }
1234567890	{ "phone_number": "01012345678", "email_address": "user2@blux.ai" }	{ "is_coupon_available": true }

연동 방식

유저의 정보를 업데이트할 때는 블럭스 SDK를 이용해요.

고객님의 서비스에서 유저 정보를 업데이트할 때, BluxClient 인스턴스의 setUserProperties() 메서드 혹은 setCustomUserProperties() 메서드를 호출하세요.

기본 유저 정보 업데이트

// 유저의 전화번호, 이메일 주소, 성별, 나이 등을 변경할 때
bluxClient.setUserProperties({
  userProperties: {
    phone_number: "01012345678",
    email_address: "user@example.com",
    gender: "male",
    age: 20,
  },
});

커스텀 유저 정보 업데이트

// 유저의 다른 정보를 변경할 때
bluxClient.setCustomUserProperties({
  customUserProperties: {
    membership_level: "GOLD",
    available_points: 12000,
    available_coupon_nos: ["1342652354", "2423231243", "3343564234"],
  },
});

기본 유저 정보

기본 유저 정보는 메시지를 보내기 위해 꼭 필요한 최소한의 정보들이 담겨있어요.

이 정보에는 채널별 수신 동의, 전화번호, 이메일 등 CRM 마케팅에서 기본적으로 활용되는 정보가 있으며, 발송을 위해 반드시 연동해야 하는 유저 정보를 미리 정의했어요.

BluxClient 인스턴스의 setUserProperties() 메서드를 활용해서 연동해주세요.

컬럼명	설명	타입	예시
phone_number	유저의 전화번호	string	`01012341234`
email_address	유저의 이메일 주소	string	`user@example.com`
gender	유저의 성별 (`male` 또는 `female`)	string	`male`
age	유저의 나이	number	`20`
marketing_notification_consent	전체 마케팅 수신 동의 여부	boolean	`true`
nighttime_notification_consent	야간 수신 동의 여부	boolean	`true`
marketing_notification_sms_consent	마케팅 문자 수신 동의 여부	boolean	`true`
marketing_notification_email_consent	마케팅 이메일 수신 동의 여부	boolean	`false`
marketing_notification_push_consent	마케팅 푸시 수신 동의 여부	boolean	`false`
marketing_notification_kakao_consent	마케팅 카카오톡 수신 동의 여부 (브랜드 메시지 발송에 활용됩니다.)	boolean	`false`

마케팅 동의 필드는 광고성 메시지 발송에 활용되며, 법적 요건과도 연결됩니다.
- 전체 마케팅 수신 동의와 채널별 마케팅 수신 동의가 모두 미설정이거나 둘 중 하나라도 false이면 해당 채널로 발송되지 않습니다.
- 한 필드가 true이고 다른 필드가 미설정인 경우에는 발송됩니다.
미설정은 해당 필드가 유저 정보에 없는 상태입니다. 정확한 동의 상태를 관리하려면 전체 마케팅 수신 동의와 각 채널의 마케팅 수신 동의를 모두 연동해 주세요.
카카오 알림톡, 친구톡, 문자 채널로 발송을 원하시는 경우, 유저의 전화번호 phone_number를 연동해주셔야 합니다.
이메일 채널로 발송을 원하시는 경우, 유저의 이메일 정보 email_address를 연동해주셔야 합니다.

(선택) 커스텀 유저 정보

커스텀 유저 정보는 서비스 특성과 마케팅 전략에 따라 유연하게 추가 가능한 속성이에요.

예를 들어 다음과 같은 캠페인에 활용할 수 있어요:

‘쿠폰 보유자’만 대상으로 리마인드 메시지 발송
회원 등급이 GOLD인 유저 대상 혜택 안내
포인트가 5,000 이상인 VIP 고객 오디언스 분리

BluxClient 인스턴스의 setCustomUserProperties() 메서드를 활용해서 연동해주세요.

컬럼명	설명	타입	예시
name	유저의 이름	string	`홍길동`
birth_date	유저의 생년월일	date	`1994-11-15T00:00:00.000+00:00`
available_points	잔여 포인트	number	`12000`
available_coupon_nos	보유 쿠폰 번호	string[]	`["1342652354", "2423231243", "3343564234"]`

* 연동 가능한 타입은 String, Number, Boolean, Date, Array of String 타입이에요.

* 이외의 타입으로 연동하고자 하시는 경우 블럭스 담당자에게 문의해주세요.

💡 Tip. 커스텀 유저 정보는 마케팅 전략에 따라 자유롭게 정하실 수 있어요.

기존 유저 목록 연동

SDK 설치 이전 가입자나 외부 CRM 유저도 연동할 수 있어요.

언제 필요한가요?

SDK 설치 전에 가입한 유저에게 메시지를 보내고 싶을 때
자동 연동되지 않는 유저 데이터가 있을 때 (ex. 외부에서 생성된 계정 등)
휴면 유저 대상 리마인드 메시지를 보낼 때

고객님 서비스의 기존 유저 목록을 연동하는 방식은 2가지에요.

AWS S3 버킷에 유저 목록을 업로드하기 (상품 정보 연동하기에 안내된 방식과 동일해요.)
.csv 파일을 블럭스 담당자에게 전달하기

* 유저 정보는 보안상의 이유로, URL 접근 방식을 사용하지 않아요.

* 신규로 가입하는 유저는 signIn() 메서드가 호출될 때, 자동으로 연동돼요.

예시 데이터

user_id	phone_number	email_address	name
1234567890	01012345678	user@example.com	홍길동
1234567891	01012345679	user2@example.com	이순신
1234567892	01012345680	user3@example.com	김철수
1234567893	01012345681	user4@example.com	박영희

* 기존 유저 목록을 연동할 때는 SDK를 통해서 연동하는 유저 정보와 동일한 필드를 추가해주세요.

* 예를 들어, 유저의 전화번호와 이메일을 SDK를 통해서 연동한 경우 CSV를 통해서 연동할 때도 동일한 값이 있어야 해요.

연동 방식​

기본 유저 정보​

(선택) 커스텀 유저 정보​

기존 유저 목록 연동​

연동 방식

기본 유저 정보

(선택) 커스텀 유저 정보

기존 유저 목록 연동