유저프로필 & 태그

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

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

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

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

아래 API를 사용하여 대량 배치 등을 통한 주기적 동기화:

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

유저프로필 API 연동 예시

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "userAttributes": [
    {
      "userId": "userid1",
      "name": "name",
      "phoneNumber": "+821011112222",
      "email": "john@example.com",
      "dob": "1990-01-01",
      "timeZone": "Asia/Seoul",
      "country": "KR",
      "language": "ko"
    }
  ]
}
'

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

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

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

{
  "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을 넣습니다.

아래 API를 사용하여 대량 배치 등을 통한 주기적 동기화:

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

클라이언트 단에서 값 변동이 일어날 때:

• Web SDK / Mobile SDK: FlareLane.setTags({ key: value }})

태그 API 연동 예시

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "tags": [
    {
      "subjectType": "user",
      "subjectId": "userid1",
      "tags": {
        "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"
      }
    }
  ]
}
'

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

• 문자열
• 숫자
• 시간 (둘 중에 하나, 정확한 포맷 준수)
  • ISO8601 타입의 문자열: ex. "2024-04-19T14:23:56+09:00"
  • millisecond 단위의 Unix Timestamp: ex. 1681721331085
• 참/거짓 (boolean)
• 배열 (타입 일치 필요: 모두 문자열 혹은 모두 숫자)
• null (태그 삭제)

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

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

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

동일 페이지 하단의 연동된 태그 리스트에서도 사용 가능한 데이터들을 확인하실 수 있습니다. 신규 태그 연동 시 일정 시간 뒤에는 자동으로 리스트에 추가되지만, 이를 기다리지 않고 직접 수동으로 리스트에 추가하여 바로 사용하는 것도 가능합니다. (다만, 수동 추가 시 리스트에 추가된 것이 데이터가 잘 연동되었다는 것을 의미하는 것은 아닙니다.)

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

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

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

• 태그 데이터는 개수 제한이 있습니다. 태그명을 동적으로 할당하여 사용하는 것은 개수 제한이 있으므로 비권장됩니다.
• 객체 배열(Array of Objects)은 향후 지원 예정입니다.