트래킹 링크 구조

트래킹 링크는 광고를 보거나 클릭한 유저의 활동 정보를 에어브릿지에 전달하는 기능을 가진 링크입니다. 트래킹 링크의 기본적인 구조는 광고 매체에 따라 다를 수 있지만, 일반적으로 트래킹 링크는 앱 이름과 광고 매체 이름을 파라미터로 가지고 있습니다.

  • 트래킹 링크 기본 구조 예시: https://abr.ge/@APP_NAME/MEDIA_NAME
  • 앱 이름 파라미터: @APP_NAME
  • 광고 매체 이름 파라미터: @MEDIA_NAME

트래킹 링크 기본 구조 뒤에 붙은 파라미터는 유저의 활동과 관련된 추가적인 정보를 저장합니다. 이 파라미터는 ?부호를 트래킹 링크 기본 구조 뒤에 붙여 사용합니다. 각 파라미터는 &를 사용하여 구분합니다.

  • 파라미터를 추가한 트래킹 링크 예시: https://abr.ge/@APP_NAME/MEDIA_NAME?click_id={CLICK_ID}&sub_id={SUB_ID}&gaid_raw={GAID}&ifa_raw={IDFA}&campaign=spring_festival&ad_group=retargeting

 

 

트래킹 링크 파라미터

에어브릿지 트래킹 링크의 파라미터는 사용 목적에 따라 캠페인 파라미터, 에어브릿지 파라미터, 매체(커스텀) 파라미터로 나뉩니다.

종류 파라미터
캠페인 파라미터 campaign, campaign_id, ad_group, ad_group_id, ad_creative, ad_creative_id, content, term
에어브릿지 파라미터 ad_type, tracking_template_id, routing_short_id, og_tag_id, deeplink_url
매체(커스텀) 파라미터 sub_id, sub_id_1, sub_id_2, sub_id_3, ad_id, gaid_raw, ifa_raw, ip, user_agent, language

에어브릿지 트래킹 링크는 파라미터를 아래 표에 나온 정의에 따라 사용하고 있습니다. 이러한 정의는 파라미터를 다른 목적으로 활용하기 위해 수정할 수 있습니다.

파라미터 설명 예시
tracking_template_id 에어브릿지 트래킹 링크의 고유 ID tracking_template_id=405ba6cd149db133354fac491b342ab1
routing_short_id 리다이렉트 경로에 대한 고유 ID routing_short_id=jx4e
deeplink_url 앱을 설치한 유저를 앱 내 특정 컨텐츠(페이지)로 연결하는 URL deeplink_url=ablog%3A%2F%2Flink%3Furl%3Dhttps%253A%252F%252Fwww.airbridge.io%252Fblog-ko%252Fairbridge-branded-link
og_tag_id Og Tag(미리보기)의 고유 ID가 없는 경우, Web URL, Fallback URL의 정보를 나타냄 og_tag_id=68212
ad_type 터치포인트 종류에 따라 아래와 같이 나뉨.
-click
-view
-server_to_server_click		 ad_type=click
campaign 캠페인 이름 campaign=spring_festival
campaign_id 캠페인 ID(광고주/매체사 제공) campaign_id=1481
ad_group 광고 그룹 ad_group=retargeting
ad_group_id 광고 그룹 ID(광고주/매체사 제공) ad_group_id=1246
ad_creative 광고 소재 및 컨셉 ad_creative=Jean
ad_creative_id 광고 소재 및 컨셉 아이디 (광고주/매체사 제공) ad_creative_id=129840
content 광고 콘텐츠 content=buy_today
term 검색 광고 키워드 term=%EC%95%88%EA%B2%BD
click_id 터치포인트에 대한 매체사 측 고유 식별값 click_id=12345234
sub_id 하위 네트워크 혹은 제휴 매체사 등을 나타내는 아이디 sub_id=356234234
sub_id_1
sub_id_2
sub_id_3		 -하위 네트워크의 또다른 하위 네트워크 아이디(sub-sub publisher)
-하위매체 순서(계층)에 맞게 사용해야 합니다(sub_id_1 > sub_id_2 > sub_id_3)		 sub_id_1=23981024
ad_id -OS에 따른 광고 식별자(Android의 ADID 혹은 iOS의 IDFA)
-gaid_raw, ifa_raw 두개의 구별된 파라미터 대신 하나의 파라미터만으로 광고 식별자를 전달할 시 사용		 ad_id=13C424EC-C21C-4E1F-9C55-ADCD3DAC1E17
gaid_raw Android에서 사용하는 광고 식별자 (ADID) (Google 공식 문서) gaid_raw=157fdd31-da2c-50fd-a460-0b0142ea69aa
ifa_raw iOS 에서 사용하는 광고 식별자 (IDFA) (Apple 공식 문서) ifa_raw=13C424EC-C21C-4E1F-9C55-ADCD3DAC1E17
ip -트래킹 링크를 호출한 디바이스의 IP 주소
-Server to Server 클릭 호출 시		 ip=127.0.0.1
user_agent -트래킹 링크를 호출한 디바이스의 User Agent(인코딩 필요)
-Server to Server 클릭 호출 시		 user_agent=Mozilla%2F5.0%20(Macintosh%3B%20Intel%20Mac%20OS%20X%2010_15_7)%20AppleWebKit%2F537.36%20(KHTML%2C%20like%20Gecko)%20Chrome%2F88.0.4324.96%20Safari%2F537.36
language 트래킹 링크를 호출한 디바이스의 언어 language=ko

 

 

자주 묻는 질문

Q. 파라미터가 만들었던 것과 다릅니다.

트래킹 링크에 있는 일부 기호는 자동으로 다른 기호로 바뀝니다.

  • 채널명에 있는 ‘/’ 기호는 ‘_’ 기호로 치환됩니다.(예. My/Channel ▶ My_Channel)
  • 파라미터 값에 있는 ‘#’ 기호는 ‘_’ 기호로 치환됩니다.(예. ad_group=#MyGroup ▶ ad_group=_MyGroup)
  • 파라미터 값에 있는 ‘+’ 기호는 공백으로 바뀝니다. 반대로 파라미터 값에 공백이 들어가면 ‘+’ 기호로 바뀝니다. (예. my campaign=my+campaign ↔ my+campaign=my campaign)

 

Q. 파라미터에 사용할 수 있는 글자 수 제한이 있나요?

네, 있습니다. 각 파라미터는 글자를 256자만 사용할 수 있습니다.

 

Q. 캠페인 파라미터에 모든 문자를 사용할 수 있나요?

캠페인 파라미터에 사용할 수 있는 문자는 아래와 같습니다. 그 외 문자를 사용할 경우, 트래킹 링크가 정상적으로 작동하지 않을 수 있습니다.

  • 영문(대소문자)
  • 한글
  • 숫자
  • 언더바(_)
  • 대시바(-)

 

Q. ad_type 파라미터가 트래킹 링크에 없어요.

ad_type 파라미터가 없는 트래킹 링크의 기본 설정은 ad_type=click입니다.
ad_type 파라미터는 유저가 광고에 관해 어떠한 행동을 했는지 추적하는 파라미터입니다. 유저가 광고를 봤는지 확인하는 트래킹 링크는 ‘ad_type=view’를 파라미터로 가지고 있습니다. 유저가 광고를 클릭했는지 확인하는 트래킹 링크는 ‘ad_type=click’ 또는 ‘ad_type=server_to_server_click’을 가집니다.

트래킹 링크 구조와 파라미터