> ## 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.

# 자주 묻는 질문 - 새로운 트래킹 링크 생성하기

새로운 트래킹 링크를 생성할 때 자주 묻는 질문을 주제별로 정리했습니다. 트래킹 링크의 개념과 생성 방법은 [트래킹 링크 이해하기](/ko/guides/understanding-tracking-link)와 [에어브릿지에서 트래킹 링크 생성하기](/ko/guides/creating-tracking-links-on-the-dashboard)를 먼저 참고하세요.

## 트래킹 링크 이해하기

<Accordion title="Q. 봇이 발생시킨 이벤트도 트래킹 링크로 수집되나요?">
  수집하지 않습니다. 에어브릿지는 트래킹 링크로 User Agent(`browser.userAgent`)에 아래 문자열을 포함하는 이벤트는 수집하지 않습니다.

  * "Slackbot", "datagnionbot", "PhantomJS", "LinkedInBot", "Googlebot", "AdsBot", "bingbot", "YandexBot", "YandexMobileBot", "BLEXBot", "PaperLiBot", "Twitterbot", "TelegramBot"
  * "Java/": Android Device SMS 미리보기에 사용합니다.
  * "GoogleImageProxy", "WhatsApp", "Yeti/", "AhrefsBot", "AhrefsSiteAudit", "Applebot", "PetalBot", "Pinterestbot", "Semanticbot", "SemrushBot", "SiteAuditBot", "SiteScoreBot", "SurdotlyBot", "Cincraw", "PTST/"
  * "Mozilla/5.0 (X11; Ubuntu; Linux i686; rv:24.0) Gecko/20100101 Firefox/24.0": Samsung Device SMS 미리보기에 사용합니다.
  * "http<span>://</span>naver.me/scrap", "https<span>://</span>naver.me/scrap", "facebookexternalhit", "Facebot", "Ads-Naver", "Discordbot", "SkypeUriPreview", "Yahoo Link Preview", "Yahoo Ad monitoring"
</Accordion>

## 트래킹 링크 파라미터 알아보기

<AccordionGroup>
  <Accordion title="Q. 트래킹 링크를 생성할 때 각 파라미터 값으로 입력할 수 있는 글자 수에 제한이 있나요?">
    트래킹 링크의 종류에 따라 다릅니다. 연동 채널용 트래킹 링크는 파라미터별 글자 수 제한이 없습니다. 커스텀 채널용 트래킹 링크는 파라미터별 최대 128자까지 입력할 수 있습니다.
  </Accordion>

  <Accordion title="Q. 트래킹 링크를 생성할 때 캠페인 파라미터의 항목마다 입력할 수 있는 문자 제한이 있나요?">
    네, 제한이 있습니다. 영문 대소문자, 한글, 숫자, `.`, `-`, `_`만 입력할 수 있습니다.
  </Accordion>

  <Accordion title="Q. 트래킹 링크에 ad_type 파라미터가 없습니다. 터치포인트 타입이 무엇인가요?">
    일부 트래킹 링크는 ad\_type 파라미터를 가지지 않을 수 있습니다.

    ad\_type 파라미터가 존재하지 않는 트래킹 링크의 기본 설정은 `ad_type=click`입니다. 따라서 터치포인트 타입은 클릭(click)입니다.

    파라미터 종류에 대한 자세한 내용은 [트래킹 링크 파라미터 알아보기](/ko/guides/tracking-link-structure-and-parameters)를 참고하세요.
  </Accordion>

  <Accordion title="Q. 트래킹 링크 파라미터 중에 '채널'에 있는 파라미터는 무엇인가요?">
    \[트래킹 링크 생성]에서 에어브릿지와 정식 연동된 광고 채널(Integrated Channel)의 트래킹 링크를 생성하면 '하위 채널', '하하위 채널 1'과 같은 파라미터가 추가됩니다.

    이 파라미터는 채널이 제공하는 파라미터 값을 받을 수 있도록 채널과 에어브릿지가 미리 협의해 결정한 파라미터입니다. 이 파라미터를 다른 파라미터로 변경할 수 있지만, 에어브릿지는 해당 파라미터를 변경하지 않고 사용하는 것을 권장하고 있습니다.
  </Accordion>

  <Accordion title="Q. 짧은 형태의 트래킹 링크에 파라미터를 추가하면 원래 긴 형태의 트래킹 링크에도 파라미터가 자동 추가되나요?">
    네, 추가됩니다. 이때 짧은 형태의 트래킹 링크로 인해 원래 트래킹 링크에 자동 추가된 캠페인 파라미터의 값은 리포트 조회 등 어떤 곳에서도 사용되지 않습니다.

    * 숏 링크: https<span>://</span>abr.ge/ouocog
    * 롱 링크: https<span>://</span>abr.ge/@your\_app/channel?ad\_creative=Jeans\_Clothes\&ad\_group=2030\_female\&campaign=Summer\_Sales\&og\_tag\_id=103833519

    숏 링크에 캠페인 파라미터 `campaign`과 자체 파라미터 `added_params`를 추가하면 롱 링크에도 동일하게 추가됩니다. 이때 추가된 `campaign=Spring_Sales`는 어떤 곳에서도 사용되지 않고, 원래 값인 `Summer_Sales`가 계속 사용됩니다.
  </Accordion>
</AccordionGroup>

## 에어브릿지에서 트래킹 링크 생성하기

<AccordionGroup>
  <Accordion title="Q. 에어브릿지를 사용하지 않으면 사용하고 있는 트래킹 링크는 어떻게 되나요?">
    에어브릿지 사용 계약이 종료되면 기존에 생성한 트래킹 링크를 사용할 수 없습니다.
  </Accordion>

  <Accordion title="Q. 에어브릿지 대시보드에서 트래킹 링크의 리다이렉트 경로로 최종 목적지가 일부 활성화되지 않습니다.">
    새로운 에어브릿지 앱을 생성할 때 선택한 앱 모드가 트래킹 링크에 설정할 수 있는 리다이렉트 경로를 결정합니다. 아래 표를 참고해 앱 모드별로 설정 가능한 경로를 확인하세요.

    **성과 측정 모드** (출시했거나 출시 예정인 앱)

    | 구분      | 앱 마켓                              | 앱(딥링크)            | 웹사이트        |
    | ------- | --------------------------------- | ----------------- | ----------- |
    | 출시 앱    | 등록한 서비스 환경의 앱마켓 페이지 + 모든 환경 웹 URL | 딥링크 정보 입력 후 설정 가능 | 모든 환경 설정 가능 |
    | 출시 예정 앱 | 모든 환경 웹 URL                       | 딥링크 정보 입력 후 설정 가능 | 모든 환경 설정 가능 |

    딥링크 설정은 [딥링크와 에어브릿지 매크로 활용하기](/ko/guides/retargeting-with-deep-links)를 참고하세요.

    **개발 모드** (테스트·스테이징 등 성과를 측정하지 않는 앱)

    | 구분    | 앱 마켓        | 앱(딥링크)                         | 웹사이트        |
    | ----- | ----------- | ------------------------------ | ----------- |
    | 개발용 앱 | 모든 환경 웹 URL | 딥링크 정보 입력 후 설정 가능 (폴백은 웹 URL만) | 모든 환경 설정 가능 |
  </Accordion>

  <Accordion title="Q. 트래킹 링크에 사용한 적 있는 숏 링크 ID를 재사용할 수 있나요?">
    네, 가능합니다. 다만 숏 링크 ID는 트래킹 링크의 리다이렉션, 데이터 수집 등 설정을 반영하므로 리포트에서 숏 링크 ID를 그룹바이로 조회하면 동일 ID의 데이터가 재사용 이전과 이후로 분리되어 나타날 수 있습니다. 기존에 해당 숏 링크 ID를 사용했던 트래킹 링크도 새 설정에 따라 작동합니다.
  </Accordion>

  <Accordion title="Q. 유저가 리다이렉션된 웹 URL에 트래킹 링크 생성 시 입력하지 않은 UTM 파라미터가 있습니다. 왜 그런가요?">
    \[최종 목적지]로 입력한 웹 URL에 UTM 파라미터를 입력하지 않으면, 에어브릿지가 유저를 리다이렉션할 때 UTM 파라미터를 자동 추가합니다. 운영체제·데스크톱의 웹 URL, 딥링킹되지 않은 유저를 보내는 폴백 경로의 웹 URL이 이에 해당합니다. 직접 UTM 파라미터를 입력했다면 입력된 파라미터만 남고 다른 파라미터는 추가되지 않습니다.
  </Accordion>
</AccordionGroup>

## 제너레이터 템플릿에서 트래킹 링크 대량 생성하기

<AccordionGroup>
  <Accordion title="Q. 네이버 검색 광고 트래킹 링크로 수집한 데이터가 액츄얼스 리포트 등에서 정상적으로 표기되지 않습니다.">
    제너레이터 템플릿 세부 속성([제너레이터 템플릿 세부 속성](/ko/guides/creating-bulk-tracking-links#제너레이터-템플릿-세부-속성))에 한글을 입력했는지 확인하세요. 네이버 검색 광고와 에어브릿지의 한글 인코딩 방식이 달라 한글이 정상적으로 표시되지 않을 수 있습니다. ENCODEURL 함수로 한글 단어를 변환하거나, 제너레이터의 복사 버튼으로 생성된 트래킹 링크를 복사해 해결할 수 있습니다. 자세한 사항은 [네이버 검색 광고 고객센터](https://saedu.naver.com/help/faq/ncc/view.naver?faqSeq=113)를 참고하세요.
  </Accordion>

  <Accordion title="Q. [Generate Tracking Links]를 클릭했는데 오류가 발생합니다.">
    \[Required info]에 App name과 Tracking Link API Token을 올바르게 입력하지 않으면 오류 메시지가 나옵니다. 입력한 2개 값이 에어브릿지 대시보드 \[설정]>\[토큰 관리]의 앱 이름·트래킹 링크 API 토큰 값과 일치하는지 확인하세요.
  </Accordion>

  <Accordion title="Q. 커스텀 채널용 템플릿에서 숏 링크가 생성되지 않습니다.">
    커스텀 채널용 템플릿의 Channel에 입력한 채널 이름을 확인하세요. 숏 링크 생성은 커스텀 채널에만 지원됩니다. 따라서 \[연동]>\[광고 채널 연동]에서 연동할 수 있는 채널을 Channel에 입력하면 숏 링크가 생성되지 않습니다.
  </Accordion>

  <Accordion title="Q. 트래킹 링크 생성에 사용하지 않는 세부 속성 열을 삭제하고 싶습니다.">
    트래킹 링크 제너레이터 템플릿의 특정 열을 삭제하면 트래킹 링크를 정상적으로 생성할 수 없습니다. 사용하지 않는 열이 많다면 \[열 숨기기]로 숨김 처리하기를 권장합니다.
  </Accordion>

  <Accordion title="Q. [Change parameters]에서 파라미터 값을 추가로 변경하고 싶습니다.">
    \[Change parameters]의 회색 셀에는 값을 입력할 수 없습니다. 새 파라미터 값을 입력하려면 먼저 \[트래킹 링크 생성]에서 기존 트래킹 링크를 삭제한 뒤, 새 값이 포함된 트래킹 링크를 다시 생성하세요. 그러면 \[Change parameters]에 자동 반영됩니다.
  </Accordion>
</AccordionGroup>

## 트래킹 링크 관리하기

<AccordionGroup>
  <Accordion title="Q. [트래킹 링크 관리]에서 생성된 트래킹 링크를 삭제할 수 있나요?">
    네, 삭제할 수 있습니다. 하지만 \[트래킹 링크 관리]에서 삭제한 트래킹 링크는 계속 정상 작동하며, \[트래킹 링크 관리] 목록에서만 삭제됩니다.
  </Accordion>

  <Accordion title="Q. 생성된 모든 트래킹 링크를 한 번에 삭제할 수 있나요?">
    네, 개발 모드일 때 앱 오너 권한을 가진 사용자가 삭제할 수 있습니다. \[설정]>\[에어브릿지 앱 설정] 하단의 '모든 트래킹 링크 삭제'를 클릭하면 앱에서 생성된 모든 트래킹 링크가 영구 삭제됩니다. 삭제 후에는 복구할 수 없으니 유의하세요.
  </Accordion>

  <Accordion title="Q. 트래킹 링크 경로를 수정해도 이전 경로로 이동됩니다.">
    기존 경로 정보가 에어브릿지에 캐시되어 있어 수정된 정보가 반영되기까지 최대 10분 정도 소요될 수 있습니다. 약 10분 후에 다시 확인하세요.
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/creating-tracking-links-faq" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/creating-tracking-links-faq" />