이벤트 스키마

본 문서는 flarelane이 발행하는 이벤트 스키마를 정의합니다 1\ crm 이벤트 스키마 컬럼 타입 구분 설명 id string 공통 이벤트 고유 식별자 (ulid) type string 공통 이벤트 타입 예 push sent (§4) channel string 공통 채널 판별자 push / sms / kakaoalimtalk / kakaobrandmessage / email / iam time string 공통 이벤트 발생 시각 (rfc 3339, utc) deviceid string 공통 플레어레인 기기 식별자 userid string 공통 플레어레인 사용자 식별자 (미식별 사용자 시 null) campaign id string 공유 캠페인 식별자 campaign name string 공유 캠페인 명칭 trigger type string 공유 발송 트리거 api / console / test / journey / recurring / system journey id string 공유 자동화 식별자 journey name string 공유 자동하 명칭 journey step id string 공유 자동화 액션 식별자 journey enrollment id string 공유 자동화 실행 식별자 recurring message id string 공유 반복 발송 메시지 식별자 sender string 공유 발신자 sms=발신번호, email=발신 이메일 (§6) recipient string 공유 수신자 sms/kakao=수신번호, email=수신 이메일 (§6) subject string 공유 제목 push/sms/email=제목, 알림톡=강조표기형 제목, 브랜드메시지=헤더 (§6) body string 공유 본문 (interpolation 이전 원본) email은 미포함 (§6) template id string 공유 템플릿 식별자 (push / kakaoalimtalk / email) template name string 공유 템플릿 명칭 (push / kakaoalimtalk / email) provider string 공유 푸시 공급자 fcm / apns / webpush ( push 전용 ) provider message id string 공유 공급자 측 메시지 id ( push 전용 ) provider error string 공유 공급자 측 오류 메시지 ( push 전용 ) error string 공유 오류/실패 사유 (failed·undelivered·aborted 시) platform string 공유 단말 플랫폼 android / ios / webdesktop / webmobile message type string 공유 메시지 유형 sms= sms / lms / mms , kakao=메시지 유형 is advertisement boolean 공유 광고 여부 (sms / 브랜드메시지) kakaoalimtalk template code string 채널 고유 카카오 검수 템플릿 코드 ( 알림톡 전용 ) kakao sender key string 채널 고유 카카오 발신 프로필(채널) 키 ( 브랜드메시지 전용 ) iam group string 채널 고유 인앱 그룹/분류 ( inappmessage 전용 ) iam clickable id string 채널 고유 cta 버튼 식별자 ( iam clicked 전용 ) iam dont show minutes int 채널 고유 "다시 보지 않기" 분 단위 값 ( iam closed 전용 ) 0/null이면 단순 닫기, 양수면 n분 미노출 projectid string 파티션 플레어레인 프로젝트 식별자 date string 파티션 time 에서 파생된 yyyy mm dd (utc) 2\ 이벤트 타입 channel 값은 push / sms / kakaoalimtalk / kakaobrandmessage / email / iam 중 하나입니다 created 발송 요청 생성 sent provider 정상 접수 aborted 빈도 제한 / 수신 거부 / liquid 중단 등 정책·조건 사유로 발송하지 않음 사유는 error 에 담김 failed provider 오류로 발송 실패 delivered / undelivered 수신 단말 전달 성공/실패 3 1 push ( channel=push ) type 설명 push created 푸시 발송 요청 생성 (pns 호출 전) push sent 푸시 발송 성공 (pns 정상 응답) push aborted 푸시 발송 중지 (빈도 제한/수신 거부/liquid 등) push failed 푸시 발송 실패 (provider/기술 오류) push clicked 사용자가 푸시를 클릭함 3 2 sms ( channel=sms ) type 설명 sms created sms 발송 요청 생성 (provider 호출 전) sms sent provider에 정상 접수됨 sms aborted 발송 중지 (빈도 제한/수신 거부/liquid 등) sms failed provider 접수 실패 sms delivered 수신 단말에 전달 완료 (provider 콜백 기반) sms undelivered 수신 단말 전달 실패 (provider 콜백 기반) 3 3 kakao 알림톡 ( channel=kakaoalimtalk ) type 설명 kakaoalimtalk created 알림톡 발송 요청 생성 (provider 호출 전) kakaoalimtalk sent provider에 정상 접수됨 kakaoalimtalk aborted 발송 중지 (빈도 제한/수신 거부/liquid 등) kakaoalimtalk failed provider 접수 실패 kakaoalimtalk delivered 수신 단말에 전달 완료 (provider 콜백 기반) kakaoalimtalk undelivered 수신 단말 전달 실패 (provider 콜백 기반) 3 4 kakao 브랜드 메시지 ( channel=kakaobrandmessage ) type 설명 kakaobrandmessage created 브랜드 메시지 발송 요청 생성 (provider 호출 전) kakaobrandmessage sent provider에 정상 접수됨 kakaobrandmessage aborted 발송 중지 (빈도 제한/수신 거부/liquid 등) kakaobrandmessage failed provider 접수 실패 kakaobrandmessage delivered 수신 단말에 전달 완료 (provider 콜백 기반) kakaobrandmessage undelivered 수신 단말 전달 실패 (provider 콜백 기반) 3 5 email ( channel=email ) type 설명 email created 이메일 발송 요청 생성 email sent provider 접수 완료 email delivered 수신 메일서버에 전달 완료 email failed provider 접수 실패 email aborted 발송 중지 (빈도 제한/수신 거부/liquid 등) email complaint 스팸 신고 발생 email opened 수신자가 이메일을 열람함 email clicked 수신자가 이메일 내 링크를 클릭함 3 6 inappmessage ( channel=iam ) type 설명 iam created 인앱 메시지 노출 요청 생성 (서버 측) iam displayed 사용자 단말에서 인앱이 노출됨 (sdk 이벤트) iam clicked 사용자가 인앱 cta 버튼을 클릭함 (sdk 이벤트) iam closed 사용자가 인앱을 닫음 (sdk 이벤트) 4\ 채널별 컬럼 사용 각 채널이 채우는 컬럼과 의미입니다 표에 없는 컬럼은 해당 채널에서 항상 null 입니다 4 1 push 컬럼 필수 설명 campaign id required 캠페인 식별자 campaign name optional 캠페인 명칭 template id optional 템플릿 식별자 template name optional 템플릿 명칭 subject optional 푸시 제목 (interpolation 이전 원본) body optional 푸시 본문 (interpolation 이전 원본) trigger type optional api / console / test / journey 등 journey optional 자동화 컨텍스트 recurring message id optional 반복 발송 메시지 식별자 platform required 단말 플랫폼 provider optional 푸시 공급자 (fcm / apns / webpush) provider message id optional 공급자 측 메시지 id provider error optional 공급자 측 오류 메시지 error optional 오류/실패 사유 4 2 sms 컬럼 필수 설명 campaign id required 캠페인 식별자 campaign name optional 캠페인 명칭 message type required 메시지 유형 sms / lms / mms subject optional lms/mms 제목 body required 본문 (interpolation 이전 원본) sender required 발신 번호 recipient optional 수신 번호 is advertisement required 광고 여부 trigger type optional 발송 트리거 journey optional 자동화 컨텍스트 recurring message id optional 반복 발송 메시지 식별자 platform optional 단말/발송 플랫폼 error optional 오류/실패 사유 4 3 kakao 알림톡 컬럼 필수 설명 campaign id required 캠페인 식별자 campaign name optional 캠페인 명칭 template id required 플레어레인 내부 템플릿 식별자 kakaoalimtalk template code required 카카오 검수 템플릿 코드 template name optional 템플릿 명칭 subject optional 강조표기형 제목 body required 본문 (interpolation 이전 원본) recipient required 수신 번호 message type required 메시지 유형 trigger type optional 발송 트리거 journey optional 자동화 컨텍스트 recurring message id optional 반복 발송 메시지 식별자 platform optional 단말/발송 플랫폼 error optional 오류/실패 사유 4 4 kakao 브랜드 메시지 컬럼 필수 설명 campaign id required 캠페인 식별자 campaign name optional 캠페인 명칭 kakao sender key optional 카카오 발신 프로필(채널) 키 body required 본문 (interpolation 이전 원본) subject optional 메시지 헤더 recipient required 수신 번호 message type required 메시지 유형 is advertisement optional 광고 여부 trigger type optional 발송 트리거 journey optional 자동화 컨텍스트 recurring message id optional 반복 발송 메시지 식별자 platform optional 단말/발송 플랫폼 error optional 오류/실패 사유 4 5 email 컬럼 필수 설명 campaign id required 캠페인 식별자 campaign name optional 캠페인 명칭 template id required 템플릿 식별자 template name optional 템플릿 명칭 subject optional 메일 제목 sender required 발신 이메일 주소 recipient optional 수신 이메일 주소 trigger type optional 발송 트리거 journey optional 자동화 컨텍스트 recurring message id optional 반복 발송 메시지 식별자 platform optional 단말/발송 플랫폼 error optional 오류/실패 사유 참고 메일 본문( body )은 크기가 커 포함되지 않습니다 4 6 inappmessage 컬럼 필수 설명 campaign id required 캠페인 식별자 campaign name optional 캠페인 명칭 iam group required 인앱 그룹/분류 trigger type optional console / journey (인앱은 두 가지만 사용) journey optional 자동화 컨텍스트 platform optional 단말 플랫폼 sdk 이벤트 시에만 채워짐 ( iam created 에서는 null) iam clickable id optional cta 버튼 식별자 iam clicked 전용 iam dont show minutes optional "다시 보지 않기" 분 단위 값 iam closed 전용 0/null이면 단순 닫기, 양수면 n분간 미노출 고객 이벤트 고객 이벤트(커스텀 트래킹 이벤트)는 스키마리스 data 속성을 가지며, crm events 와 별도 파이프라인으로 적재됩니다 1\ 고객 이벤트 필드 타입 필수 설명 id string required 이벤트 고유 식별자 (ulid) type string required 이벤트 타입 time string required 이벤트 발생 시각 (rfc 3339, utc) projectid string required 플레어레인 프로젝트 식별자 userid string optional 플레어레인 사용자 식별자 (미식별 사용자 시 null) deviceid string optional 플레어레인 기기 식별자 data string optional 이벤트 발행 시 함께 전달한 커스텀 속성 객체 키·값·타입을 자유롭게 정의하는 스키마리스 값으로, 직렬화(stringify)하여 단일 string 컬럼으로 저장 platform string optional 단말 플랫폼 android / ios / webdesktop / webmobile