Google Analytics

노트

만다오 어플리케이션에 Google Analytics를 연동하여 사용자 행동을 추적할 수 있습니다. 만다오는 최신 버전의 Google Analytics (GA4) 연동을 지원합니다. 이미 구글에서 지원이 중단된 Universal Analytics는 지원하지 않습니다.

노트

연동을 진행하기 위해서는 웹 어플리케이션용 Google Analytics Account 및 Property가 필요합니다. 준비를 마친 후에 아래 가이드를 통해 연동을 시작하세요.

Google Analytics 연동하기

Google Analytics의 속성 ID가 준비되었다면 아래와 같이 앱 에디터 메인 페이지(여러 화면을 볼 수 있는 페이지)에 코드를 입력합니다.

주의

만다오는 UA-로 시작하는 Universal Analytics를 지원하지 않습니다. GA4의 속성 ID를 입력해주세요. GA4의 속성 ID는 G-XXXXXXXXXX 형식의 값입니다. (ex. G-FZ46B2MYQC)

끝입니다! 저장 및 배포 후 서빙되는 페이지에 진입하면 Google Analytics 연동을 확인할 수 있습니다.

Google Analytics 연동 확인하기

GA가 정상적으로 연동되었다면 만다오 페이지 실행시 Google Analytics의 실시간 탭에서 실시간 접속을 확인할 수 있습니다.

GA의 실시간 데이터 수집은 최대 1분정도의 딜레이가 발생할 수 있으므로 잠시 기다려 주세요. 혹시 사용 기록이 전송되지 않는다면 페이지의 아무 영역을 클릭하거나 스크롤해 보세요. 혹은 개발자 콘솔 > 네트워크 탭에서 collect로 시작하는 요청이 전송되는지 확인해 보세요.

Google Analytics 이벤트 커스텀하기

연동이 완료되었다면 이제 액션이 설정된 요소가 클릭되었을 때 Google Analytics로 이벤트를 발송하도록 할 수 있습니다. 발송되는 이벤트의 프로퍼티는 아래와 같이 정의됩니다.

{
  event_action: 'mandao_cta.clicked', // 고정된 값
  event_label: 'https://event-view.baemin.in/1234', // 만다오 배포시 생성되는 URL
  event_category: '내 이벤트 카테고리' // 만다오 에디터에서 직접 입력할 수 있는 값
}

'event_action'과 'event_label'은 만다오에서 자동으로 설정해 주는 값입니다. 'event_action'은 'mandao_cta.clicked'으로, 'event_label'은 만다오 배포시 생성되는 URL로 설정됩니다.
'event_category'는 만다오 에디터에서 직접 입력할 수 있는 값으로, 이벤트를 구분하기 위한 값을 직접 입력할 수 있습니다.

Google Analytics로 이벤트를 전송하기 위해서는 앱에 Google Analytics가 연동되고, 해당 요소에 액션이 설정되어야 합니다. 요소에 클릭 액션이 설정되어 있는 경우, 아래와 같이 'event_category'를 입력할 수 있는 UI가 표시됩니다.

주의

Google Analytics의 ID가 입력되지 않았거나 액션이 설정되어있지 않다면 Google Analytics로 이벤트의 'event_category'를 입력하는 UI가 표시되지 않습니다.

'event_category' 값까지 입력되었다면 이제 클릭시 Google Analytics에서 이벤트 정보를 수신할 수 있습니다. ('event_category'가 입력되지 않은 경우에는 클릭되어도 이벤트를 전송하지 않습니다.) 전송된 이벤트는 마찬가지로 Google Analytics의 실시간 탭에서 확인할 수 있습니다.