# 딥링크 개요

**딥링크**(Deep links)는 `https://acme.<링크 도메인>/spring` 같은 짧은 링크입니다. 이메일, 광고, QR 코드, SNS 게시물에 넣어 씁니다. 방문자는 이어서 볼 수 있는 곳으로 이동합니다. iPhone 사용자는 앱의 App Store 페이지나 iOS용 웹 페이지로, Android 사용자는 Google Play나 Android용 웹 페이지로, 그 밖의 방문자는 웹사이트로 갑니다.

설치된 앱을 링크에서 바로 여는 기능은 이후 업데이트에서 추가됩니다. 지금은 링크가 항상 스토어 페이지나 지정한 웹 페이지로 이동하고, 모든 방문을 셉니다([클릭](#클릭) 참고).

## 1. 딥링크 켜기

워크스페이스의 **제품**(Products) 페이지에서 **딥 링크**(Deep links)를 켭니다. 그러면 프로젝트에 **딥링크** 페이지가 생깁니다.

## 2. 앱 등록하기

링크는 휴대폰 방문자를 앱의 스토어 페이지로 보내므로 앱을 먼저 등록합니다. 프로젝트의 **개요**(Overview) 페이지에서 **앱**(Apps) 아래에 iOS 앱을 숫자로 된 **App Store ID**와 함께, Android 앱을 **애플리케이션 ID**(Application ID)와 함께 추가합니다. Play 패키지가 애플리케이션 ID와 다르면 **Play 패키지**도 입력합니다. 자세한 내용은 [워크스페이스와 프로젝트](https://www.mocco.club/docs/ko/articles/iu3d9y-workspace-and-projects#4-register-your-apps)를 참고하세요.

iOS나 Android 앱이 없는 프로젝트도 링크를 만들 수 있습니다. 이때는 링크마다 웹 대체 주소가 있어야 합니다(5단계).

## 3. 링크 호스트 정하기

**딥링크**에서 **설정**을 열고 **링크 호스트** 아래 **서브도메인**에 `acme` 같은 값을 입력한 뒤 **저장**을 선택합니다. 링크는 `acme.<링크 도메인>`에 놓입니다. 서브도메인은 소유자와 관리자만 바꿀 수 있습니다.

신중하게 정하세요. 프로젝트에 링크가 하나라도 생기면 서브도메인을 바꿀 수 없습니다. 바꾸면 이미 공유하거나 인쇄한 링크가 모두 끊기기 때문입니다.

## 4. 링크 만들기

**딥링크**에서 **새 링크**를 선택합니다. 링크가 가리키는 **앱 안의 경로**를 `/products/42`처럼 입력합니다. 필요하면 **슬러그**(호스트 뒤에 오는 부분, 비워 두면 Mocco가 짧게 만듭니다), **이름**, **캠페인**, **파라미터**, 만료일(**만료**)도 입력합니다. 그런 다음 **링크 만들기**를 선택합니다.

링크의 짧은 URL은 복사 버튼과 함께 표시됩니다. 슬러그는 나중에 바꿀 수 없으므로 인쇄한 QR 코드도 계속 작동합니다.

이름이 `utm_`으로 시작하는 파라미터(예: `utm_source=qr`)는 방문자를 웹 대체 주소로 보낼 때 그 URL에 덧붙습니다. 그래서 분석 도구에서 방문자가 어디서 왔는지 볼 수 있습니다.

## 5. 앱이 없는 사람을 웹사이트로 보내기(선택)

**웹 대체 주소 (선택)** 아래에서 iOS용 페이지, Android용 페이지, 그 밖의 모든 기기용 페이지를 지정할 수 있습니다. 링크가 내 것이 아닌 사이트로 사람을 보내지 않도록, 웹 대체 주소는 소유를 확인한 **웹 목적지**에 있어야 합니다. **설정 → 웹 목적지**에서 `www.acme.com`처럼 정확한 호스트를 추가하고, 표시되는 TXT 레코드를 게시한 뒤 확인합니다.

## 방문자별 이동 위치

| 방문자 | 다음 중 설정된 첫 번째 위치로 이동 |
| --- | --- |
| iPhone, iPad | iOS 웹 대체 주소, App Store 페이지, 웹 대체 주소 |
| Android | Android 웹 대체 주소, Google Play 페이지, 웹 대체 주소 |
| 컴퓨터와 그 밖의 기기 | 웹 대체 주소 |

모두 설정되어 있지 않으면 방문자는 다른 곳으로 이동하지 않고 작은 페이지를 봅니다. 이 페이지에는 링크 이름(없으면 프로젝트 이름), 등록된 스토어 페이지마다 버튼, 그리고 컴퓨터에서는 휴대폰에서 열 수 있는 짧은 URL이 표시됩니다.

![웹 대체 주소가 없는 링크를 컴퓨터에서 열었을 때 보이는 페이지: 휴대폰에서 열거나 스토어로 이동](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/5f1d2107-3c6c-45b9-8c69-468b2ac40502/links-landing.png)

- 기본 데스크톱 모드의 iPad는 컴퓨터로 처리합니다.
- 링크 미리보기(Slack, 카카오톡, X 등)는 컴퓨터로 처리합니다.
- 슬러그 뒤에 무엇을 덧붙여도 이동 위치는 바뀌지 않습니다. 그래서 누구도 내 링크를 다른 곳으로 보내는 데 쓸 수 없습니다.

## 클릭

링크 방문은 모두 날짜(UTC)와 플랫폼(iPhone, Android, 컴퓨터, 기타)별로 셉니다. **딥링크** 목록에는 링크마다 최근 7일 클릭 수가 나오고, 링크 페이지의 **클릭**에는 합계, 그중 사람의 수, 플랫폼별 수, 기간의 날짜별 수가 나옵니다. 숫자 위에서 기간(최근 7일, 30일, 90일, 365일)을 고릅니다. 페이지 주소에 기간이 남아서, 주소를 공유하면 같은 기간이 보입니다.

- **사람**에는 링크 미리보기(Slack, 카카오톡, X 등)가 빠집니다. 미리보기는 카드를 만들려고 링크를 가져가는데, **클릭**에는 들어갑니다.
- Mocco는 방문자의 IP 주소나 브라우저 정보를 보관하지 않습니다. 플랫폼, 네트워크가 알려 주는 국가, 방문자가 온 웹사이트(사이트 이름만, 페이지는 아님)를 보관합니다.
- 방문 하나하나는 90일 동안 보관하고, 날짜별 수는 프로젝트가 있는 동안 남습니다.
- 방문하고 몇 초 안에 숫자에 반영됩니다.

Mocco에 연결한 AI 어시스턴트에게 링크나 프로젝트의 클릭 수를 물어볼 수도 있습니다.

## 링크 끄기와 만료

링크는 삭제할 수 없습니다. 그래서 같은 슬러그가 다른 곳을 가리키며 다시 나타나는 일이 없습니다. 링크 페이지의 **링크 끄기**를 선택하면 링크가 멈추고, 방문자는 "종료된 링크입니다"라는 페이지를 봅니다. **링크 켜기**로 다시 켤 수 있습니다. 만료일이 지난 링크도 같은 페이지를 보여 줍니다.

변경 사항은 1분 안에 모든 곳에 반영됩니다.

## 악용된 링크 신고

링크 호스트가 링크에 대해 보여 주는 모든 페이지 아래에는 **이 링크 신고하기**가 있습니다. 피싱, 악성 코드, 스팸에 쓰인 링크를 발견한 사람은 누구나 여기서 알려 줄 수 있습니다. 신고는 **딥링크 → 신고**에 사유, 작성한 내용, 남긴 이메일과 함께 쌓입니다. 멤버라면 누구나 다음을 할 수 있습니다.

- 조치가 필요 없는 신고는 **닫기**를 선택합니다.
- 신고된 링크를 멈추려면 **링크 끄기**를 선택합니다. 그 링크에 열려 있는 다른 신고도 함께 처리되고, 링크 페이지에 신고로 꺼졌다고 표시됩니다.

신고가 들어올 때 알림을 받으려면 채널에 **`links.abuse.reported`** 알림 규칙을 추가합니다. 신고가 몇 건 들어오든 링크마다 하루에 한 번 옵니다.

## 모든 링크 일시 중지

여러 링크가 한꺼번에 악용될 때는 소유자와 관리자가 모두 멈출 수 있습니다. **딥링크 → 설정**에서 **모든 링크 일시 중지**를 선택하고, 원하면 팀에게만 보이는 사유를 적습니다. 그러면 **링크 다시 열기**를 선택할 때까지 모든 링크가 "이 링크는 잠시 사용할 수 없어요"를 보여 줍니다. 일시 중지된 동안에도 링크를 신고할 수 있습니다.