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

# 딥링크 UTM 어트리뷰션

딥링크 UTM 어트리뷰션은 딥링크에 추가된 `utm_source` 파라미터의 값을 기여 채널 후보에 포함하는 기능입니다. 에어브릿지 트래킹 링크를 거치지 않고 앱에 바로 전달된 딥링크로 발생한 전환은 다른 터치포인트가 없으면 미기여(Unattributed)로 집계되지만, 딥링크 UTM 어트리뷰션을 활성화하면 `utm_source` 값에 해당하는 채널에 기여될 수 있습니다.

## 사전 준비사항

딥링크 UTM 어트리뷰션을 사용하려면 아래 조건을 모두 충족해야 합니다.

* 딥링크 이벤트가 수집되도록 에어브릿지 SDK에 딥링크를 설정해야 합니다. 자세한 내용은 [안드로이드](/ko/developers/android-sdk-v4#딥링크-설정하기)와 [iOS](/ko/developers/ios-sdk-v4#딥링크-설정하기) 가이드를 참고하세요.
* SDK의 `setTrackAirbridgeDeeplinkOnlyEnabled`가 `false`여야 합니다. 자세한 내용은 [안드로이드](/ko/developers/android-sdk-v4#에어브릿지-딥링크만-추적하기)와 [iOS](/ko/developers/ios-sdk-v4#에어브릿지-딥링크만-추적하기) 가이드를 참고하세요.
* 딥링크에 `utm_source` 파라미터를 추가해야 합니다. `utm_campaign` 등 다른 UTM 파라미터는 기여 채널을 정하는 데 사용되지 않습니다. `utm_source` 값이 기여 채널 이름이 되므로 채널별로 구분되는 값을 입력하세요.

## 작동 방식

딥링크 UTM 어트리뷰션을 활성화하면 딥링크에 추가된 `utm_source` 파라미터의 값이 기여 채널 후보에 포함됩니다. [터치포인트 우선순위](/ko/guides/airbridge-attribution-model#터치포인트-우선순위)에 따라 아래 경우에는 `utm_source` 채널에 기여되지 않습니다.

* 같은 딥링크에 에어브릿지 트래킹 링크 정보가 있거나 URL 쿼리 매핑(URL Query Mapping)으로 채널이 확인되면 그 채널이 우선합니다.
* 룩백 윈도우 안에 같은 유저의 트래킹 링크 클릭이나 SAN(Self-Attributing Network) API 터치포인트가 있으면 그 터치포인트가 우선합니다.

예를 들어 에어브릿지 트래킹 링크를 거치지 않은 아래 딥링크로 유저가 앱을 실행했고, 우선하는 다른 터치포인트가 없다고 가정합니다.

* 딥링크 예시: `appscheme://path?utm_source=naver&utm_campaign=summer_sale`

딥링크 UTM 어트리뷰션을 비활성화한 상태에서는 이 딥링크 실행이 미기여로 집계됩니다. 딥링크 UTM 어트리뷰션을 활성화한 상태에서는 이 딥링크 실행이 `naver` 채널에 기여됩니다.

## UTM 파라미터 매핑

딥링크 UTM 어트리뷰션으로 기여된 성과는 아래와 같이 리포트에서 그룹바이로 나눠 조회할 수 있습니다.

| UTM 파라미터 | 리포트 그룹바이 | 설명 |
| - | - | - |
| `utm_source` | Channel | 기여 채널 이름 |
| `utm_campaign` | Campaign | 캠페인 이름 |
| `utm_content` | Content | 광고 콘텐츠 |
| `utm_term` | Term | 검색 광고 키워드 |
| `utm_medium` | Sub Publisher | 채널에 속한 하위 네트워크나 제휴 채널을 구분하는 ID |

<Info>
  **알립니다**

  딥링크 UTM 어트리뷰션은 앱 딥링크에만 적용되며 웹 이벤트에는 적용되지 않습니다. 웹사이트 링크의 UTM 파라미터를 트래킹 링크 파라미터로 매핑하는 [UTM 파싱(UTM Parsing)](/ko/guides/migrating-tracking-links)은 에어브릿지 웹 SDK 설정으로 작동하는 별개의 기능입니다.
</Info>

## 설정하기

<Danger>
  **주의하세요**

  딥링크 UTM 어트리뷰션 설정은 활성화하거나 비활성화한 후 수집되는 전환부터 적용됩니다. 변경 사항이 반영되기까지 최대 10분이 걸릴 수 있습니다. 기존 어트리뷰션 결과에는 영향을 주지 않습니다. 변경 전후의 채널 성과를 비교할 때 유의하세요.
</Danger>

앱 역할이 오너 또는 사내 마케터인 사용자와 수정 권한이 있는 대행사만 딥링크 UTM 어트리뷰션을 설정할 수 있습니다. 다른 앱 역할의 사용자는 설정 상태를 확인만 할 수 있습니다.

에어브릿지 대시보드 \[규칙 관리]>\[기여 규칙]의 \[설치] 탭에서 딥링크 UTM 어트리뷰션을 설정하세요.

1. \[딥링크 UTM 어트리뷰션] 토글을 활성화하세요.
2. 확인 문구로 '활성화하겠습니다'를 입력하고 '활성화'를 선택하세요.

딥링크 UTM 어트리뷰션이 활성화됐다는 메시지가 표시되면 설정이 완료됩니다.

딥링크 UTM 어트리뷰션을 비활성화하려면 \[딥링크 UTM 어트리뷰션] 토글을 비활성화하고 확인 문구로 '비활성화하겠습니다'를 입력한 후 '비활성화'를 선택하세요.

## 주의사항

딥링크 UTM 어트리뷰션을 사용할 때 아래 사항을 주의해 주세요.

* 딥링크의 다른 URL 파라미터 값 안에 포함된 UTM 파라미터는 인식되지 않습니다. 예를 들어 `appscheme://path?url=https://example.com?utm_source=naver`의 `utm_source`는 `url` 파라미터에 포함돼 있으므로 기여 채널 후보에 포함되지 않습니다.
* 에어브릿지는 `utm_source` 값이 실제 광고 채널에서 전달된 값인지 검증하지 않습니다. 딥링크를 만드는 누구나 `utm_source` 값을 임의로 넣을 수 있으므로 채널 이름이 의도한 값인지 확인하세요.


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