이벤트 속성 전송¶

개요¶

게임 이벤트 로그는 필수 속성, 사용자 정의 속성으로 구성됩니다. Hive SDK v4를 연동하면 별도 전송 없이도 자동으로 수집되는 속성이 추가됩니다.

필수 속성¶

게임 이벤트 로그를 전송할 때 반드시 포함 해야 하는 속성입니다.

eventName 명명 규칙¶

eventName에 사용할 이벤트명은 아래 규칙을 따라 작성할 것을 권고합니다.

• 권장 문자: 영문(a–z, A–Z, 대/소문자 구분), 숫자(0–9), 언더바(_)
• 구분자: 단어 사이는 공백이 아닌 언더바(_)로 구분
• 형태: 이벤트를 명확하게 설명하는 명사_동사 형태 권장
• 예시: item_purchase, level_up, tutorial_complete, stage_start

eventTime 형식 규칙 (RFC 3339)¶

eventTime은 RFC 3339 형식을 따르며, 반드시 타임존 정보를 포함해야 합니다.

형식:

YYYY-MM-DDTHH:MM:SS[.sss]+HH:MM 또는 YYYY-MM-DDTHH:MM:SSZ

허용 예시:

2026-07-20T14:01:01+09:00       (KST, 한국 표준시)
2026-07-20T05:01:01Z            (UTC)
2026-07-20T14:01:01.123+09:00   (밀리초 포함)
2026-07-20T23:01:01-05:00       (미국 동부 시간)

허용되지 않는 예시:

2026-07-20 14:01:01              (타임존 없음 → 격리)
2026-07-20                       (시간 없음 → 격리)
1719835261                       (Unix timestamp → 격리)
14:01:01                         (날짜 없음 → 격리)

eventTime¶

• eventTime은 파이프라인에서 UTC로 변환 되어 테이블의 dateTime 컬럼에 저장됩니다. 원본 값은 attributes.eventAttributes.eventTime에 그대로 보존됩니다.

사용자 정의 속성¶

게임에서 전송하고 싶은 정보를 속성명과 속성값으로 구성하여 필수 속성과 함께 직접 전송합니다.

속성명 규칙¶

사용할 수 없는 속성명 (예약어)¶

속성값 규칙¶

속성값이 JSON 객체 , JSON 배열 , JSON 형태의 문자열 형태인 경우 rescue 테이블로 격리 됩니다.

// JSON 객체 (허용되지 않음)
"info": {"key": "value"}

// JSON 배열 (허용되지 않음)
"items": [1, 2, 3]

// JSON 형태의 문자열 (허용되지 않음)
"data": "{\"key\": \"value\"}"

동일 속성명 중복 전송¶

동일한 속성명을 2개 이상 전송하면 속성값은 랜덤하게 선택되어 1개만 저장 됩니다.

Hive SDK v4 자동 수집 속성¶

클라이언트에서 Hive SDK v4로 이벤트 로그를 전송할 때만 자동 수집됩니다.

• 사용자가 동일한 속성명으로 직접 값을 전송하면, SDK가 자동 수집한 값 대신 사용자가 전송한 값 이 저장됩니다.
• 아래 속성은 테이블의 attributes.eventAttributes에 저장됩니다.

Hive SDK v4 이벤트 로그 전송 기능을 사용하는 경우, SDK가 클라이언트 디바이스에서 직접 수집하여 전송하는 속성입니다.

필수 속성¶

필수 속성 중 SDK v4가 자동으로 수집하는 속성입니다. (eventName은 제외)

사용자/계정 식별 정보¶

시간/식별 정보¶

속성명	설명	도메인	예시
dateTime	이벤트 로그 전송 시 생성되는 이벤트 발생 일시입니다. (yyyy-MM-dd HHss 형식)	Hive SDK (코어)	2026-01-01 00:00:00
guid	이벤트 로그 전송 시마다 생성되는 UUID (하이픈 제거). 이벤트 로그의 고유 식별 및 중복 제거에 사용됩니다.	Hive SDK (코어)	ecbfbd7fcdc340e1b8a433999c5290c1
is_hive_time	이벤트 로그의 타임스탬프가 Hive 서버 시간과 동기화되었는지 여부 플래그입니다. (Y/N)	Hive SDK (코어)	Y
timezone	dateTime 값의 기준이 되는 타임존 오프셋 정보입니다.	Hive SDK (코어)	GMT+09:00
is_url_encode	이벤트 로그 전송 시 URL 인코딩 적용 여부를 나타내는 플래그입니다. (Y 고정)	Hive SDK (코어)	Y

디바이스 정보¶

SDK/앱 빌드 정보¶

SDK 설정 정보¶

수신 서버 정보¶

주의사항 & Tips¶

• 필수 속성명은 카멜 케이스 또는 소문자로 전송해야 하며, 스네이크 케이스(user_id)로 보내면 rescue 테이블로 격리됩니다.
• appId 또는 appIdGroup 중 하나는 반드시 포함해야 하며, 둘 다 없으면 격리됩니다.
• eventTime은 RFC 3339 형식(타임존 포함)만 허용되며, 현재 시각 기준 과거·미래 31일을 벗어나면 격리됩니다.
• 사용자 정의 속성명으로 attributes, eventAttributes, hiveAttributes는 사용할 수 없습니다(대소문자 무관).
• 속성값은 숫자형·문자형만 허용되며, JSON 객체·배열·JSON 형태의 문자열은 격리됩니다.
• 격리된 로그를 확인하고 재전송하는 방법은 데이터 격리를 참고하세요.

연관 메뉴¶

• 이벤트 전송 — 이벤트·속성 개념 안내
• 이벤트 템플릿 — 구분별 기본 자동 수집 이벤트 목록
• 이벤트 로그 전송 — Hive SDK v4, Hive Axyl, Fluentd, HTTP를 통한 전송 방법
• 이벤트 저장 구조 — 테이블 구조, attributes 세부 속성, 데이터 격리