> ## Documentation Index
> Fetch the complete documentation index at: https://docs.habitify.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 데이터

## Habitify로 데이터 가져오기

새로운 앱을 시작하는 일은 설레지만, 다른 앱이나 스프레드시트에 쌓아 온 소중한 추적 기록을 잃고 싶지 않다는 점도 잘 알고 있습니다. 이 섹션에서는 지금까지의 여정을 한눈에 볼 수 있도록 과거 데이터를 Habitify로 가져오는 몇 가지 방법을 안내합니다.

### **건강 데이터 가져오기**

과거 데이터가 피트니스와 관련되어 있고 Apple Health, Health Connect, Fitbit 또는 Strava에 저장되어 있다면, 가장 쉽고 자동화된 방법으로 기록을 가져올 수 있습니다.

**작동 방식:** 이러한 서비스 중 하나를 Habitify의 습관에 처음 연결하면 앱에서 자동으로 **과거 기록 동기화**를 실행합니다. 이전 기록을 확인하여 과거 활동을 습관 기록으로 가져옵니다.

* **Apple Health 또는 Health Connect:** iPhone이나 Android 휴대폰에서 걸음 수, 운동, 수면, 마음 챙김 시간 등을 직접 동기화합니다.
* **Fitbit:** Fitbit 기기에 저장된 일일 걸음 수, 수면, 소모 칼로리 및 기타 통계를 자동으로 기록합니다.
* **Strava:** 달리기, 자전거 타기, 걷기 및 기타 운동을 마친 직후 해당 데이터를 습관에 직접 동기화합니다.

### Productive 앱에서 데이터 가져오기

이 기능을 사용하려면 먼저 Productive 앱에서 데이터를 내보내야 합니다. Productive는 일반적으로 데이터를 `.sqlite` 파일로 내보냅니다. Habitify로 가져오기를 시작하려면 이 파일을 미리 준비해야 합니다.

Habitify 앱에서 **설정 → 가져오기 / 내보내기 → Productive에서 가져오기**로 이동합니다.

그런 다음 내보낸 `.sqlite` 파일을 선택하고 화면의 안내에 따라 가져오기 과정을 완료합니다.

가져오기는 다음과 같은 핵심 습관 정보를 옮기는 데 중점을 둡니다.

* **습관:** 습관 목록입니다.
* **습관 기록:** 해당 습관의 과거 체크인, 건너뜀 및 실패 기록입니다.
* **시간대:** 아침, 오후 또는 저녁 설정입니다.
* **습관 설명:** 습관에 추가한 메모나 설명입니다.
* **종료 조건:** Productive에서 습관에 종료 날짜를 설정한 경우 해당 날짜를 가져옵니다. 단, 그 날짜가 오늘이거나 과거인 경우는 **제외**됩니다(Habitify의 종료 날짜는 적어도 7일 후여야 합니다).

> [!NOTE]
>
> **중요 사항:**
>
> * Productive의 **도전**과 **프로그램**은 Habitify로 가져오지 **않습니다**. 개별 습관만 전송됩니다.
> * Productive에서 **일시 정지 또는 중단**으로 표시한 습관은 Habitify로 가져오지만 자동으로 **보관됨** 상태가 됩니다. 필요한 경우 나중에 보관을 해제할 수 있습니다.

가져오기 과정에서 Productive의 일정과 목표가 Habitify 형식으로 자동 변환됩니다. 변환 방식은 다음과 같습니다.

* **매일 / 특정 요일 / 특정 날짜:** Productive에서 매일, 특정 요일 또는 매월 특정 날짜에 반복하도록 설정한 습관은 동일한 일정을 유지한 채 Habitify의 **일일 목표**로 가져옵니다.
* **하루에 여러 목표:** Productive 습관에 하루 동안 여러 목표가 있었다면(예: "아침 2회 + 저녁 2회"), Habitify에서는 이를 **합산**하여 하나의 일일 목표로 만듭니다(예: "하루 4회").
* **주간 빈도(예: "주 3회"):** Productive 습관에 주간 빈도(예: "주 3회")와 일일 목표(예: "매회 20분")가 설정되어 있었다면, Habitify에서는 빈도와 일일 목표를 곱해 하나의 **주간 목표**로 변환합니다.\
  *예:* Productive: "주 3회, 하루 20분" → Habitify: **"주 60분"**.
* **특수한 경우 - 격주:** Productive에서 습관을 예를 들어 "2주마다 1회" 반복하도록 설정했다면, 이 특정 간격은 가져오기에서 직접 지원되지 않습니다. 대안으로 Habitify의 **일일 목표**로 변환됩니다. 가져온 후 이 습관의 일정을 직접 조정해야 할 수 있습니다.

### Streak 앱에서 데이터 가져오기

이 기능을 사용하려면 먼저 Streaks 앱에서 데이터를 내보내야 합니다. Streaks는 일반적으로 이 데이터를 `.streaks` 확장자의 특수 파일로 내보냅니다. Habitify로 가져오기를 시작하려면 이 파일을 미리 준비해야 합니다.

Habitify 앱에서 **설정 → 가져오기 / 내보내기 → Streaks에서 가져오기**로 이동합니다.

그런 다음 내보낸 `.streaks` 파일을 선택하고 화면의 안내에 따라 가져오기 과정을 완료합니다.

가져오기 과정은 다음과 같은 습관 추적의 핵심 요소를 옮기도록 설계되었습니다.

* **습관 이름:** 습관 이름이 그대로 유지됩니다.
* **반복 일정:** 습관을 실천하는 주기(매일, 매주, 매월)가 변환됩니다.
* **목표 빈도:** 습관 목표가 "하루/주/월 X회"였다면 이 목표가 유지됩니다.
* **미리 알림:** 사용자 지정 알림 시간이 옮겨집니다(아래 세부 정보 참조).
* **습관 메모:** 습관에 추가한 모든 메모가 복사됩니다.
* **기록이 있는 첫 날짜를 시작 날짜로 사용:** Habitify는 Streaks에서 가장 이른 기록의 날짜를 "시작 날짜"로 사용합니다.
* **기록 내역:** 과거 완료, 실패 및 건너뛴 날을 가져옵니다.
* **나쁜 습관:** 끊거나 제한하려던 습관도 가져옵니다(아래 세부 정보 참조).

Habitify와 Streaks의 작동 방식이 약간 다르므로 가져오는 과정에서 일부 데이터가 변환됩니다. 알아 두어야 할 가장 중요한 사항은 다음과 같습니다.

**1/ 미리 알림**

Streaks에서 특정 알림 시간을 설정했다면 정확히 같은 시간이 Habitify에 동기화됩니다. 또한 Streaks에는 Habitify에서 지원하지 않는 "자동 알림" 기능이 있습니다. 이러한 알림은 가져오지 **않습니다**.

**2/ 기록 내역**

* **일일 습관:** 변환 방식이 간단합니다.
  * Streaks의 `Complete` → Habitify의 `Complete`
  * Streaks의 `Failed` → Habitify의 `Failed`
  * Streaks에서 ***기록하지 않은*** 날은 Habitify에서 `Skipped`로 표시됩니다(연속 기록 유지).
* **주간 습관:** Habitify에서는 한 주를 일요일이나 월요일에만 시작할 수 있지만, Streaks에서는 어느 요일이든 시작일로 지정할 수 있습니다. 따라서 Streaks의 주간 기록 데이터는 Habitify에서 해당 주의 **월요일**에 할당됩니다.\
  *예:* Streaks에서 한 주를 수요일부터 화요일까지로 설정했다면, 그 주 전체의 완료 상태가 Habitify에서는 해당 주의 월요일에 표시됩니다.
* **월간 습관:** 주간 습관과 마찬가지로 Streaks에서 한 달 전체의 완료 상태가 Habitify에서는 **해당 월의 1일**에 할당됩니다.

**3/ 나쁜 습관의 목표**

* **습관 끊기:** Streaks의 목표가 "\[습관 이름] 안 하기"였다면, Habitify에서는 습관을 성공적으로 피한 날을 추적하는 \*\*"습관 끊기"\*\*로 가져옵니다.
* **습관 제한하기:** Streaks에서 나쁜 습관을 "하루/주/월 X회"로 제한하는 것이 목표였다면, Habitify에서는 동일한 빈도 목표를 가진 \*\*"습관 제한하기"\*\*로 가져옵니다.

### **스프레드시트에서 데이터 가져오기**

이전 추적 데이터가 스프레드시트에 있다면(다른 앱에서 내보냈거나 직접 관리한 경우 등), **Zapier**라는 서비스를 사용하여 가져올 수 있습니다. 이 방법은 조금 더 복잡하지만 어떤 습관이든 전체 과거 기록을 채우는 데 적합합니다.

이 방법은 Google Sheet의 새 행을 감지하고 Habitify에 그에 해당하는 기록을 생성하는 자동화("Zap")를 사용합니다. 이전 데이터를 가져오려면 Google Sheet에 데이터를 복사하여 붙여넣고 이 과정을 실행합니다.

다음 단계를 따르세요.

**1. 데이터 스프레드시트 준비하기**

먼저 이전 데이터를 [Google Sheets 템플릿](https://docs.google.com/spreadsheets/d/1LN3wqWGwHToYL0pWqYPCGztiY9Rxi9KA_xLo1poQdU8/edit?usp=sharing)에 맞게 구성해야 합니다. 각 시트에는 습관 하나의 진행 기록이 저장됩니다. 즉, 각 행이 한 번의 완료를 나타내도록 기록을 정리해야 합니다(구체적인 날짜, 시간 및 숫자 값 포함).

**2. Habitify 습관 설정하기**

데이터를 가져올 대상이 되는 습관을 Habitify에 만듭니다.

**3. 간편한 설정을 위해 Zapier 템플릿 사용하기**

데이터를 가져올 대상이 되는 습관을 Habitify에 만듭니다.

**4. Zap을 실행하여 데이터 가져오기**

Zap이 활성화되면 과거 데이터 전체를 Google Sheet에 복사하여 붙여넣을 수 있습니다. 그러면 Zapier가 각 행을 읽고 날짜가 지정된 기록으로 Habitify에 가져와 진행 상황의 과거 기록을 성공적으로 채웁니다.

Airtable, Online Microsoft Excel, Zoho Sheet 등 다른 데이터 표 서비스를 사용해서도 Zapier를 통해 동일한 연동을 구현할 수 있습니다.

## Habitify에서 데이터 내보내기

두 가지 주요 내보내기 형식을 제공합니다. 기본적인 기록 분석을 위한 간단한 **CSV 파일**과 계정 전체를 완전하게 저장하는 종합적인 \*\*전체 백업 파일(.sqlite)\*\*입니다.

#### 단계별 가이드

1. Habitify 앱에서 **설정** 탭으로 이동합니다.
2. **가져오기 / 내보내기**를 찾아 탭합니다.
3. 원하는 내보내기 형식인 **.csv로 내보내기** 또는 **백업으로 내보내기**를 선택합니다.
4. 기기의 화면 안내에 따라 파일을 저장하거나 공유합니다(예: 이메일 또는 클라우드 저장소 이용).

#### **내보내기 파일 형식 비교**

| 형식 | .csv | 백업 |
| - | - | - |
| 추천 용도 | Google Sheets, Microsoft Excel 또는 Apple Numbers 같은 스프레드시트 소프트웨어에서 기본적인 습관 완료 기록을 분석할 때 사용합니다. | Habitify의 전체 설정과 기록을 완전하게 백업할 때 사용합니다. 나중에 데이터를 복원하거나 데이터베이스 도구로 고급 기술 분석을 수행하는 데 이 파일을 사용할 수 있습니다. |
| 파일 확장자 | `.csv` | `.sqlite` |
| 포함된 내용 | 이 내보내기 파일에는 습관 체크인의 기본 기록이 제공되며, 각 항목에 다음 열이 포함됩니다. <ul><li>`Habit`: 습관의 이름입니다.</li><li>`Date`: 기록 항목을 만든 날짜입니다.</li><li>`Total log`: 기록한 숫자 값입니다(해당하는 경우).</li><li>`Unit`: 목표에 연결된 단위입니다(예: 분, km, 회).</li><li>`Status`: 습관이 완료, 건너뜀 또는 실패로 표시되었는지를 나타냅니다.</li><li>`Habit ID`: 습관의 고유 식별자입니다.</li></ul> | 이 내보내기 파일에는 계정의 **모든 항목**을 담은 종합적인 스냅샷이 포함됩니다. 포함되는 항목은 다음과 같으며 이에 국한되지 않습니다. <ul><li>**습관 세부 정보:** 모든 습관(활성 및 보관됨), 목표, 체크리스트, 알림(시간, 위치, 습관 쌓기), 종료 조건, 마일스톤 등입니다.</li><li>**진행 상황 및 기록:** 모든 체크인, 건너뜀, 실패, 숫자 기록, 메모, 기분 기록, 체크리스트 기록, 연속 기록 내역(`currentStreak`) 및 계산된 진행 상황 데이터(`logCalculations`, `progresses`)입니다.</li><li>**설정:** 한 주의 시작 요일(`firstDayOfWeek`)과 같은 계정 설정입니다.</li></ul> |

## Habitify에서 데이터 관리하기

### 습관 데이터 재설정하기

> [!WARNING]
>
> 데이터를 재설정하기 전에 다음 사항을 확인하세요.
>
> * 이 작업을 수행하면 계정에 있는 모든 습관의 **과거 데이터가 모두 영구적으로 삭제됩니다**.
> * 여기에는 모든 체크인, 건너뜀, 실패, 현재 연속 기록, 메모 및 보관된 습관의 모든 진행 상황이 포함됩니다.
> * **이 과정은 실행 취소할 수 없습니다.** 데이터가 삭제되면 영원히 사라지며 지원팀에서도 복구할 수 없습니다.
> * *현재* 습관 목록은 유지되지만 진행 상황과 연속 기록은 0으로 재설정됩니다.

> [tab]  iOS
>
> 1. **Habitify**를 열고 **설정**으로 이동합니다.
> 2. 프로필을 탭합니다.
> 3. **개인정보 및 데이터** 섹션으로 이동하여 **습관 데이터 재설정**을 탭합니다.
> 4. 확인하려면 **습관 데이터 재설정**을 탭합니다.

> [tab] 🤖 Android
>
> 1. **Habitify**를 열고 **설정**으로 이동합니다.
> 2. 이름을 탭합니다.
> 3. **Caution zone**까지 아래로 스크롤합니다.
> 4. **습관 데이터 재설정** 옵션을 찾아 옆에 있는 **삭제** 버튼을 탭합니다.
> 5. 확인하려면 **확인**을 탭합니다.

> [tab] 🖥️ 웹사이트 및 데스크톱
>
> 1. Habitify 앱을 엽니다.
> 2. 프로필 사진을 클릭하고 **프로필**을 선택합니다.
> 3. **주의 구역**에서 **습관 데이터 재설정** 버튼을 찾아 클릭합니다.
> 4. 확인하려면 **습관 데이터 재설정**을 클릭합니다.

### 모든 데이터 삭제하기

> [!WARNING]
>
> 계속하기 전에 다음 내용을 매우 주의 깊게 읽어 주세요.
>
> * 이 작업을 수행하면 목록에서 **모든 습관**이 영구적으로 삭제됩니다.
> * 또한 모든 체크인, 건너뜀, 실패, 메모 및 연속 기록을 포함한 **모든 과거 데이터**가 영구적으로 삭제됩니다.
> * **이 과정은 실행 취소할 수 없습니다.** 확인하고 나면 모든 정보가 영원히 사라지며 사용자 본인이나 지원팀이 복구할 수 없습니다.
> * 계정이 **완전히 비어 있는 상태**가 됩니다.

> [tab]  iOS
>
> 1. **Habitify**를 열고 **설정**으로 이동합니다.
> 2. 프로필을 탭합니다.
> 3. **개인정보 및 데이터** 섹션으로 이동하여 **모든 데이터 삭제**를 탭합니다.
> 4. 확인하려면 **모든 데이터 삭제**를 탭합니다.

> [tab] 🤖 Android
>
> 1. **Habitify**를 열고 **설정**으로 이동합니다.
> 2. 이름을 탭합니다.
> 3. **Caution zone**까지 아래로 스크롤합니다.
> 4. **모든 데이터 삭제** 옵션을 찾아 옆에 있는 **삭제** 버튼을 탭합니다.
> 5. 확인하려면 **확인**을 탭합니다.

> [tab] 🖥️ 웹사이트 및 데스크톱
>
> 1. Habitify 앱을 엽니다.
> 2. 프로필 사진을 클릭하고 **프로필**을 선택합니다.
> 3. **주의 구역**에서 **데이터 삭제** 버튼을 찾아 클릭합니다.
> 4. 확인하려면 **모든 데이터 삭제**를 클릭합니다.

## 자주 묻는 질문

> [accordion] **내보낸 CSV 파일을 Excel에서 열면 왜 하나의 열에만 표시되나요?**
>
> Excel이 CSV 파일에 사용된 구분 기호를 인식하지 못하면 이런 현상이 발생합니다. Habitify에서 내보낸 파일은 세미콜론(`;`)으로 필드를 구분하지만 Excel 설정에서는 다른 구분 기호를 예상할 수 있습니다.
>
> **데이터를 별도의 열에 표시하려면 어떻게 해야 하나요?**
>
> 1. Excel에서 CSV 파일을 열고 **A열**을 선택합니다.
> 2. **데이터 → 텍스트 나누기**로 이동합니다.
> 3. **구분 기호로 분리됨**을 선택한 다음 **다음**을 클릭합니다.
> 4. **세미콜론**을 선택하고 다른 구분 기호의 선택을 해제합니다.
> 5. **마침**을 클릭합니다.
>
> 데이터가 **습관, 날짜, 총 기록, 단위, 상태 및 습관 ID**라는 별도의 열로 표시됩니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.