# IMQA 설치 매뉴얼

## 1단계: 생성 및 설치

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

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

### SDK 설치･설정

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

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

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

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

<figure><img src="/files/huM6qwRuCB1AGyxPZVHi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/cy7hjJdik9ErIiF6RlAA" 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>

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

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

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

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

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

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

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

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

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

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.imqa.io/imqa-guide/installation/summary.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.