데이터 전송 및 검증
전송 전 준비
어떤 전송 방식을 사용하든 프로젝트 관리의 프로젝트 구성 → 연동 설정에서 현재 프로젝트의 APP_ID를 확인하고 전송 전에 설정해야 데이터가 올바른 프로젝트로 전송됩니다.
APP_ID 외에 데이터를 전송할 주소, 즉 SERVER_URL도 정해야 합니다. SaaS 고객이라면 수집 주소는 ThinkingAI에서 제공합니다: https://global-receiver-ta.thinkingdata.cn. 프라이빗 배포 고객이라면 ThinkingAI의 운영 담당자가 고객사의 운영 담당자와 협력하여 수집 주소를 배포·인계하며, 이후에는 고객사의 운영 담당자가 관리합니다. 수집 주소는 시스템 관리의 일반 관리 → 일반 설정 → 수집 주소 탭에서 설정할 수 있으며, AE 시스템이 도메인 인증서의 유효성을 자동으로 확인하고 인증서 만료가 임박하면 알려 줍니다.
데이터 전송
AE는 클라이언트 SDK, 서버 SDK를 통한 전송과 Restful API를 통한 데이터 전송을 지원합니다. AE 시스템이 받는 데이터 형식은 요구 사항을 충족하는 JSON이며, 지원하는 데이터 타입은 숫자, 텍스트, 시간, 불리언, 리스트, 객체, 객체 그룹입니다. 자세한 내용은 데이터 규칙에서 확인할 수 있습니다. 시스템의 유연성을 위해 AE는 테이블 구조를 미리 정의할 필요가 없으며, 속성이 처음 전송될 때의 데이터 타입이 속성 타입을 결정합니다. 따라서 이후 분석에 영향을 주지 않도록 개발 담당자와 타입을 확인한 후 전송해야 합니다. 클라이언트 SDK를 사용하는 경우 자동으로 수집할 수 있는 일부 이벤트 속성과 유저 속성도 제공하므로 시스템 속성을 참고하십시오. 클라이언트 SDK는 업데이트 가능한 이벤트와 최초 이벤트 검증이라는 두 가지 특수 이벤트 타입도 지원하므로 비즈니스 요구에 따라 사용 여부를 결정할 수 있습니다. AE 시스템을 연동하기 전에 프로젝트에 이미 과거 데이터가 있다면 데이터 가져오기를 선택할 수도 있습니다. 과거 데이터의 저장 형식, 가져오기 도구, 변환 로직 등을 확인한 후 가져오기를 시작합니다. AE의 SDK와 데이터 전송 도구는 계속 업데이트되며, 각 도구의 최신 버전과 업데이트 시간은 연동 가이드에서 확인할 수 있습니다.
데이터 검증
AE 백엔드는 지연 없는 기술을 사용하므로 데이터를 받는 즉시 시스템에서 확인할 수 있습니다. 실시간 데이터에서 최근 적재된 데이터 1000건과 오류 원인을 확인할 수 있습니다. 또한 전송 통계에서 최근 7일간 프로젝트 내 이벤트 또는 유저 속성의 데이터 수신 현황을 확인할 수 있습니다.
전송된 데이터 자체의 오류 외에도, 트래킹 방안을 프로젝트에 업로드했다면 데이터 검증에서 적재된 데이터의 품질을 검증하여 전송 데이터와 트래킹 방안의 차이, 속성 null 값 비율 등의 정보를 얻을 수 있습니다.
클라이언트 SDK로 전송하는 경우 테스트할 때 디버그 모드를 켜면 데이터 문제를 더 쉽게 찾을 수 있습니다. 단, 디버그 모드는 테스트 전용이므로 테스트 단계가 아닐 때는 사용하지 않는 것이 좋습니다.