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