iOS 앱에 Google Analytics 연동하기

iOS 앱에 Google Analytics 연동하기

최근 iOS 앱에 Google Analytics를 연동하려고 시도했으나, 구글에서 제안한 기존 방법대로 진행하면 로그가 전송되지 않는 문제가 있었다. 이 글에서는 문제 발생 원인과 해결 과정을 단계별로 정리한다.

기존 방법으로는 연동이 되지 않았다

1. 구글에서는 코코아팟(CocoaPods)으로 Analytics 패키지를 설치하라고 권장하였다. 그러나 이미 SPM(Swift Package Manager)으로 패키지가 설치된 상태에서 진행하였기에 코코아팟으로 설치하라는 방법은 적용되지 않았다.

2. Firebase 콘솔의 디버깅 모드를 활성화하여 우선 Analytics가 작동하는지 확인하였다.
   또한 XCode의 Schem을 활용 하여 디버그 모드도 활성화 하였다.
   
   

3. 그럼에도 불구하고, 이벤트 로그가 전송되지 않아 문제의 원인을 찾아보았다.
4. 분석 결과 SPM에 필요한 Analytics 패키지가 누락되어 있었다.

5. 누락된 패키지를 SPM으로 추가한 후 앱을 빌드하니, 정상적으로 로그가 전송되었다.
   

예를 들어, 버튼이 눌릴 때 아래의 로그를 전송 하도록 코드를 작성 하였다.

Analytics.logEvent("filterButtonTapped", parameters: ["id" : "filterButtonTapped"])

이제 버튼을 눌렀을 때 정상적으로 로그가 찍히는 것을 확인할 수 있었다.

결론

iOS 앱에 Google Analytics를 연동할 때, 구글에서 권장하는 코코아팟 방식이 아닌 SPM 방식으로 설치되어 있는 경우, SPM 설정에 필요한 패키지가 빠져있는지 꼼꼼하게 확인해야 한다. 디버깅 모드에서 Analytics가 작동하는지 먼저 점검하고, 누락된 패키지를 추가한 후 빌드를 진행하면 정상적으로 이벤트 로그가 전송된다. 이와 같이 문제를 해결하여 앱 내 이벤트 로그를 성공적으로 기록할 수 있게 되었다.