데이터 연동

유저프로필 & 태그

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



개념

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

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



유저 프로필

커스텀 태그

대상

유저

유저, 기기

연동 형태

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

제한 없음

유효성 검사

약속된 형태로만 가능

하지 않음

목적

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

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



유저 프로필 연동하기

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

연동 가능한 프로필



key

value

이메일

email

전화번호

phoneNumber

E.164 format (+821011112222)

생년월일

dob

YYYYMMDD (19920301)

시간대

timeZone

tz database (Asia/Seoul)

이름

name

제한없음

국가

country

언어

language

연동 방법

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

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

연동된 유저 프로필 확인

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

Document image






태그 연동하기

기기에 다양한 데이터를 제공할수록 더욱 세밀한 세그먼트 그룹핑이 가능합니다.

예를 들어 '김철수'라는 이름의 2건의 구매기록을 가진 24세의 남자 유저의 경우, 다음과 같은 형태로 설정할 수 있습니다.

태그 업데이트 시 전체 태그가 덮어씌워지는 게 아닌, 입력한 태그들이 반영됩니다. 없으면 생성되고 이미 있으면 덮어씌워집니다. 태그 삭제는 null value를 넣습니다.

{ "name": "김철수", "gender": "male", "age": 24, "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" }

연동 방법

기기 및 유저 대상 태그 업데이트 시 동작 차이

태그는 단일 기기는 물론 유저 대상으로도 업데이트가 가능합니다.

유저 차원의 업데이트는 동일한 유저ID를 가진 모든 최근 기기에 태그 업데이트가 동시에 일어나게 됩니다.

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

연동 가능 데이터 타입

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

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


연동된 태그 확인

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

Document image



태그로 자유로운 세그먼트 그룹 만들기

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

Document image



태그로 메시지 개인화

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

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

Document image



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

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