알립니다
대행사 사용자는 문서 작성 도구에서 만든 트래킹 링크로 수집한 데이터를 에어브릿지 리포트에서 조회할 수 없습니다. 데이터를 원활하게 조회하기 위해 API를 활용하는 에어브릿지 대시보드, 제너레이터 템플릿, 로 트래킹 링크를 만들어 주세요.
메모장, 구글 스프레드시트 등 문서 작성 도구에 파라미터를 추가해서 트래킹 링크를 직접 만드는 방법은 API를 활용하지 않습니다. 해당 방법으로 트래킹 링크를 만들기 위해서는 먼저 트래킹 링크의 기본적인 구조를 만들어야 합니다. 그리고 원하는 파라미터를 추가합니다.
파라미터를 추가해서 트래킹 링크를 문서 작성 도구에서 직접 생성하는 방법을 활용할 수 있는 주요 상황은 아래와 같습니다. 현재 상황을 파악하고 필요한 파라미터를 추가해서 원하는 트래킹 링크를 직접 생성해 보세요.
딥링크 URL 등 리다이렉트 경로의 파라미터 값을 수시로 교체하고 있습니다.
구글 스프레드시트 등으로 직접 만든 템플릿을 활용해서 트래킹 링크를 생성하고 싶습니다.
내부 보안 정책으로 에어브릿지가 제공하는 트래킹 링크 제너레이터 템플릿을 사용할 수 없습니다.
주의하세요
문서 작성 도구에서 파라미터를 추가해서 생성한 트래킹 링크는 트래킹 링크 리스트에서 확인할 수 없습니다. 에어브릿지 대시보드 또는 트래킹 링크 제너레이터 템플릿에서 생성한 트래킹 링크 등은 트래킹 링크 리스트에서 확인할 수 있습니다.
파라미터를 추가하기 전에 트래킹 링크의 기본적인 구조를 문서 작성 도구에서 만들어야 합니다. 기본적인 구조에 필요한 정보는 도메인, 앱 이름, 채널입니다.
1. 메모장 등 자주 사용하는 문서 작성 도구에 https://
와 함께 트래킹 링크의 도메인인 abr.ge/
를 입력합니다.
2. @
와 함께 에어브릿지에 등록한 서비스의 앱 이름을 도메인 다음에 입력합니다. 앱 이름은 에어브릿지 대시보드 [Settings]>[App Settings]의 ‘앱 이름’에서 확인할 수 있습니다.
3. /
와 함께 광고 성과를 측정할 채널 이름을 앱 이름 다음에 입력합니다. 입력하는 채널 이름은 아래 채널 종류에 따른 내용을 참고해 주세요.
에어브릿지 대시보드 [Integrations]>[Ad Channel Integration]에서 채널 이름을 확인할 수 있습니다.
연동 채널에 관한 자세한 내용은 에어브릿지와 마케팅 채널을 참고해 주세요.
주의하세요
연동 채널에 사용하는 트래킹 링크는 가급적 에어브릿지 대시보드에서 만들기를 권장합니다.
파라미터를 추가해서 연동 채널에 사용하는 트래킹 링크를 직접 만들면 에어브릿지 대시보드에서 트래킹 링크를 만들 때 포함되는 몇몇 채널 파라미터에 관한 정보가 누락됩니다. 지정된 캠페인, 채널 파라미터 외에 다른 파라미터를 트래킹 링크에 직접 추가할 수 없기 때문입니다.
지정된 캠페인, 채널 파라미터 목록은 캠페인, 채널 파라미터 추가하기에서 확인할 수 있습니다.
내부 구성원이 알아볼 수 있는 채널 이름을 자유롭게 입력합니다. 커스텀 채널에 관한 자세한 내용은 에어브릿지와 마케팅 채널을 참고해 주세요.
CTA(Call to Action) 요소에 삽입할 트래킹 링크를 생성하고 있다면 UTM 파라미터 또는 airbridge.websdk를 채널 이름으로 입력합니다. 자세한 사항은 CTA 요소에 활용하기를 참고해 주세요.
트래킹 링크의 기본적인 구조를 만들면 아래와 같은 URL을 확인할 수 있습니다.
https://abr.ge/@your_app_name/example_channel
your_app_name은 에어브릿지에 등록한 서비스의 앱 이름, example_channel은 트래킹 링크가 활용되는 채널 이름을 의미합니다.
광고 캠페인 목적을 고려해서 추가하고 싶은 파라미터를 도메인, 앱 이름, 채널 다음에 입력합니다. 딥링크 URL과 폴백 URL을 추가하면 유저를 보낼 리다이렉트 경로를 지정할 수 있습니다. 캠페인, 채널 파라미터를 추가하면 다양한 캠페인, 채널 정보를 트래킹할 수 있습니다.
파라미터를 원하는 순서대로 추가하거나 추가하지 않아도 트래킹 링크는 정상적으로 작동합니다. 예를 들어 캠페인, 채널 파라미터를 먼저 추가하고 나서 리다이렉트 경로에 관한 파라미터를 추가할 수 있습니다.
?
또는 &
와 함께 딥링크 URL 파라미터인 deeplink_url을 입력합니다. =
와 함께 파라미터 값에 앱을 설치한 유저를 보낼 딥링크 URL을 입력합니다.
[Tracking Link]>[Deep Link]에서 설정한 URI 스킴(URL Scheme)으로 시작하는 스킴 딥링크만 딥링크 URL로 입력할 수 있습니다. 딥링크 URL이 아직 없다면 에어브릿지에서 딥링크를 설정하고 나서 내부 개발자에게 요청해 주세요.
딥링크 URL을 입력하기 전에 반드시 별도로 인코딩해 주세요. 인코딩하지 않으면 트래킹 링크가 정상적으로 작동하지 않습니다.
하나의 딥링크 URL로 유저를 서로 다른 경로로 보내고 싶다면 다이나믹 파라미터 활용하기를 참고해 주세요.
http://abr.ge/@your_app_name/example_channel?deeplink_url={your_deeplink_url}
{your_deeplink_url}은 앱을 설치한 유저를 보낼 딥링크 URL 파라미터 값을 의미합니다.
?
또는 &
와 함께 폴백(Fallback) 경로 파라미터를 추가합니다. =
와 함께 파라미터 값에 앱을 설치하지 않은 유저를 보낼 폴백 경로를 입력합니다. 폴백 경로 파라미터 값을 입력하는 방법은 플랫폼별로 다릅니다.
아래 내용을 참고해 주세요.
?
또는 &
와 함께 안드로이드 폴백 경로 파라미터인 fallback_android를 입력합니다. =
와 함께 파라미터 값에 google-play를 입력하면 유저를 에어브릿지 대시보드 [설정]>[앱 설정]>[앱 정보]의 ‘앱 & 웹’에 설정한 안드로이드 앱의 앱마켓 페이지로 보냅니다.
파라미터 값에 해당 안드로이드 앱의 앱마켓 URL을 입력하면 앱마켓 페이지가 웹 환경에서 열립니다.
?
또는 &
와 함께 iOS 폴백 경로 파라미터인 fallback_ios를 입력합니다. =
와 함께 파라미터 값에 itunes-appstore를 입력하면 유저를 에어브릿지 대시보드 [설정]>[앱 설정]>[앱 정보]의 ‘앱 & 웹’에 설정한 iOS 앱의 앱마켓 페이지로 보냅니다.
파라미터 값에 해당 iOS 앱의 앱마켓 URL을 입력하면 앱마켓 페이지가 웹 환경에서 열립니다.
?
또는 &
와 함께 데스크톱 폴백 경로 파라미터인 fallback_desktop을 입력합니다. =
와 함께 파라미터 값에 앱을 설치하지 않은 데스크톱(PC) 유저를 보낼 URL을 입력합니다.
URL을 입력하기 전에 반드시 별도로 인코딩해 주세요. 인코딩하지 않으면 트래킹 링크가 정상적으로 작동하지 않습니다.
모든 폴백 경로 파라미터를 추가하면 아래와 같은 트래킹 링크를 생성할 수 있습니다.
https://abr.ge/@your_app_name/example_channel?fallback_android=google-play&fallback_ios=itunes-appstore&fallback_desktop={your_desktop_fallback_url}
{your_desktop_fallback_url}은 앱을 설치하지 않은 데스크톱(PC) 유저를 보낼 폴백 경로 파라미터 값을 의미합니다.
폴백 경로를 추가하지 않으면 유저는 입력한 채널 종류에 따라 아래와 같은 경로로 이동합니다. 유저 경험을 향상시키기 위해 가급적 폴백 경로를 트래킹 링크에 추가해 주세요.
연동 채널: [Settings]>[App Settings]>[앱 정보]의 ‘앱 & 웹’에 설정한 웹사이트로 이동합니다.
커스텀 채널: 앱을 설치할 수 있는 QR코드가 포함된 에어페이지로 이동합니다.
?
또는 &
와 함께 캠페인, 채널 파라미터를 추가합니다. =
와 함께 파라미터 값에 각 파라미터의 속성에 알맞은 캠페인, 채널 정보를 입력합니다.
아래는 문서 작성 도구에서 트래킹 링크를 직접 생성할 때 추가할 수 있는 캠페인, 채널 파라미터입니다. 목록에 없는 다른 파라미터를 추가하는 것은 권장하지 않습니다.
파라미터 이름 | 정의 | 예시 |
---|---|---|
campaign | 캠페인 이름 | campaign=example_campaign |
ad_group | 광고 그룹 이름 | ad_group=example_ad_group |
ad_creative | 광고 소재 이름 | ad_creative=example_ad_creative |
campaign_id | 캠페인 ID | campaign_id=example_campaign_id |
ad_group_id | 광고 그룹 ID | ad_group_id=example_ad_group_id |
ad_creative_id | 광고 소재 ID | ad_creative_id=example_ad_creative_id |
content | 광고 종류 | content=example_content |
term | 광고 키워드 | term=example_term |
파라미터 이름 | 정의 | 예시 |
---|---|---|
click_id | 채널의 고유 ID | click_id=example_click_id |
sub_id | 채널 아래 단계 있는 퍼블리셔의 고유 ID | sub_id=example_sub_id |
sub_id_1 sub_id_2 sub_id_3 | 퍼블리셔 간 위계에서 퍼블리셔 아래 단계에 있는 퍼블리셔 1,2,3의 고유 ID | sub_id_1=example_sub_id_1 sub_id_2=example_sub_id_2 sub_id_3=example_sub_id_3 |
광고 키워드 파라미터를 추가하면 아래와 같은 트래킹 링크를 생성할 수 있습니다.
https://abr.ge/@your_app_name/example_channel?term={your_term}
{your_term}은 트래킹 링크로 트래킹하고 싶은 광고 키워드 파라미터 값을 의미합니다.
트래킹 링크를 생성하는 목적에 따라 파라미터를 다양하게 활용할 수 있습니다. 아래 2가지 방법을 참고해 주세요.
트래킹 링크를 웹 페이지 속 배너, 버튼 같은 CTA(Call to Action) 요소에 활용할 수 있습니다.
CTA 요소가 삽입된 웹 페이지 URL에 UTM 파라미터가 있다면 각 UTM 파라미터 값을 트래킹 링크의 정해진 위치에 입력합니다. 또는 내부 개발자에게 요청해서 UTM 파라미터 값을 파싱해서 입력해 주세요.
예를 들어 utm_campaign 값이 your_campaign이면 ?
또는 &
와 함께 캠페인 파라미터인 campaign을 먼저 추가합니다. 그리고 =
와 함께 your_campaign을 campaign의 파라미터 값으로 입력합니다.
UTM 파라미터별로 입력해야 하는 자세한 위치는 아래 테이블을 참고해 주세요.
UTM 파라미터 이름 | 위치 이름 |
---|---|
utm_source | |
utm_campaign | campaign |
utm_medium | sub_id |
utm_term | term |
utm_content | content |
CTA 요소가 삽입된 웹 페이지 URL에 UTM 파라미터가 없다면 채널 이름을 /
와 함께 airbridge.websdk로 입력해 주세요. CTA 요소가 삽입된 웹 페이지가 연동 채널에 집행한 광고로 열렸다면 에어브릿지 어트리뷰션 모델의 기여 우선순위에 따라 해당 채널이 기여를 가져갑니다. 기여된 채널이 없다면 채널 정보가 airbridge.websdk로 기록됩니다.
하나의 트래킹 링크로 여러 유저를 서로 다른 경로로 보내고 싶다면 딥링크 URL 파라미터와 데스크톱 폴백 URL 파라미터에 다이나믹 파라미터 값을 입력합니다.
다이나믹 파라미터 값은 내부 개발자에게 URL별로 요청해 주세요. 채널, 캠페인 파라미터, 채널 파라미터 또한 내부 개발자에게 요청해서 다이나믹 파라미터 값으로 입력할 수 있습니다.
딥링크 URL에 다이나믹 파라미터 값을 입력하면 아래와 같은 트래킹 링크를 생성할 수 있습니다.
https://abr.ge/@your_app_name/example_channel?deeplink_url={your_dynamic_deeplink_url}
{your_dynamic_deeplink_url}은 앱을 설치한 유저를 서로 다른 경로로 보낼 딥링크 URL의 다이나믹 파라미터 값을 의미합니다.
아래 사항을 주의해 주세요.
문서 작성 도구에서 커스텀 채널용 트래킹 링크를 생성하면 소셜 미디어에 공유하는 과정에서 의도하지 않은 썸네일, 제목, 설명이 노출될 수 있습니다. 소셜 미디어에 트래킹 링크를 공유하기 전에 썸네일, 제목, 설명이 어떻게 보이는지 미리 확인하는 것을 권장합니다.
의도하지 않은 썸네일, 제목, 설명이 나온다면 아래를 시도해 보세요.
폴백 경로를 추가해 주세요. 또는 에어브릿지의 [Tracking Link]>[Social Share Preview]에서 기본 설정을 확인해 주세요.
올바른 폴백 경로를 입력했는지 확인해 주세요.
폴백 경로로 설정한 폴백 URL에 OG 태그 정보가 알맞는지 확인해 주세요.
도움이 되었나요?