딥링크
딥링크 생성
AdStage에서 트래킹 가능한 딥링크를 생성하여 앱/캠페인/광고 채널별로 사용자 유입 경로를 추적할 수 있습니다. 이 문서는 딥링크 생성 절차와 각 입력 항목에 대한 설명을 제공합니다.
[이미지]
1. 딥링크 생성 화면 진입
- 좌측 메뉴 →
딥링크 > 딥링크 목록 - 우측 상단의 [+ 새 딥링크] 버튼 클릭
2. 기본 정보 입력
- 링크 이름: 내부에서 구분할 수 있도록 자유롭게 입력
- 설명: 선택사항. 운영 목적 또는 채널명을 기입하면 유용함
- 단축 경로: 자동 생성되며,
adg.im/xxx형식의 링크로 배포 가능 - 상태: 링크 활성/비활성 여부 지정

3. 트래킹 파라미터 입력
딥링크에 포함되는 마케팅 트래킹 파라미터를 설정합니다. 이 값들은 클릭 및 설치 데이터를 분석하는 데 사용됩니다.
| 항목 | 설명 |
|---|---|
| 소스 | 유입 채널 (예: google, facebook) |
| 매체 | 광고 타입 (예: cpc, display, social) |
| 캠페인 | 캠페인 명칭 |
| 광고그룹 | 광고 그룹 식별자 |
| 소재 | 배너/비디오 등 광고 소재 구분 |
| 콘텐츠 | 콘텐츠 구분 (예: 메인배너 등) |
| 키워드 | 검색 광고 키워드 |
![]()
4. 플랫폼별 리디렉션 설정
플랫폼(Android, iOS, Desktop) 별로 사용자가 어떤 경로로 이동할지 선택할 수 있습니다.
목적지 유형
| 유형 | 설명 |
|---|---|
| 앱 스토어 | 항상 해당 플랫폼의 앱 마켓으로 이동합니다. 앱이 설치되어 있어도 앱이 열리지 않습니다. |
| 앱 | 앱 실행을 우선 시도합니다. 실패 시 자동으로 fallback UI가 표시되어 사용자가 스토어나 웹으로 이동할 수 있습니다. |
| 웹사이트 | 항상 지정된 웹 URL로 이동합니다. 앱 실행은 시도하지 않습니다. |
⚠️ "목적지" 설정값에 따라 기본 동작이 결정되지만, 플랫폼은 자동으로 감지되어 각 플랫폼에 맞는 처리가 적용됩니다.
플랫폼별 세부 동작
- 모바일 (iOS/Android)
- 목적지 = 앱: 정교한 딥링크 시도
- Universal Links (iOS) / App Links (Android)
- Custom Scheme
- 실패 시 fallback UI 자동 표시
- 목적지 = 앱 스토어: 바로 스토어로 이동
- 목적지 = 웹사이트: 바로 웹 URL로 이동
- 목적지 = 앱: 정교한 딥링크 시도
- Desktop
- 자동 웹 이동 ON: 설정된 웹 URL로 자동 리다이렉트 (1초 후)
- 자동 웹 이동 OFF: "모바일 앱에서만 열 수 있습니다" 메시지 표시
- 인앱 브라우저 특별 처리
- 카카오톡, 페이스북, 인스타그램 등에서는 Universal/App Links 건너뛰고 Custom Scheme 직접 시도
설정 예시
- Android 설정:
- 앱 스킴:
com.example.app - 웹 fallback URL:
https://yourdomain.com/android - 스토어 URL:
https://play.google.com/store/apps/details?id=com.example.app
- 앱 스킴:
- iOS 설정:
- 앱 스킴:
com.example.iosapp - 웹 fallback URL:
https://yourdomain.com/ios - 스토어 URL:
https://apps.apple.com/app/idXXXXXXXXX
- 앱 스킴:
5. 추가 파라미터 입력 (선택사항)
커스텀 key-value 쌍을 추가로 붙일 수 있습니다. 예: ref=abc, text=yummy
⚠️ 이 값은 query string에 그대로 붙습니다. 앱에서 직접 파싱 필요
6. 소셜 미디어 미리보기 확인
우측 영역에 OG 이미지/텍스트/브랜드 로고 등이 표시됩니다. 해당 내용은 설정 > 딥링크 설정에서 커스터마이징한 값이 자동 반영됩니다.
7. 링크 생성 완료
모든 설정이 완료되면 [딥링크 생성하기] 버튼을 눌러 저장합니다. 이후 딥링크 목록에서 생성된 링크 확인 및 복사/수정 가능합니다.
참고사항
- 생성된 딥링크는 앱 연동 시 자동으로 이벤트(
VIEW,CLICK,OPEN,INSTALL)로 분석됩니다. - 커스텀 파라미터는 추후 세그먼트 및 퍼널 분석에서도 사용됩니다.
- 비활성화된 링크는 열리지 않습니다.

