# IMQA 설치 매뉴얼

## 1단계: 생성 및 설치

### 프로젝트 생성 <a href="#project" id="project"></a>

* 가장 먼저 프로젝트를 생성하여 IMQA와 앱을 연결해야 합니다.
* 안드로이드와 iOS 모두 운영할 경우, 각 OS별로 총 2개의 프로젝트를 생성합니다.\
  (LITE의 경우, 1개의 프로젝트만 생성 가능)
* MPM 선택 후 프로젝트 생성 시 Crash와 MPM 모두 사용 가능합니다.
* [프로젝트 생성 방법 자세히 보기](https://docs.imqa.io/imqa-guide/imqa#project-lite)&#x20;

### SDK 설치･설정

* 프로젝트 생성 시 선택한 OS 기준으로 SDK를 설치･설정합니다.
* [설치 방법 영상으로 보기](https://youtu.be/IZ2Aptlrk6k)
* [\[AOS\] SDK 설치 및 설정하기](https://docs.imqa.io/imqa-guide/installation/android)
* [\[iOS\] SDK 설치 및 설정하기](https://docs.imqa.io/imqa-guide/installation/ios)

{% hint style="warning" %}
안드로이드는 MPM SDK를 설치하면 Crash SDK를 별도로 설치할 필요가 없습니다.
{% endhint %}

## 2단계: 데이터 정상 수집 확인하기

프로젝트 생성 후 SDK 설치 및 설정까지 마치셨다면, 이제 데이터가 아래와 같이 정상적으로 수집되는지 확인해 보세요.

<figure><img src="https://3726060384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFyCopc6yAp3UcEYW6la%2Fuploads%2FXxLmddUHDKGUe4qOX7qF%2Fmpm%E1%84%83%E1%85%A2%E1%84%89%E1%85%B5%E1%84%87%E1%85%A9%E1%84%83%E1%85%B3%E1%84%8B%E1%85%B5%E1%86%B7%E1%84%89%E1%85%B5.png?alt=media&#x26;token=58de50a5-f4ae-4944-b212-ed15d1bdbe65" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3726060384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzFyCopc6yAp3UcEYW6la%2Fuploads%2F8OzCuX2mRxnkT7HxrihS%2Fcrash_%E1%84%83%E1%85%A2%E1%84%89%E1%85%B5%E1%84%87%E1%85%A9%E1%84%83%E1%85%B3.png?alt=media&#x26;token=bbf05190-02eb-40ff-9b7a-3d481f375611" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
SDK를 설치하였는데도 데이터가 보이지 않는다면, 아래와 같은 문제가 있을 수 있습니다.

1. 사용자가 없는 앱의 경우 수집되는 데이터가 없어 보이지 않을 수 있음
2. 설치가 잘못된 경우 데이터가 수집되지 않을 수 있음
3. 제공되는 사용량이 초과될 경우 데이터가 수집되지 않아 보이지 않을 수 있음\
   (사용 플랜에 따라 제공되는 사용량이 상이합니다.)
   {% endhint %}

2번의 경우, 아래 문의 채널을 통해 문의해 주시면 SDK 설치 담당자를 통해 안내해 드리겠습니다.

* **개발자 포럼(IMDev)**: <https://imdev.imqa.io>
* **채팅 상담**: <https://imqa.channel.io/>
* **메일**: <support@imqa.io>
* **전화**: (02)6395-7730

## 3단계: 필수 기능 설정하기

IMQA를 더욱 효율적으로 사용하기 위해 아래 항목을 설정해 주세요.

> 1\. 알림
>
> 2\. 프로젝트 프리셋
>
> 3\. 커스텀 에러
>
> 4\. 프로가드/dSYM 설정
>
> 5\. 화면 이름 변경 (유료 플랜 only)

### 1. 현재 앱의 상황을 인지할 수 있는 '알림' <a href="#alarm" id="alarm"></a>

* 성능 지표별 기준치를 설정하여 그 이상이 되었을 때 알림 발송
* 앱의 위험 상황을 인지하여 장애 발생 전 대처하거나 장애 발생 후 더 큰 장애로 번지는 것을 방지
* [알림 설정 방법 확인하기](https://docs.imqa.io/imqa-guide/user-guide/mpm/alert)

### 2. 성능 관리를 위한 기본값 '프로젝트 프리셋' <a href="#preset" id="preset"></a>

* 성능 지표별 성능 저하 기준/위험도를 설정하여 기준치 이상 데이터 비율로 위험, 경고, 정상 수준 확인
* 앱의 상황에 맞게 설정하면 효율적인 모니터링과 관리가 가능
* [프로젝트 프리셋 설정 방법 확인하기](https://docs.imqa.io/imqa-guide/user-guide/mpm/management#project-preset)

### 3. 모든 에러를 관리할 수 있는 '커스텀 에러' <a href="#custom" id="custom"></a>

* 일반적인 크래시 솔루션에서 수집되지 않는 에러까지 수집 가능
* 사용자 경험을 개선하여 고객 만족도를 향상시킬 수 있음
* [\[AOS\] 커스텀 에러 설정 방법 확인하기](https://docs.imqa.io/imqa-guide/android/crash-sdk-setting#custom-crash)
* [\[iOS\] 커스텀 에러 설정 방법 확인하기](https://docs.imqa.io/imqa-guide/ios/crash-sdk-setting#2.)

### 4. 난독화된 코드를 복호화하는 '프로가드/dSYM 설정' <a href="#dsym" id="dsym"></a>

* AOS는 프로가드 설정, iOS는 dSYM 설정을 통해 매핑 파일 등록
* 클래스명과 함수명까지 확인할 수 있어 분석이 용이
* [프로가드/dSYM 설정 방법 확인하기](https://docs.imqa.io/imqa-guide/ios/mpm#4.-dsym)

### 5. 앱의 각 화면 이름을 이해하기 쉽게 변경하는 '화면 이름 설정' <a href="#name" id="name"></a>

* 관리 중요도가 낮고 보기를 원하지 않는 화면 및 도메인 정보 숨김 처리 가능
* 가독성이 높아져 관리가 용이
* 본 기능은 유료 플랜에서 사용하실 수 있습니다.
* [화면 이름 변경 방법 확인하기](https://docs.imqa.io/imqa-guide/user-guide/mpm/management#changing-screen-name)

진행하는 과정에서 불편함이 있으시다면 아래 채널 중 편하신 방법으로 언제든지 연락해 주세요. 원활히 설치 및 설정을 완료하실 수 있도록 도와드리겠습니다.

* **개발자 포럼(IMDev)**: <https://imdev.imqa.io>
* **채팅 상담**: <https://imqa.channel.io/>
* **메일**: <support@imqa.io>
* **전화**: (02)6395-7730

3단계까지 모든 설정을 마치셨다면, 이제 IMQA와 함께 앱의 크래시와 성능을 관리하세요!

또한 \[[IMQA 활용하기](https://docs.imqa.io/imqa-guide/user-guide/use)]를 참고하시고 보다 효율적으로 IMQA를 사용해 보세요.