트래킹 링크는 유저가 광고와 어떻게 상호 작용하는지 기록합니다. 유저의 활동은 클릭 또는 조회수 형태로 보고됩니다. 유저가 어트리뷰션 링크를 클릭하면 앱을 다운로드하도록 리디렉션됩니다. 그리고 해당 클릭은 앱스플라이어 서버로 알림을 전송합니다. 이 가이드에는 앱스플라이어 트래킹 링크에 대해 알아야 할 모든 정보가 포함되어 있습니다.
앱스플라이어 트래킹 링크의 구조
필수 트래킹 링크 파라미터
파라미터 | 설명 |
app.appsflyer.com | 앱스플라이어의 엔드포인트입니다. |
app_id | 앱스플라이어의 고유 식별자입니다. 형식은 일반적으로 애플 앱 스토어 또는 구글 플레이 ID를 따릅니다. |
media_source | 파트너(즉, 앱스플라이어)에 대한 몰로코의 고유 식별자입니다. |
앱스플라이어 트래킹 링크는 다음과 같은 속성으로 구성됩니다. 앱스플라이어 트래킹 링크에 다음 정보가 모두 포함되어 있는지 확인하세요.
앱스플라이어 파라미터 | 몰로코 매크로 값 | 속성 | 매크로 설명 | 참고 |
clickid | {{mtid}} | CT,VT | MTID. 몰로코는 이것으로 어트리뷰션을 추적합니다. | |
pid | moloco_int | CT,VT |
하드코딩된 값은 moloco_int입니다.
|
|
c | {{campaign.title}} | CT,VT |
몰로코 애즈의 캠페인 이름입니다.
|
|
af_c_id | {{campaign.id}} | CT,VT |
몰로코 애즈의 영숫자 형식 캠페인 ID입니다.
|
|
af_siteid | {{publisher.bundle}} | CT,VT |
광고가 표시되는 퍼블리셔의 스토어 ID입니다.
|
|
af_cost_currency | {{price.cost_currency}} | CT,VT | 비용 통화 | |
af_cost_value | {{price.cost_amount}} | CT,VT | 비용 금액 | |
af_cost_model | {{price.cost_type}} | CT,VT | 비용 유형 | |
af_ad_type | {{creative.type}} | CT,VT |
소재 파일명
|
|
af_ad_id | {{creative.cr_id}} | CT,VT |
몰로코 애즈의 소재 ID입니다.
|
|
af_ad | {{creative.title}} | CT,VT | 소재 제목 | |
af_adset | {{adgroup.title}} | CT,VT | 광고그룹 이름 | |
af_adset_id | {{adgroup.id}} | CT,VT | ||
advertising_id | {{device.gaid}} for Android and {{device.idfa}} for iOS | CT,VT | ADID(안드로이드) 또는 IDFA (iOS) | |
af_click_lookback | 7d | CT | 하드코딩된 값 | |
af_viewthrough_lookback | 1d | VT | 하드코딩된 값 | |
&af_sub1 | {{skan.version}} | CT,VT | SKAdNetwork(SKAN) 버전 | iOS만 해당 |
&af_lang | {{device.language}} | CT,VT | 기기 언어 | S2S |
&af_ua | {{device.user_agent}} | CT,VT | 유저-에이전트 | S2S |
&af_channel | {{request.exchange}} | CT,VT | 애드 익스체인지 이름 |
[안드로이드] 클릭-쓰루 트래킹 링크 샘플
https://app.appsflyer.com/com.appsflyer.adNetworkTest
?c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_click_lookback=7d
&clickid={{mtid}}
&advertising_id={{device.gaid}}
&af_c_id={{campaign.id}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[안드로이드] 뷰-쓰루 트래킹 링크 샘플
https://impression.appsflyer.com/com.appsflyer.adNetworkTest
?c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_viewthrough_lookback=1d
&clickid={{mtid}}
&advertising_id={{device.gaid}}
&af_c_id={{campaign.id}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[iOS] 클릭-쓰루 트래킹 링크 샘플
https://app.appsflyer.com/id554782625
?c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.type}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_click_lookback=7d
&clickid={{mtid}}
&idfa={{device.idfa}}
&af_c_id={{campaign.id}}
&af_sub1={{skan.version}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
[iOS] 뷰-쓰루 트래킹 링크 샘플
https://impression.appsflyer.com/id554782625
?c={{campaign.title}}
&af_siteid={{publisher.bundle}}
&af_ad_type={{creative.title}}
&af_cost_currency={{price.cost_currency}}
&af_cost_value={{price.cost_amount}}
&af_ad_id={{creative.cr_id}}
&af_cost_model={{price.cost_type}}
&af_ad={{creative.title}}
&pid=moloco_int
&af_viewthrough_lookback=1d
&clickid={{mtid}}
&idfa={{device.idfa}}
&af_c_id={{campaign.id}}
&af_sub1={{skan.version}}
&af_lang={{device.language}}
&af_ua={{device.user_agent}}
&af_channel={{request.exchange}}
일반 트래킹 링크
이 섹션에서는 몰로코가 일반 트래킹 링크의 유효성을 검사하는 방법을 설명합니다. 일반적인 트래킹 링크 관련 오류를 해결하는 방법을 알아보려면 문제 해결 가이드를 참조하세요.
Host
몰로코 애즈는 노출(조회수) 및 클릭과 같은 트래킹 링크 유형에 대한 호스트 값의 유효성을 검사합니다. 트래킹 링크에 다음 호스트 값이 포함되지 않거나 트래킹 링크의 호스트 값이 다음 값과 다른 경우 오류 메시지가 표시됩니다.
노출 | 클릭 |
https://impression.appsflyer.com/ | https://app.appsflyer.com/ |
경로
몰로코 애즈는 OS 호환성에 대하여 경로 값의 유효성을 검사합니다. 다음 중 하나의 경우에 해당하면 오류 메시지가 표시됩니다.
1) 앱에 선택된 OS가 트래킹 링크의 OS와 다른 경우
2) 경로 값이 다음 표와 같이 앱스플라이어의 경로 형식과 다른 경우 경로 값은 해당 앱 마켓 스토어의 패키지 이름과 동일해야 합니다.
OS 유형 | 경로 값 형식 | 예시 |
안드로이드 | 마침표로 구분된 영숫자 | https://impression.appsflyer.com/moloco.cloud.portal |
iOS | 다음 값으로 시작하는 숫자: id
|
https://impression.appsflyer.com/id111110100 |
트래킹 링크의 경로 값인 app_id
값은 링크된 앱의 MMP 번들 ID와 같아야 합니다. 두 값의 불일치가 감지되면 오류 메시지가 표시됩니다.
필수 파라미터
다음 표는 필수 파라미터 및 값 쌍에 대한 사양을 보여줍니다. 다음 중 하나라도 누락된 경우 트래킹 링크를 생성하거나 업데이트할 수 없습니다.
파라미터 | 값 | 참고 |
&pid | moloco_int | |
&idfa | {{device.idfa}} | iOS만 해당 |
&advertising_id | {{device.gaid}} | 안드로이드만 해당 |
OneLink
이 섹션에서는 몰로코가 OneLink 트래킹 링크의 유효성을 검사하는 방법을 설명합니다. 일반적인 트래킹 링크 관련 오류를 해결하는 방법을 알아보려면 문제 해결 가이드를 참조하세요.
Host
OneLink 트래킹 링크의 URL 호스트는 onelink.me
로 끝나야 합니다.
예: httsp://qbc123.onelink.me
경로
OneLink 트래킹 링크에는 경로 값이 포함되지 않을 수 있습니다. 경로 값이 포함된 경우 문자, 숫자, 밑줄로 구성되어야 합니다.
필수 파라미터
다음 표는 필수 파라미터 및 값 쌍에 대한 사양을 보여줍니다. 다음 중 하나라도 누락된 경우 트래킹 링크를 생성하거나 업데이트할 수 없습니다.
파라미터 | 값 | 참고 |
&pid | moloco_int | |
&idfa | {{device.idfa}} | iOS만 해당 |
&advertising_id | {{device.gaid}} | 안드로이드만 해당 |