고객 데이터 연동

유저프로필 & 태그

이름, 생년월일부터 잔여 포인트, 레벨, 광고성 수신 동의 여부 등 고객을 정의하는 값은 유저 프로필 및 커스텀 태그를 통해 연동합니다. 이를 통해 세그먼트 그룹을 나누거나 메시지 발송을 자동화할 수 있습니다.



유저 프로필과 태그의 차이

플레어레인을 고유한 데이터베이스로 사용하지 마세요. 중요한 데이터는 내부적으로 저장하고, 태그는 내부DB 기반으로 동기화하는 개념으로 사용하는 것을 권장합니다.

유저 프로필은 전화번호, 생년월일 등 약속된 형태로 연동하여 다양하게 활용되는 특수 데이터이며, 그 외의 자유로운 데이터는 커스텀 태그를 연동합니다.



유저 프로필

커스텀 태그

대상

유저

유저, 기기

규격

정해져있음

자유로움

연동 데이터

일부 데이터만 가능 (전화번호, 생년월일, 시간대 등)

제한 없음

목적

전화번호 발송, 생일 세그먼트 등

세그먼트(태그), 개인화 메시지 등



유저 프로필 연동하기

플레어레인 내 다양한 기능과 긴밀히 연결되는 유저 전용 데이터는 형식에 맞춰 아래 유저 프로필 데이터를 연동합니다.

연동 가능한 프로필



key

value

이메일

email

전화번호

phoneNumber

E.164 format (+821011112222)

생년월일

dob

YYYY-MM-DD (1992-03-01)

시간대

timeZone

tz database (Asia/Seoul)

이름

name

제한없음

국가

country

언어

language

연동 방법

track API의 userAttributes 값을 사용합니다.

  • REST API: POST /v1/projects/PROJECT_ID/track

연동된 유저 프로필 확인

유저 리스트에서 연동된 유저 속성을 확인할 수 있습니다.

Document image



태그 연동하기

유저프로필 외 구매 기록, 보유 쿠폰 리스트, 광고성 수신 동의 여부 등 자유로운 형태의 속성값은 태그로 연동합니다. 연동된 태그를 바탕으로 더욱 세밀한 세그먼트 타겟팅을 수행하거나 초개인화 메시지 변수로 활용할 수 있습니다.

태그 예시는 아래와 같습니다.

{ "gender": "male", "order_count": 2, "liked_products": [1,2,3], "coupon_names": ["쿠폰1","쿠폰2","쿠폰3"], "firstPurchasedAt": "2024-04-19T14:23:56+09:00" "ad_agreement_datetime": "2024-04-19T14:23:56+09:00" }

연동 방법

track API의 tags 값을 사용할 수 있으며 SDK로도 추가가 가능합니다.

태그 연동 시 입력한 태그들만 반영됩니다. 태그 삭제는 value에 null을 넣습니다.

연동 가능 데이터 타입

태그는 다음 데이터 타입이 지원됩니다.

  • 문자열
  • 숫자
  • 시간 (millisecond 단위의 Unix Timestamp: ex. 1681721331085)
  • 시간 (ISO8601 타입의 문자열: ex. 2024-04-19T14:23:56+09:00)
  • 배열 (타입 일치 필요: 모두 문자열 혹은 모두 숫자)
  • null (태그 삭제)


유저ID 연동 시나리오별 기기 태그 변화

유저ID 연동 시나리오에 따라 현재 기기의 태그가 함께 변동됩니다. 자세한 내용은 유저ID 시나리오별 기기 태그 변화 가이드를 참고해주세요.

가급적 유저ID에 따른 통일성 있는 태그 관리를 권장드리나, 만약 기기별 태그 관리가 필요한 경우에는 태그 key 앞에 @device_ 를 붙여주시면 본 정책이 적용되지 않습니다.



연동된 태그 확인

전체 기기 리스트에서 연동된 태그를 확인할 수 있습니다.

Document image



활용법 1) 세그먼트 그룹 생성

세그먼트 에서 태그 필터를 통해 다양한 형태의 자유로운 그룹을 만들 수 있습니다. 등호, 부등호와 존재 여부 등 다양한 기준으로 조건을 만들 수 있습니다.

Document image



활용법 2) 메시지 개인화 변수

연동된 태그는 초개인화 메시지 문법을 통해 메시지 내용에 반영할 수 있습니다.

사용법: {{ tags.태그명 || 기본값 }}

Document image