본문으로 건너뛰기
weballin

weballin DIGIWIKI · 용어 사전

앱 인스턴스 ID

앱 인스턴스 ID는 Firebase SDK가 모바일 앱 설치 단위로 생성하는 고유 식별자로, 앱에서 클라이언트 ID와 같은 역할을 합니다. 측정 프로토콜로 앱 이벤트를 서버에서 보낼 때 app_instance_id 파라미터로 사용합니다.

앱 인스턴스 ID는 Firebase Analytics(GA4 앱 스트림의 기반)에서 앱 설치를 식별하는 기본 단위이다. 웹에서 _ga 쿠키가 클라이언트 ID를 저장하듯, 앱에서는 Firebase SDK가 기기에 앱 인스턴스 ID를 저장한다.

앱 인스턴스 ID는 앱 삭제 후 재설치, 기기 초기화, 기기 변경 시에 새로 생성된다. 따라서 웹의 클라이언트 ID와 마찬가지로 동일 사용자를 장기간 추적하는 데 한계가 있다. 이 한계는 사용자 ID(User ID)를 앱에서도 설정해 보완한다.

측정 프로토콜로 앱 이벤트를 서버에서 보낼 때는 client_id 대신 app_instance_id를 전달해야 앱 사용자 데이터와 올바르게 연결된다. Firebase 콘솔이나 Firebase SDK의 FirebaseAnalytics.getAppInstanceId() 메서드로 현재 앱 인스턴스 ID를 조회할 수 있다.

핵심 정리

  • Firebase SDK가 앱 설치 시 자동 생성하는 고유 식별자로, 앱에서의 클라이언트 ID 역할이다.
  • 앱 삭제 후 재설치 또는 기기 초기화 시 새로운 ID가 발급된다.
  • 측정 프로토콜로 앱 이벤트를 전송할 때 app_instance_id 파라미터로 전달한다.
  • Firebase SDK의 FirebaseAnalytics.getAppInstanceId() 메서드로 현재 값을 조회한다.
  • 사용자 ID와 함께 사용하면 앱 재설치 후에도 사용자를 연결할 수 있다.

위볼린디지털 마케팅 용어 사전