관리자 가이드

IMQA 사용자 로그인

IMQA는 기본 로그인 ID로 '이메일 주소'를 사용하고, 새로운 IMQA 사용자를 추가하고 관리할 수 있는 사용자 관리 기능을 제공합니다. 또한 기업 도입 환경에 따라 인사정보 및 SSO 연동 하여 로그인 방식이 다를 수 있습니다. 자세한 내용은 IMQA 담당자에게 문의하세요.

서비스 이름

**IMQA는 SDK, 웹 브라우저에서 수집한 데이터를 식별하기 위해 서비스 이름을 사용합니다. SDK, WebAgent 설치시 ServiceNameSpace로 사용할 이름으로 등록해 주세요. 서비스 이름은 고유해야 하며, 다른 서비스 이름과 동일하게 설정하실 수 없습니다.

서비스 대표 이미지

IMQA에서는 브랜드의 로고나 앱 서비스 아이콘 등의 이미지로 서비스 대표 이미지를 설정할 수 있습니다. 설정하지 않았을 경우 기본 IMQA 이미지로 표시됩니다.

IMQA Mobile SDK 설치

IMQA의 Android SDK, iOS SDK, WebAgent는 각각 환경의 특성에 맞는 데이터를 수집합니다. Android / iOS 앱 등록 후 발급된 앱 키를 사용하여 SDK를 설치하세요.

IMQA WebAgent로 Mobile SDK와 연동 또는 웹 브라우저 환경을 계측하는 경우

IMQA Mobile SDK와 연동시, 웹 브라우저 환경 계측에 따라 네이티브 SDK에서 전달한 정보를 자동으로 연계하거나, 별도 설정이 필요합니다. 자세한 내용은 IMQA WebAgent 설치 가이드 > 옵션 상세 설명 섹션을 참고해주세요.

통합 관리 메뉴 접근 권한

IMQA의 통합 관리 메뉴는 SUPER_USER 권한 사용자에게만 제공됩니다.

• - 사용자 관리: SUPER_USER 역할 사용자에게만 표시, 접근할 수 있습니다. 사용자 관리와 팀 관리를 할 수 있습니다.
• - 서비스 관리: SUPER_USER 역할 사용자에게만 표시, 접근할 수 있습니다. 서비스 관리와 앱 관리, 매핑 파일 관리를 할 수 있습니다.
• - 감사 로그: SUPER_USER 역할 사용자에게만 표시, 접근할 수 있습니다.

특정 서비스별 설정 기능 제공

'서비스 관리 > 앱 관리 & 매핑 파일 관리' 기능은 특정 서비스별 설정 기능으로도 제공 됩니다. 앱 접근 권한이 있고, MANAGER 이상의 권한이 있는 담당자가 직접 관리할 수 있습니다.

• - (특정 서비스의) 서비스 설정: MANAGER 이상 역할 사용자에게만 표시, 접근할 수 있습니다. 해당 서비스에 속한 앱 관리, 매핑 파일 관리를 할 수 있습니다.

IMQA 사용자 관리를 통해 IMQA 사용자를 조회하고 관리할 수 있습니다. 사용자별 권한을 소속 팀과 역할에 따라 기본 설정할 수 있습니다.

기업 인사정보 & SSO 연동

IMQA는 기본 로그인 ID로 '이메일 주소'를 사용하고, 새로운 IMQA 사용자를 추가하고 관리할 수 있는 사용자 관리 기능을 제공합니다. 또한 기업 도입 환경에 따라 인사정보 및 SSO 연동을 제공합니다. 기업 도입 환경에 따라 '사용자 관리' 메뉴에서 제공되는 기능과 표시 정보가 다를 수 있습니다. 자세한 내용은 IMQA 담당자에게 문의하세요.

IMQA 사용자 관리는 다음과 같이 구성됩니다.

❶ 툴바(사용자 관리)

❷ 사용자 목록

❶ 사용자 목록 동기화: 기업 인사정보를 IMQA로 연동한 경우, 사용자 목록 동기화 내역을 확인하거나 수동으로 동기화할 수 있습니다.

❷ 새로운 사용자: 새 사용자를 등록합니다.

사용자 목록 동기화

기업 인사정보를 IMQA로 연동한 경우 제공되는 기능입니다.

기업 인사정보와 IMQA 사용자 목록이 연동 되어 있는 경우, 예약된 일정에 따라 자동 업데이트됩니다. 정상적으로 사용자 목록이 업데이트되지 않은 경우 또는 즉시 업데이트가 필요한 경우에 현재 인사정보를 바로 반영하도록 사용자 목록을 수동으로 동기화할 수 있습니다.

❶ 사용자 목록 동기화 내역을 최근 5건까지 확인할 수 있습니다.

❷ 정상적으로 사용자 목록이 업데이트되지 않은 경우 또는 즉시 업데이트가 필요한 경우 [동기화] 버튼을 클릭합니다.

사용자 목록 수동 동기화 시 주의 사항

사용자 목록 동기화 완료에 다소 시간이 소요될 수 있으며, 페이지를 이동하는 경우에도 동기화는 취소되지 않고 진행됩니다. 사용자 목록 동기화 결과를 확인하시려면 페이지를 이동하거나 이탈하지 말고 잠시만 기다려 주세요.

이메일 주소 또는 인사정보로 사용자 추가

IMQA는 기본 로그인 ID로 '이메일 주소'를 사용하고, 새로운 IMQA 사용자를 추가하고 관리할 수 있는 사용자 관리 기능을 제공합니다. 또한 기업 도입 환경에 따라 인사정보 및 SSO 연동이 되어있는 경우, '사번'과 같은 기업 연계 정보로 사용자를 수동 추가할 수 있습니다.

사용자 관리 페이지 오른쪽 상단의 [+ 새로운 사용자] 버튼을 클릭하면 이메일 주소로 사용자를 추가할 수 있는 팝업이 표시됩니다.

사용자 권한

IMQA에는 앱 접근 권한과 기능 접근 권한으로 구분된 권한 체계가 있습니다. 사용자는 소속 팀과 역할을 기반으로 각 권한을 상속받습니다. 팀은 앱 접근 권한을 사용자에게 부여합니다. 역할은 기능 접근 권한을 사용자에게 부여합니다.

(기본 팀)

(기본 팀)은 모든 앱의 접근 권한을 가질 수 있습니다.

❶ 사용자의 소속 팀을 설정합니다. 기본은 (기본 팀)으로 설정되어 있습니다.

❷ 이메일 주소와 이름을 입력합니다. 이메일 주소는 로그인 ID로 사용됩니다.

❸ 사용자의 역할을 설정합니다. 역할에 따라 할당된 기능별 권한이 자동 설정됩니다.

❹ 정보 작성이 완료되면 [추가] 버튼을 클릭합니다.

사용자 목록 동기화

기업 인사정보를 IMQA로 연동한 경우 제공되는 기능입니다.

기업 인사정보와 IMQA 사용자 목록이 연동 되어 있는 경우, 예약된 일정에 따라 자동 업데이트됩니다. 정상적으로 사용자 목록이 업데이트되지 않은 경우 또는 즉시 IMQA 사용자 추가가 필요한 경우에 인사정보로 사용자를 추가할 수 있습니다.

사용자 관리 페이지 오른쪽 상단의 [+ 새로운 사용자] 버튼을 클릭하면 인사정보로 사용자를 추가할 수 있는 팝업이 표시됩니다.

사용자 권한

IMQA에는 앱 접근 권한과 기능 접근 권한으로 구분된 권한 체계가 있습니다. 사용자는 소속 팀과 역할을 기반으로 각 권한을 상속받습니다. 팀은 앱 접근 권한을 사용자에게 부여합니다. 역할은 기능 접근 권한을 사용자에게 부여합니다.

(기본 팀)

(기본 팀)은 모든 앱의 접근 권한을 가질 수 있습니다.

❶ 사용자의 소속 팀을 설정합니다. 기본은 (기본 팀)으로 설정되어 있습니다.

❷ 로그인 ID(예: 사번)와 이름을 입력합니다.

❸ 사용자의 역할을 설정합니다. 역할에 따라 할당된 기능별 권한이 자동 설정됩니다.

❹ 사용자 속성 정보를 키-값 형태로 입력할 수 있습니다.

사용자 속성 정보

사용자 속성 정보의 키가 사용자 목록에 컬럼으로 표시됩니다. 이미 추가되어 있는 사용자 속성 키 정보와 동일하게 사용하고자 하는 경우, 오탈자에 주의해 주세요. 기업 인사정보와 IMQA 사용자가 연동 되어 있는 경우, 기존 연동되어 있는 사용자 정보와 동일한 정보를 키로 입력해 주세요.

❺ 정보 작성이 완료되면 [추가] 버튼을 클릭합니다.

사용자별 권한은 사용자의 소속 팀과 역할에 설정된 권한으로 기본 설정됩니다.

팀-역할-사용자 권한 요약

1. 팀 단위로 앱 접근 권한을 설정할 수 있습니다.

- 팀 단위에는 기능 접근에 대한 설정 기능을 제공하지 않습니다.

2. 역할 단위에는 기능 접근 권한이 사전 정의되어 있습니다.

- 역할 단위에는 앱 접근에 대한 설정 기능을 제공하지 않습니다.

- 현재 역할을 새로 생성하거나 역할별 권한은 수정이 되지 않습니다.

3. 사용자 단위로 팀과 역할을 설정할 수 있습니다.

- 사용자는 기본 (기본 팀)으로 소속되며, (기본 팀)은 모든 앱의 접근 권한을 가지고 있습니다.

- 사용자의 소속 팀을 설정하면 팀에 설정된 앱 접근 권한을 자동 설정합니다.

- 사용자가 복수의 팀에 설정된 경우 각 팀에 설정된 앱 접근 권한을 병합합니다.

- 사용자의 역할을 설정하면 역할에 설정된 기능 접근 권한을 자동 설정합니다.

4. 사용자 단위로 소속 팀과 역할에 지정된 권한을 상속받아야 합니다.

- 현재 사용자에게 별도 앱 접근 권한과 기능 접근 권한을 설정할 수 없습니다.

IMQA는 여러 사용자를 팀으로 관리할 수 있습니다. 팀 단위로 앱 접근 권한을 설정하여 같은 소속 사용자들의 권한을 일괄 관리하기 용이합니다.

IMQA는 역할에 따라 메뉴 및 기능 접근 권한을 구분하여 제공하고 있습니다. 아래의 역할별 기능 권한을 참고하세요.

메뉴 접근 권한 제어

사용자의 역할에 기능 접근 권한이 있더라도, 소속 팀의 앱 접근 권한 유무에 따라 접근할 수 없는 메뉴가 있습니다. * 표시 메뉴는, 사용자가 특정 서비스(앱)에 대한 접근 권한이 있어야 접근이 가능합니다.

• - 예1) SUPER_USER 역할 사용자이지만 소속 팀에서 접근 가능한 앱을 아무것도 상속받지 못했을 경우, '서비스 대시보드'에 접근할 수 없습니다. '감사 로그'에는 접근할 수 있습니다.
• - 예2) ADMIN 역할 사용자이지만 소속 팀에서 접근 가능한 앱을 아무것도 상속받지 못했을 경우, '서비스 대시보드'에 접근할 수 없습니다. '감사 로그'에도 접근할 수 없습니다.
• - 예3) ADMIN 역할 사용자이고 소속 팀에서 접근 가능한 앱을 상속받았을 경우, '서비스 대시보드'에 접근할 수 있습니다. '알림 설정'에도 접근할 수 있습니다.
• - 예4) USER 역할 사용자이고 소속 팀에서 접근 가능한 앱을 상속받았을 경우, '서비스 대시보드'에 접근할 수 있습니다. '알림 설정'에는 접근할 수 없습니다.

(* 특정 서비스(앱) 접근 권한이 있는 경우에만 접근 가능한 메뉴)

현재 등록된 IMQA 사용자를 확인할 수 있습니다. 기본은 최근 생성일시 순으로 정렬 됩니다. 사용자 속성 정보가 있을 경우 함께 표시됩니다.

사용자의 기본 정보와 사용자의 현재 권한을 확인할 수 있습니다. 사용자 정보를 수정하거나 삭제할 수 있습니다.

사용자 ID, 이름, 팀, 역할 정보가 표시됩니다.

사용자의 소속 팀과 역할에서 상속받은 사용자 권한 정보가 표시됩니다.

사용자의 기본 정보를 수정할 수 있습니다. 팀과 역할 변경 시 변경되는 사용자 권한을 미리 확인할 수 있습니다.

❶ 사용자의 이름을 변경할 수 있습니다. 사용자 ID는 변경이 불가합니다.

❷ 사용자의 팀을 설정합니다. 소속 팀에 따라 할당된 앱 접근 권한을 미리 확인할 수 있습니다.

❸ 사용자의 역할을 설정합니다. 역할에 따라 할당된 기능별 권한을 미리 확인할 수 있습니다.

❹ 정보 수정이 완료되면 [저장] 버튼을 클릭합니다.

IMQA 팀 관리를 통해 여러 사용자를 팀으로 관리할 수 있습니다. 팀 단위로 앱 접근 권한을 설정할 수 있습니다.

기업 인사정보 & SSO 연동

IMQA는 기본 로그인 ID로 '이메일 주소'를 사용하고, 새로운 IMQA 사용자를 추가하고 관리할 수 있는 사용자 관리 기능을 제공합니다. 또한 기업 도입 환경에 따라 인사정보 및 SSO 연동을 제공합니다. 기업 도입 환경에 따라 '팀 관리' 메뉴에서 제공되는 기능과 표시 정보가 다를 수 있습니다. 자세한 내용은 IMQA 담당자에게 문의하세요.

IMQA 팀 관리는 다음과 같이 구성됩니다.

❶ 툴바(팀 관리)

❷ 팀 목록

❶ 새로운 팀: 새 팀을 등록합니다.

사용자 관리> 팀 관리 페이지 오른쪽 상단의 [+ 새로운 팀] 버튼을 클릭하면 팀을 추가할 수 있는 팝업이 표시됩니다.

사용자 권한

IMQA에는 앱 접근 권한과 기능 접근 권한으로 구분된 권한 체계가 있습니다. 사용자는 소속 팀과 역할을 기반으로 각 권한을 상속받습니다. 팀은 앱 접근 권한을 사용자에게 부여합니다. 역할은 기능 접근 권한을 사용자에게 부여합니다.

❶ 팀 이름과 설명을 입력합니다.

❷ 정보 작성이 완료되면 [추가] 버튼을 클릭합니다.

현재 등록된 IMQA 팀과 팀 소속 사용자 수를 확인할 수 있습니다. 기본은 최근 생성일시 순으로 정렬 됩니다.

팀의 기본 정보와 팀의 현재 권한을 확인할 수 있습니다. 팀 정보를 수정하거나 삭제할 수 있습니다.

팀 이름, 설명 정보가 표시됩니다.

팀이 가진 앱 접근 권한 정보가 표시됩니다.

팀에 소속된 사용자 목록이 표시됩니다. 사용자는 여러 팀에 속할 수 있습니다.

팀의 기본 정보를 수정할 수 있습니다. 팀의 앱 접근을 설정하거나, 소속 팀 사용자를 설정할 수 있습니다.

❶ 팀의 이름과 설명을 변경할 수 있습니다.

❷ 팀의 앱 접근 권한을 설정합니다. 소속 팀 사용자의 앱 접근 권한이 자동 변경됩니다.

❸ 팀의 사용자를 설정합니다. 해당 사용자의 앱 접근 권한이 자동 변경됩니다.

❹ 정보 수정이 완료되면 [저장] 버튼을 클릭합니다.

IMQA에서 분석할 주요 업무 단위 서비스를 등록하고 관리할 수 있습니다. 서비스로 여러 앱을 그룹화 합니다.

서비스 삭제

**IMQA는 주요 업무 단위인 서비스 단위로 분석, 관리 등의 기능을 제공하고 있습니다. 서비스 삭제 시, 솔루션이 제공하는 기능 상 영향이 있을 수 있으므로 서비스 삭제를 원하시는 경우 IMQA 담당자에게 문의해 주세요.

IMQA 서비스 관리는 다음과 같이 구성됩니다.

❶ 툴바(서비스 관리)

❷ 서비스 목록

❶ 새로운 서비스: 새 서비스를 추가합니다.

서비스 관리 페이지 오른쪽 상단의 [+ 새로운 서비스] 버튼을 클릭하면 서비스를 추가할 수 있는 팝업이 표시됩니다.

❶ 서비스 이름과 설명을 입력합니다.

서비스 추가 시의 서비스 이름

**IMQA는 SDK, 웹 브라우저에서 수집한 데이터를 특정 서비스로 식별하기 위해 서비스 이름을 사용합니다. SDK, WebAgent 설치시 ServiceNameSpace로 사용할 이름으로 등록해 주세요. 서비스 이름은 고유해야 하며, 다른 서비스 이름과 동일하게 설정하실 수 없습니다.

❷ 주간 보고서 요일 기준을 설정합니다. 기본은 월요일~일요일 로 설정되어 있습니다.

주간 보고서 요일 기준

IMQA에서는 서비스별 일간, 주간, 월간 보고서를 제공하고 있습니다. 주간 보고서의 경우 각 서비스별 주간 보고서 요일 기준으로 다음 날에 보고서를 자동 생성합니다. 서비스 추가 후 언제든지 요일 기준을 변경할 수 있으나, 설정 변경 시점에 따라 주간 보고서 집계에서 누락되는 날짜가 있을 수 있으므로 변경 최소화를 권고합니다.

보고서

서비스별 일간, 주간, 월간 보고서 기능은 빠른 시일 내 업데이트 예정입니다.

❸ 정보 작성이 완료되면 [추가] 버튼을 클릭합니다.

현재 추가된 서비스를 확인할 수 있습니다. 기본은 최근 생성일시 순으로 정렬 됩니다.

서비스 기본 정보와 현재 해당 서비스에 속한 앱을 확인할 수 있습니다. 서비스 정보를 수정하거나 삭제할 수 있습니다.

해당 서비스에 소속된 앱 목록이 표시됩니다.

앱 접근 권한 관리

사용자 관리 > 팀 관리 > 팀 수정 에서 앱 접근 권한을 [추가/수정/삭제] 할 수 있습니다.

서비스의 기본 정보를 수정할 수 있습니다.

❶ 서비스 이름과 설명 정보를 변경할 수 있습니다.

서비스 이름 변경

**IMQA는 모바일 앱과 웹 브라우저에서 수집한 데이터를 식별하기 위해 서비스 이름을 사용합니다. 서비스 이름을 변경하면 이전 서비스 이름으로 저장된 데이터가 조회되지 않을 수 있습니다. SDK, WebAgent 설치시 ServiceNameSpace로 사용할 이름으로 변경해 주세요. 서비스 이름은 고유해야 하며, 다른 서비스 이름과 동일하게 설정하실 수 없습니다.

❷ 서비스 대표 이미지를 업로드할 수 있습니다. 브랜드의 로고나 앱 서비스 아이콘 등의 이미지로 설정할 수 있습니다. 정사각형(1:1) 이미지를 권장하며, 이미지 파일 확장자 (jpg/jpeg, png, gif) 파일만 업로드 가능합니다.

❸ 정보 수정이 완료되면 [저장] 버튼을 클릭합니다.

IMQA 앱 관리를 통해 IMQA에서 분석할 새로운 앱을 등록하고 관리할 수 있습니다. 앱 단위로 앱 버전을 관리할 수 있으며, 전체 또는 특정 앱 버전의 데이터 수집을 ON/OFF 할 수 있는 SDK 수집 설정 기능을 제공합니다.

IMQA 서비스 관리와 앱 관리

IMQA 앱 등록 단계에서 앱이 속할 서비스를 반드시 설정해야 합니다. 현재 추가한 서비스가 없을 경우, 먼저 서비스 추가를 진행해 주세요. 자세한 내용은 서비스 관리 > 서비스 추가 섹션을 참고해주세요.

IMQA 앱 관리는 다음과 같이 구성됩니다.

❶ 툴바(앱 관리)

❷ 앱 목록

❶ 새로운 앱: 새 앱을 등록합니다.

앱 관리 페이지 오른쪽 상단의 [+ 새로운 앱] 버튼을 클릭하면 앱을 추가할 수 있는 팝업이 표시됩니다.

새로운 앱 추가

IMQA 라이선스 정책 및 기업 도입 환경에 따라, 앱 추가 기능이 제한될 수 있습니다. 자세한 내용은 IMQA 담당자에게 문의해주세요.

IMQA Mobile SDK 설치

IMQA의 Android SDK, iOS SDK, WebAgent는 각각 환경의 특성에 맞는 데이터를 수집합니다. 서비스 이름 과 Android / iOS 앱 등록 후 발급된 앱 키를 사용하여 SDK를 설치하세요.

❶ 앱이 속할 서비스를 선택합니다.

서비스 이름

**IMQA는 모바일 앱에서 수집한 데이터를 특정 서비스로 식별하기 위해 서비스 이름을 사용합니다. SDK 설치시 ServiceNameSpace 또는 namespace 로 사용됩니다.

❷ 앱 이름과 패키지 이름을 입력합니다. 패키지 이름은 Application ID 또는 Bundle ID 로 입력해 주세요.

Android / iOS 앱 생성시의 패키지 이름

**IMQA는 모바일 앱에서 수집한 데이터를 식별하기 위해 패키지 이름을 사용합니다. 실제 앱 패키지 이름으로 등록해 주세요. 패키지 이름에는 a-z, A-Z, 0-9, -, _, .만 입력할 수 있습니다.

❸ 처음 등록할 앱 버전을 입력합니다.

앱 버전

IMQA에서는 앱 버전을 구분하여 데이터를 관리할 수 있습니다. 모바일 앱의 릴리즈 버전, 테스트 버전 등 여러 앱 버전을 기준으로 데이터를 그룹화하고, 집계/분석할 수 있습니다.

❹ 정보 작성이 완료되면 [앱 등록] 버튼을 클릭합니다.

IMQA WebAgent로 Mobile SDK와 연동 또는 웹 브라우저 환경을 계측하는 경우

IMQA Mobile SDK와 연동시, 서비스 이름 과 웹 브라우저 환경 계측에 따라 네이티브 SDK에서 전달한 정보를 자동으로 연계하거나, 별도 Web 애플리케이션으로 생성한 서비스 이름 ,패키지 이름, 앱 버전, 앱 키 설정이 필요합니다. 자세한 내용은 IMQA WebAgent 설치 가이드 > 옵션 상세 설명 섹션을 참고해주세요.

❶ 앱이 속할 서비스를 선택합니다.

서비스 이름

**IMQA는 웹 브라우저에서 수집한 데이터를 특정 서비스로 식별하기 위해 서비스 이름을 사용합니다. WebAgent 설치시 serviceNamespace 로 사용됩니다.

❷ 앱 이름과 패키지 이름을 입력합니다. 패키지 이름은 WebAgent에서 앱을 구분짓는 값으로, 아래의 포맷에 맞게 입력해 주세요.

Web 앱 생성시의 패키지 이름

**IMQA는 웹 브라우저에서 수집한 데이터를 식별하기 위해 패키지 이름을 사용합니다. WebAgent 설치시 serviceName으로 사용할 이름으로 등록해 주세요. 패키지 이름에는 a-z, A-Z, 0-9, -, _, .만 입력할 수 있습니다.

❸ 처음 등록할 앱 버전을 입력합니다.

앱 버전

IMQA에서는 앱 버전을 구분하여 데이터를 관리할 수 있습니다. 웹 앱의 릴리즈 버전, 테스트 버전 등 여러 앱 버전을 기준으로 데이터를 그룹화하고, 집계/분석할 수 있습니다. IMQA Agent 설치 시 동일한 앱 버전 정보가 필요합니다.

❹ 정보 작성이 완료되면 [앱 등록] 버튼을 클릭합니다.

현재 등록된 IMQA 앱을 확인할 수 있습니다. 기본은 최근 생성일시 순으로 정렬 됩니다.

앱의 기본 정보와 앱 키, 현재 추가된 앱 버전과 데이터 수집 상태를 확인할 수 있습니다. 앱 정보를 수정하거나 삭제할 수 있습니다.

해당 앱에 등록된 앱 버전을 확인할 수 있습니다. 현재 사용하고 있는 앱 버전과 사용하지 않는 앱 버전을 구분할 수 있습니다.

❶ [+ 앱 버전 추가] 버튼을 클릭하면 앱 버전을 추가할 수 있는 팝업이 표시됩니다.

❷ 앱 이름을 확인하고 앱 버전을 입력합니다.

앱 버전

IMQA에서는 앱 버전을 구분하여 데이터를 관리할 수 있습니다. 모바일, 웹 앱의 릴리즈 버전, 테스트 버전 등 여러 앱 버전을 기준으로 데이터를 그룹화하고, 집계/분석할 수 있습니다.

❸ 정보 작성이 완료되면 [추가] 버튼을 클릭합니다.

❹ 등록한 앱 버전을 확인할 수 있습니다.

해당 앱에 접근 권한을 가진 팀을 확인할 수 있습니다. 현재 어떤 팀이 앱에 접근할 수 있는지를 파악할 수 있습니다. (기본 팀)은 모든 앱의 접근 권한을 가지고 있습니다.

앱 접근 권한 관리

사용자 관리 > 팀 관리 > 팀 수정 에서 앱 접근 권한을 [추가/수정/삭제] 할 수 있습니다.

해당 앱에 등록된 앱 버전별 데이터 수집 상태를 확인할 수 있습니다. 최근 설정 일시와 현재 어떤 앱 버전 데이터를 수집하고 있는지를 파악할 수 있습니다. 특정 앱 버전에 데이터 드롭 정책이 사용 중인지도 확인 가능합니다.

앱의 기본 정보를 수정하거나 앱 버전을 관리할 수 있습니다. 전체 또는 특정 앱 버전의 데이터 수집을 ON/OFF 할 수 있습니다.

❶ 앱의 이름과 패키지 이름 정보를 변경할 수 있습니다. 앱 유형은 변경이 불가합니다.

패키지 이름 변경

**IMQA는 모바일 앱과 웹 브라우저에서 수집한 데이터를 식별하기 위해 패키지 이름을 사용합니다. 패키지 이름을 변경하면 이전 패키지 이름으로 저장된 데이터가 조회되지 않을 수 있습니다. 실제 앱 패키지 이름 및 WebAgent 설치시 serviceName으로 사용할 이름으로 변경해 주세요. 패키지 이름에는 a-z, A-Z, 0-9, -, _, .만 입력할 수 있습니다.

❷ 앱 버전을 추가하거나 수정, 삭제할 수 있습니다.

❸ 앱 버전별 데이터 수집을 ON/OFF 할 수 있습니다.

❸ 정보 수정이 완료되면 [저장] 버튼을 클릭합니다.

앱 수정 단계에서 IMQA에서 분석할 앱 버전을 등록하고 관리할 수 있습니다.

❶ [+ 앱 버전 추가] 버튼을 클릭하면 앱 버전을 추가할 수 있는 팝업이 표시됩니다.

❷ 등록한 앱 버전을 수정, 삭제할 수 있습니다.

❸ 등록한 앱 버전을 숨길 수 있습니다.

앱 버전 보기/숨김 설정

IMQA에서는 등록된 앱 버전 중 더 이상 관리하지 않을 버전을 숨길 수 있습니다. 지원이 끝난 앱 버전 또는 개발 버전 등의 비활성화에 활용할 수 있습니다. 앱 버전 숨김 설정시, 앱 목록 등에서 표시되지 않습니다. 현재 앱 버전 보기/숨김 처리는 앱 버전의 “표시여부” 설정 기능이며, 해당 앱 버전의 데이터 수집 비활성화 등의 기능으로 동작하지 않습니다.

앱 수정 단계에서 SDK/Agent 데이터 수집을 ON/OFF 하거나, 데이터 드롭 정책을 설정하고 제어할 수 있습니다. 서비스 안정화 또는 데이터 수집량 제어 등에 활용할 수 있습니다.

SDK 옵션 설정 변경 기록의 확인

앱 버전별 SDK 옵션 설정 변경 기록은 관리 > 감사로그에서 확인 가능합니다.

앱 버전별 데이터 수집을 ON/OFF 할 수 있습니다. 서비스 안정화 또는 데이터 수집량 제어 등에 활용할 수 있습니다. 설정 후 사용자의 다음 앱 실행 또는 페이지 새로고침 시 적용됩니다.

❶ 전체 앱 버전의 데이터 수집을 ON/OFF 할 수 있습니다. 기본은 전체 ON 으로 설정되어 있습니다.

❷ 특정 앱 버전의 데이터 수집만 ON/OFF 할 수 있습니다.

데이터 수집 ON/OFF 적용 시점

앱 버전별 데이터 수집 ON/OFF 설정이 사용자에게 적용되는 시점은 사용자마다 다를 수 있습니다. 해당 앱 버전을 사용하는 사용자의 다음 앱 실행 또는 페이지 새로고침 시 데이터가 수집 제어됩니다. 사용자의 접속 환경에서 IMQA SDK, WebAgent가 처음 실행될 때 데이터 수집 ON/OFF 상태를 확인, 저장 후 사용자의 다음 앱 실행 시점에 적용하므로, 모든 사용자에게 즉시 반영되지 않습니다. 자세한 내용은 IMQA 담당자에게 문의해 주세요.

앱 버전별 데이터 드롭 정책을 ON/OFF 설정하고 제어할 수 있습니다. 특정 앱 버전에 데이터 드롭 정책 사용을 설정하면, 최대 재시도 횟수를 설정할 수 있습니다. 예기치 못한 서버 문제가 발생한 경우 서비스 안정성 확보 또는 무분별한 데이터 재전송 시도 제어 등에 활용할 수 있습니다.

❶ 전체 앱 버전의 데이터 드롭 정책을 ON/OFF 할 수 있습니다. 기본은 전체 OFF 로 설정되어 있습니다.

❷ 특정 앱 버전의 데이터 드롭 정책만 ON/OFF 할 수 있습니다.

❸ 특정 앱 버전에 데이터 드롭 정책 사용시, 데이터 전송 재시도 최대 횟수를 제한할 수 있습니다. 기본은 5 로 설정되어 있습니다.

데이터 드롭 정책 ON/OFF 적용 시점

앱 버전별 데이터 드롭 정책 ON/OFF 설정이 사용자에게 적용되는 시점은 사용자마다 다를 수 있습니다. 사용자의 접속 환경에서 IMQA SDK, WebAgent가 처음 실행될 때 데이터 드롭 정책 ON/OFF 상태를 확인, 저장 후 해당 세션(실행) 동안 데이터 전송 실패 횟수를 누적하여 제어합니다. 자세한 내용은 IMQA 담당자에게 문의해 주세요.

데이터 드롭 정책 사용시 주의 사항

데이터 드롭 정책 사용은 현재 수집 서버가 모든 데이터를 정상적으로 수신할 수 없는 상태인 경우에 활용될 수 있습니다. 일반적으로 운영 환경에서 사용자의 네트워크 상태에 따라 데이터 전송이 실패하는 경우가 다수 발생할 수 있습니다 (예: 엘리베이터 탑승 중). 데이터 드롭 정책은 해당 세션(실행) 동안의 재시도 횟수 초과 시 전송에 실패한 데이터를 삭제하므로 1개 세션에서 일부 데이터가 유실되는 데이터 정합성 이슈가 발생할 수 있습니다. 정책 사용시, 최대 재시도 횟수를 점진적으로 조정하며 관리하는 것을 권고합니다. 자세한 내용은 IMQA 담당자에게 문의해 주세요.

IMQA 매핑 파일 관리를 통해 앱 버전별 매핑 파일을 업로드하여 ProGuard, Symbolication 등이 적용된 앱에서 클래스 명과 함수 명을 가독화할 수 있습니다.

지원되는 난독화 종류 및 업로드 파일 크기 제한

IMQA는 현재 앱 유형별 아래의 역난독화를 지원하고 있습니다. 난독화 종류는 지속적으로 업데이트 예정입니다.

• - Android: ProGuard, Allatori, Source Map(웹뷰)
• - iOS: dSYM, Source Map(웹뷰)
• - Web: Source Map

매핑 파일 업로드 시, 200MB 이하의 매핑 파일만 업로드할 수 있습니다. 제한 용량 이상의 파일 업로드는 IMQA 담당자에게 문의해 주세요.

매핑 파일의 적용 시점

ProGuard, dSYM 등의 경우, 매핑 파일 업로드 이후부터 수집되는 난독화 정보를 가독화 하여 저장합니다. 업로드 한 매핑 파일 적용에 다소 시간이 소요될 수 있으며, 스택 트레이스 조회 시점에 난독화 정보로 보여질 수 있습니다. Source Map의 경우, 수집된 웹 에러 스택 트레이스 정보 조회 시 먼저 웹 버전이 일치하는 소스맵 파일을 즉시 적용합니다. 일치하는 웹 버전 소스맵 파일이 없을 경우 앱 버전이 일치하는 소스맵 파일을 즉시 적용합니다.

IMQA 매핑 파일 관리는 다음과 같이 구성됩니다.

❶ 툴바(매핑 파일 관리)

❷ 매핑 파일 목록

❶ 매핑 파일 업로드: 새 매핑 파일을 업로드할 수 있습니다.

앱 관리 > 매핑 파일 관리 페이지 오른쪽 상단의 [+ 매핑 파일 업로드] 버튼을 클릭하면 매핑 파일을 업로드할 수 있는 팝업이 표시됩니다.

❶ 앱과 앱 버전을 선택합니다.

❷ 난독화 종류를 선택합니다.

난독화 종류

IMQA에서는 난독화 종류를 구분하여 매핑 파일을 관리할 수 있습니다. 모바일 앱의 버전에 사용한 난독화 종류(솔루션)의 매핑 파일을 업로드 해야 하며, 동일한 앱 버전에 같은 종류의 여러 매핑 파일이 업로드 되어있을 경우, 가장 최신 매핑 파일을 가독화(Decoding) 로직에 사용합니다.

❸ 난독화 종류에 맞는 매핑 파일을 선택합니다.

Android의 Build 과정에서 생성된 ProGuard 매핑 파일을 업로드할 수 있습니다. ‘mapping.txt’, ‘map.txt’ 등 .txt 파일을 업로드해 주세요.

매핑 파일을 통한 난독화된 정보 가독화(Decoding)

매핑 파일 업로드 이후부터 수집되는 난독화 정보를 가독화 하여 저장합니다. 업로드 한 매핑 파일 적용에 다소 시간이 소요될 수 있으며, 스택 트레이스 조회 시점에 난독화 정보로 보여질 수 있습니다.

Android의 Build 과정에서 생성된 Allatori 매핑 파일을 업로드할 수 있습니다. ‘mapping.xml’ 등 .xml 파일을 업로드해 주세요.

매핑 파일을 통한 난독화된 정보 가독화(Decoding)

매핑 파일 업로드 이후부터 수집되는 난독화 정보를 가독화 하여 저장합니다. 업로드 한 매핑 파일 적용에 다소 시간이 소요될 수 있으며, 스택 트레이스 조회 시점에 난독화 정보로 보여질 수 있습니다.

iOS의 Build 과정에서 생성된 dSYM 파일을 업로드할 수 있습니다. ‘dSYM’ 패키지 안의 바이너리 파일 에 .map 확장자를 붙여 업로드해 주세요.

(바이너리 파일).map

IMQA에서는 정보 보안을 위해 허용되는 확장자 외 파일 업로드를 제한하고 있습니다. dSYM 바이너리 파일의 경우, (바이너리 파일).map 로 확장자를 확인하고 있습니다.

매핑 파일을 통한 난독화된 정보 가독화(Decoding)

매핑 파일 업로드 이후부터 수집되는 난독화 정보를 가독화 하여 저장합니다. 업로드 한 매핑 파일 적용에 다소 시간이 소요될 수 있으며, 스택 트레이스 조회 시점에 난독화 정보로 보여질 수 있습니다.

Android, iOS 하이브리드 앱(웹뷰) 또는 Web 에서 수집된 웹 에러 스택 트레이스에서, 원본 소스 코드 위치를 파악할 수 있습니다.

웹 Bundler 로 생성한 js.map 파일을 단일 업로드 또는 압축한 zip 파일로 업로드할 수 있습니다. ‘index.js.map’, ‘vue-js-map_100.zip’ 과 같이 .map 또는 .zip 파일을 업로드해 주세요.

Source Map 웹 버전으로 관리

Source Map(웹뷰)의 경우, 앱 버전과 구분하여 웹 버전으로도 매핑 파일을 관리할 수 있습니다. (IMQA WebAgent에서 웹 버전 설정 하여 데이터 수집 필요) 자세한 내용은 IMQA WebAgent 설치 가이드를 참고해주세요.

매핑 파일을 통한 난독화된 정보 가독화(Decoding)

Source Map의 경우, 수집된 웹 에러 스택 트레이스 정보 조회 시 먼저 웹 버전이 일치하는 소스맵 파일을 즉시 적용합니다. 일치하는 웹 버전 소스맵 파일이 없을 경우 앱 버전이 일치하는 소스맵 파일을 즉시 적용합니다.

현재 등록된 매핑 파일 목록을 확인할 수 있습니다. 기본은 최근 업로드 일시 순으로 정렬 됩니다.

IMQA 감사 로그를 통해 IMQA 사용자들의 로그인, 기능 사용 이력을 확인할 수 있습니다.

사용자 개인화 영역 기능 사용 이력

IMQA의 사용자 개인화 영역(예: MY 대시보드) 기능 사용은 기록하지 않으며, 감사 로그로 제공되지 않습니다.

IMQA 감사 로그는 다음과 같이 구성됩니다.

❶ 툴바(감사 로그)

❷ 로그 목록

❶ 조회 조건: 조회하고자 하는 기간을 선택할 수 있습니다. '최근 5분' 부터 '오늘' 등 빠른 버튼을 활용해 기간을 선택할 수 있으며, 'Custom' 으로 시작일시와 종료일시를 설정할 수 있습니다.

❷ 새로고침: 현재 화면에 표시된 조회 결과 데이터를 새로고침합니다.

❸ 데이터 다운로드: 현재 화면에 표시된 조회 결과를 .csv로 다운로드할 수 있습니다.

조회하고자 하는 특정 로그 메시지가 있을 경우 메시지에 포함된 3글자 이상의 검색어를 입력합니다. [적용]을 클릭하면 선택한 필터 기준으로 데이터가 조회됩니다.