# Clarity Project ID 하나로 Android·iOS 함께 설정하기

- 게시: 2026.07.10 · 최종 업데이트: 2026.07.11
- 원문(HTML): https://trendbrief.news/articles/clarity-project-id-%ED%95%98%EB%82%98%EB%A1%9C-android-ios-%ED%95%A8%EA%BB%98-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0.html
- 발행: [트렌드브리프](https://trendbrief.news/)

> 마이크로소프트 Clarity는 SDK 초기화 때 같은 ID를 넣으면 Android와 iOS 앱을 Project ID 하나로 함께 수집한다. 설정 순서와 통합·분리 판단 기준, 마스킹 점검까지 정리했다.

마이크로소프트 Clarity는 Project ID 하나로 Android와 iOS 앱을 같이 수집할 수 있다. 두 플랫폼의 SDK를 시작할 때 같은 ID 문자열을 넣으면 세션 기록과 히트맵이 한 대시보드로 모인다. 대신 데이터가 한곳에 섞이니, 플랫폼별 지표를 따로 봐야 한다면 프로젝트를 처음부터 나누는 쪽이 나을 때도 있다.

## Project ID 하나를 두 플랫폼에 써도 되나

된다. Clarity에서 Project ID는 수집한 데이터가 쌓일 자리를 가리키는 식별자다. Android 빌드와 iOS 빌드가 같은 ID로 초기화되면 두 앱의 세션이 같은 프로젝트 안으로 들어온다. 앱을 새로 낼 때마다 프로젝트를 쪼갤 필요는 없다는 뜻이다.

한 서비스를 iOS와 Android로 함께 내는 경우가 여기에 잘 맞는다. 같은 화면, 같은 기능을 두 OS에서 제공하니 사용자 흐름을 한 판에서 비교하기 좋다. 결제 단계에서 이탈이 늘었다고 하자. 두 플랫폼을 한 프로젝트에서 보면 문제가 OS를 가리지 않고 공통으로 생기는지, 한쪽만의 문제인지 금방 감이 온다.

## Android와 iOS에 같은 ID를 넣는 순서

설정 자체는 단순하다. 먼저 Clarity 대시보드에서 프로젝트를 하나 만들고 Project ID를 확보한다. 그다음 Android 앱과 iOS 앱 양쪽에 Clarity SDK를 각각 추가하고, 앱이 켜지는 초기 시점에 SDK를 시작하면서 이 ID를 넘겨준다.

실무에서는 ID 값을 코드에 직접 박지 말고 한곳에서 관리하길 권한다. Android라면 빌드 설정이나 리소스 값으로, iOS라면 빌드 구성이나 Info 설정 값으로 빼두면, 개발용과 운영용 프로젝트를 나눌 때도 코드를 건드리지 않고 ID만 바꿔 끼울 수 있다. 두 플랫폼이 같은 ID를 참조하도록 상수 이름을 맞춰 두면 나중에 헷갈릴 일도 줄어든다.

초기화는 앱 진입점에서 한 번만 하면 된다. Android는 Application 클래스가 시작하는 지점, iOS는 앱이 켜질 때 처음 호출되는 진입점이 자연스러운 자리다. 초기화를 화면 곳곳에서 반복해 부르면 세션이 어긋나거나 중복 기록이 생길 수 있으니, 진입점 한 곳으로 모으는 편이 안전하다.

## 서로 다른 앱 식별자는 콤마로 구분해 함께 기입한다

한 프로젝트에 두 플랫폼을 붙일 때 실무에서 먼저 걸리는 지점이 앱 식별자 등록이다. Android 패키지명과 iOS 번들 ID는 서로 다른 값이라, 프로젝트 설정에 어느 쪽을 넣어야 할지 애매해진다. 이때는 두 식별자를 동시에 기입하되 콤마(,)로 구분하면 된다. Clarity 공식 GitHub 저장소의 [이슈 답변](https://github.com/microsoft/clarity/issues/673)에 따르면, 두 번들 ID를 콤마 문자로 구분해 입력하는 방식이 권장된다.

해당 이슈는 Android와 iOS의 번들 ID가 달라 프로젝트를 나눠야 하는지 묻는 React Native 앱 사례였고, 답변은 프로젝트 하나로 두 앱을 모두 받을 수 있다는 쪽이었다. 이렇게 식별자를 나란히 등록해 두면 Project ID는 그대로 하나만 유지되고, 앞서 본 대로 두 플랫폼의 세션이 한 대시보드로 모이는 구성이 성립한다.

## 합쳐서 볼 때와 나눠서 볼 때, 무엇이 다른가

합치면 편하지만 대신 데이터가 섞인다. 여기서 판단이 갈린다. 두 플랫폼의 사용 패턴을 늘 함께 보고 싶다면 하나로 합치는 쪽이 관리가 간단하다. 프로젝트가 하나뿐이니 설정도 한 번, 확인할 화면도 한 곳이다.

반대로 iOS와 Android 지표를 자주 떼어 봐야 한다면 이야기가 달라진다. 한 프로젝트에 섞인 세션을 플랫폼 기준으로 갈라 보려면, 대시보드가 그런 구분을 지원하는지부터 확인해야 한다. 마땅한 필터가 없으면 처음부터 프로젝트를 둘로 나눠 두는 편이 속 편하다. 릴리스 주기가 서로 다르거나, 한쪽 OS에서만 특정 실험을 돌리는 팀이라면 분리가 더 어울린다.

정답이 하나로 정해져 있지는 않다. '한 서비스를 두 OS로 낸다'에 가까우면 통합, '사실상 두 팀이 각자 앱을 굴린다'에 가까우면 분리. 이 기준으로 먼저 갈라 보면 결정이 한결 쉬워진다.

## 설정 전에 점검할 것

SDK 버전과 지원 범위를 먼저 확인하자. 모바일용 수집 기능은 웹보다 늦게 자리 잡은 편으로 알려져 있어, 쓰려는 SDK 버전이 어떤 OS 버전과 기능까지 지원하는지 공식 문서에서 짚어 두는 게 좋다. 버전에 따라 제공되는 기능이 다를 수 있다.

개인정보 처리도 빼놓을 수 없다. 세션 기록 도구는 화면에 뜬 값을 그대로 담을 수 있어서, 로그인 정보나 결제 화면처럼 민감한 입력이 노출되지 않도록 마스킹 설정을 반드시 점검해야 한다. 이 설정은 플랫폼마다 따로 잡아 줘야 하는 경우가 많다. ID만 같으면 마스킹까지 저절로 맞춰진다고 넘겨짚지 말자.

마지막으로 연동 직후에는 두 플랫폼에서 각각 테스트 세션을 만들어 대시보드에 실제로 들어오는지 눈으로 확인하는 절차를 넣자. ID 오타 하나로 데이터가 엉뚱한 프로젝트에 쌓이거나 아예 안 들어오는 일이 흔하다. 초기화 위치, ID 값, 네트워크 권한 이 세 가지만 훑어도 초기 문제 대부분은 걸러진다.

## 관련 글

- [Microsoft Clarity로 히트맵과 세션 녹화 분석 시작하기](https://trendbrief.news/articles/microsoft-clarity%EB%A1%9C-%ED%9E%88%ED%8A%B8%EB%A7%B5%EA%B3%BC-%EC%84%B8%EC%85%98-%EB%85%B9%ED%99%94-%EB%B6%84%EC%84%9D-%EC%8B%9C%EC%9E%91%ED%95%98%EA%B8%B0.md)
- [WebSocket STOMP 프로토콜 구조와 실무 도입 포인트](https://trendbrief.news/articles/websocket-stomp-%ED%94%84%EB%A1%9C%ED%86%A0%EC%BD%9C-%EA%B5%AC%EC%A1%B0%EC%99%80-%EC%8B%A4%EB%AC%B4-%EB%8F%84%EC%9E%85-%ED%8F%AC%EC%9D%B8%ED%8A%B8.md)
- [SE-0532로 배우는 스위프트 에볼루션 제안 읽기](https://trendbrief.news/articles/se-0532%EB%A1%9C-%EB%B0%B0%EC%9A%B0%EB%8A%94-%EC%8A%A4%EC%9C%84%ED%94%84%ED%8A%B8-%EC%97%90%EB%B3%BC%EB%A3%A8%EC%85%98-%EC%A0%9C%EC%95%88-%EC%9D%BD%EA%B8%B0.md)
- [Metal 프레임워크로 시작하는 GPU 프로그래밍](https://trendbrief.news/articles/metal-%ED%94%84%EB%A0%88%EC%9E%84%EC%9B%8C%ED%81%AC%EB%A1%9C-%EC%8B%9C%EC%9E%91%ED%95%98%EB%8A%94-gpu-%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%98%EB%B0%8D.md)
- [웹마스터 도구로 사이트 색인과 크롤링 점검하기](https://trendbrief.news/articles/%EC%9B%B9%EB%A7%88%EC%8A%A4%ED%84%B0-%EB%8F%84%EA%B5%AC%EB%A1%9C-%EC%82%AC%EC%9D%B4%ED%8A%B8-%EC%83%89%EC%9D%B8%EA%B3%BC-%ED%81%AC%EB%A1%A4%EB%A7%81-%EC%A0%90%EA%B2%80%ED%95%98%EA%B8%B0.md)