데이터 전송 준비

데이터 전송 및 규칙 이해 가이드

‍

데이터 전송을 진행하기 전에 TE(ThinkingEngine) 시스템의 데이터 전송 규칙에 대한 기본적인 이해가 필요합니다.

이 가이드는 데이터 전송과 관련된 필수 정보와 시스템 파라미터 설정을 명확히 설명하며, 비즈니스 담당자, 엔지니어, 검증 테스트 담당자 등 TE를 사용하는 모든 이해 관계자를 대상으로 합니다.

‍

‍

주요 데이터 전송 단계

‍
TE 시스템에서 데이터 전송은 다음의 세 단계로 나뉩니다.

1. 데이터 트래킹 정책 수립: 비즈니스 요구에 따라 수집할 데이터를 결정합니다. 필요시 TE 분석가의 지원을 받을 수 있습니다.

2. 엔지니어링 구현: 수립된 정책을 기반으로 엔지니어가 데이터 트래킹을 구현합니다.

3. 데이터 정확성 검증: 데이터를 전송한 후, 수집된 데이터가 정확한지 검증합니다.

‍

‍

TE 데이터 전송 방법

‍
TE는 프론트엔드에서 다양한 데이터 전송 방식을 제공합니다.

• 클라이언트 SDK: 서버와 통신하지 않고, 디바이스 정보나 사용자 행동 데이터를 수집합니다.
• 서버 SDK: 서버와 통신하여 더 정확한 사용자 행동 데이터를 수집합니다.
• 데이터 수집 도구: LogBus와 같은 도구를 사용하여 과거 히스토리 데이터 및 대규모 데이터를 배치 작업으로 처리합니다.

‍

서버에서 데이터를 수집할 때는 서버 SDK와 LogBus를 함께 사용하는 것을 권장하며, 이를 통해 데이터의 안정성, 실시간성, 효율성을 극대화할 수 있습니다. 과거 데이터를 추가로 수집할 때는 DataX를 사용할 수 있지만, 실시간성은 보장되지 않는다는 점을 주의해야 합니다.

데이터 수집 방법을 설계할 때는 앱의 기술 아키텍처와 비즈니스 요구에 적합한 방식을 선택하는 것이 중요합니다. 관련 질문이 있을 경우 TE 매니저에게 문의해 주세요.

‍

‍

TE 데이터 모델 이해

‍
데이터 전송 전에 TE의 데이터 테이블 구조를 이해하는 것이 필수적입니다. TE에서는 유저 데이터를 유저 테이블(User Table)과 이벤트 테이블(Event Table)로 구분하여 저장합니다.

• 유저 테이블: 자주 변경되지 않는 사용자 속성이나 상태 정보를 저장합니다.
• 이벤트 테이블: 특정 행동과 관련된 정보를 저장합니다.
• 데이터를 전송할 때는 비즈니스 목적에 맞춰 수집할 데이터를 선정하고, 데이터를 전송할 타이밍과 트리거를 설정해야 합니다.

‍

유저 식별 규칙

‍
TE 시스템에서 유저 데이터를 정확하게 식별하고 관리하는 것은 매우 중요합니다. 잘못된 사용자 식별 정보나 데이터 유형 오류는 분석 결과에 부정적인 영향을 미칠 수 있습니다.

‍

TE 시스템에서는 모든 데이터가 게스트 ID 또는 계정 ID를 포함해야 합니다. 이를 통해 유저를 고유하게 식별할 수 있습니다.

• 게스트 ID(#distinct_id): 유저가 로그인하지 않았을 때 클라이언트 SDK에서 자동으로 생성됩니다.
• 계정 ID(#account_id): 유가 로그인한 경우 설정되며, 여러 기기에서 동일 사용자의 데이터를 통합할 때 유용합니다.

‍

클라이언트 SDK에서는 기본적으로 게스트 ID를 생성하며, 유가 로그인하면 계정 ID가 설정됩니다. 그 이후로는 두 ID가 함께 전송됩니다. 서버에서는 하나 이상의 ID가 반드시 포함되어야 하며, TE user ID (#user_id) 필드를 통해 사용자를 고유하게 식별합니다. TE의 유저 식별 규칙을 준수하지 않으면 데이터가 잘못된 사용자와 연결되어 분석 오류가 발생할 수 있습니다.

‍

‍

데이터 전송 규칙

‍

TE에서는 데이터 전송 시 일정한 형식과 규칙을 따를 것을 요구합니다. 데이터를 전송할 때는 SDK 데이터 연동 도구, 또는 API를 사용하며, 정확한 데이터 포맷과 명명 규칙을 따라야 합니다.

‍

• 명명 규칙: 이벤트명과 속성명에는 문자, 숫자, 밑줄()만 포함할 수 있으며, 최대 50자까지 허용됩니다. 또한 대소문자를 구분합니다.
• 속성 값의 데이터 타입: 데이터 유형은 최초 전송된 값을 기준으로 결정되며, 이후 다른 유형의 값이 전송될 경우 데이터가 저장되지 않습니다.

‍

TE는 기본적으로 수집되는 프리셋 속성이 있으며, 이러한 속성은 " # "으로 시작합니다. SDK에서 자동으로 수집되므로 별도의 설정이 필요하지 않습니다. 자세한 사항은 프리셋 속성 및 시스템 필드를 참조하세요.

‍
‍

필수 정보 확인

‍
데이터 전송을 시작하기 전에 아래 정보를 준비해야 합니다:

‍
1. Project APP ID: 프로젝트 생성 시 부여되는 APP ID는 프로젝트 관리 화면에서 확인할 수 있습니다.
2. 데이터 수신 주소: SaaS 버전의 경우 [https://ta-receiver.thinkingdata.io], 프라이빗 구축의 경우 프라이빗 클러스터에 SSL 인증서를 연결해야 합니다. (데이터 수신 주소 확인 방법 : https://YOUR_RECEIVER_URL/health-check에 접속해 OK가 표시되는 것 확인)
3. 데이터 수집 방법: 클라이언트 SDK, 서버 SDK 등 적절한 방법을 선택하고 데이터 전송 내용과 타이밍을 명확히 합니다.

‍

이 가이드를 바탕으로 TE 시스템에서 효율적인 데이터 전송을 시작할 수 있습니다.