셀프 딥링킹 구현하기
시작하기
디파이너리가 제공하는 트래킹링크를 사용하지 않고 직접 딥링킹 앱 오픈 및 마켓 랜딩을 처리하기 위해 필요한 사항을 안내합니다.
디파이너리가 담당했던 역할을 직접 구현해야 하기 때문에 반드시 아래 내용이 구현되어야 합니다.
트래킹 링크 생성
셀프 딥링크 트래킹을 하기 위해서는 일반적인 상황과 다른 세팅으로 트래킹 링크를 생성해야 합니다.
링크 포맷 설정
링크의 포맷을 Download 로 설정합니다.
랜딩 URL 설정
디파이너리 대신에 딥링킹을 처리할 페이지의 URL을 입력합니다.
딥링킹 페이지 수정
디파이너리 어트리뷰션은 클릭 시에 발급되는 abx_tid 라는 토큰을 기반으로 동작합니다.
마켓을 통한 앱 설치 후 오픈이나 딥링킹 오픈 시에 abx_tid 를 SDK가 확인할 수 있어야 합니다.
다음의 내용을 참고하여 마켓 랜딩이나 딥링킹 앱 오픈 시에 abx_tid 값을 전달하도록 딥링킹을 처리하는 페이지를 수정합니다.
abx_tid 얻어내기
디파이너리 트래킹 링크 클릭 시에 생성되는 abx_tid 는 랜딩URL 주소에 뒤에 붙여져 전달됩니다.
<!-- 랜딩URL : https://my.webpage.com/landing_url.html --> https://my.webpage.com/landing_url.html?abx_tid=1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
랜딩되는 페이지의 주소에서 다음과 같은 스크립트를 이용하여 abx_tid를 조회하여 얻어낼 수 있습니다.
var getAbxTidParameter = function getAbxTidParameter() {
var landingPageUrl = window.location.search.substring(1),
referrerDatas = landingPageUrl.split('&'),
referrerParamName,
i;
for (i = 0; i < referrerDatas.length; i++) {
referrerParamName = referrerDatas[i].split('=');
if (referrerParamName[0] === "abx_tid") {
return referrerParamName[1] === undefined ? true : 'abx_tid%3D' + referrerParamName[1];
}
}
};
var abx_tid = getAbxTidParameter();
abx_tid 전달하기
랜딩 URL 주소에서 얻어낸 abx_tid 값을 마켓 랜딩 URL이나 딥링킹 URL에 추가하여 랜딩되도록 처리해야 합니다.
마켓 랜딩의 경우에는 기존 마켓 주소에 &referrer=abx_tid 와 같이 추가하면 됩니다.
<!-- 마켓URL : market://details?id=com.my.package_name --> market://details?id=com.my.package_name&referrer=abx_tid%3D1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
딥링킹 앱 오픈의 경우에는 기존 딥링킹 URL에 abx_tid를 추가하면 됩니다.
<!-- 딥링킹URL : scheme://host?myparam=data --> scheme://host?myparam=data&abx_tid=1538974042740%3Abcc6b475-98bc-4f41-991c-33f1790ac8db
디퍼드 딥링크 구현
셀프 딥링크 연동된 상태에서 디퍼드 딥링크를 구현할 수 있습니다. 이때 전달되는 디퍼드 딥링크 값은 사용자가 트랙킹 링크 생성시 설정한 딥링크 처리 페이지 주소입니다. 그러므로 앱에서도 디퍼드 딥링크 리스너를 통해 전달되는 딥링크 처리 페이지 주소를 통해 앱의 특정 화면으로 이동할 수 있도록 설정되어 있어야 합니다.
앱내 디퍼드 딥링크 구현
디퍼드 딥링크 구현을 위해서는 앱 내 디퍼드 딥링크가 구현되어 있어야 합니다.
트랙킹 링크 설정
디퍼드 딥링크 사용을 위해선 트랙킹 링크 설정을 아래와 같이 변경해야 합니다.
1) 트랙킹 링크 생성 시 랜딩 포맷을 "Download + Deeplink" 로 설정합니다.
2) 딥링크 패스 방식은 "동적 패스" 로 선택합니다.
3) Ad-Touch Landing 설정은 기존과 동일하게 직접 설정으로 설정 후 딥링크를 처리할 페이지를 입력합니다.
4) 이후 딥링크 생성시 생성되는 deeplink_custom_path url 인코딩된 딥링크 처리 페이지 주소를 입력합니다.
딥링크 처리 주소 예시 : https://my.webpage.com/landing_url.html
트랙킹 링크 내 deeplink_custom_path 파라미터 에 url 인코딩 된 딥링크 처리 주소를 아래와 같이 입력합니다.
https://qoxg6rs5r02dgcl26wts1q.adtouch.adbrix.io/api/v1/click/aFT2LV9hMECmtqefExI9Mg?deeplink_custom_path=https%3A%2F%2Fmy.webpage.com%2Flanding_url.html
5) 트래킹 링크 클릭 후 앱을 설치하고 실행시 디퍼드 딥링크 리스너로 딥링크 처리 주소가 전달되는지 확인합니다.
디퍼드 딥링크 리스너를 통해 전달되는 값 : https://my.webpage.com/landing_url.html
연동 지원 문의
셀프 딥링크 및 디퍼드 딥링크 연동 관련 추가 문의사항 및 연동 지원이 필요하신 경우 아래 메일로 문의 주시면 적극 지원해드리도록 하겠습니다.
support-tracker@adbrixsupport.zendesk.com