셀프 딥링킹 가이드

애드브릭스가 제공하는 트래킹 링크를 사용하지 않고, 직접 딥링킹 앱 오픈 및 마켓 랜딩을 처리하기 위해 필요한 사항을 안내합니다.

셀프 딥링킹 구현 순서

트래킹 링크 생성
딥링킹 페이지 수정
지연된 딥링크 구현

애드브릭스가 담당했던 역할을 직접 구현해야 하기 때문에 반드시 가이드에 맞춰 진행해주시길 바랍니다.

① 트래킹 링크 생성

셀프 딥링크를 트래킹 하기 위해선 일반적인 상황과 다른 세팅으로 트래킹 링크 생성이 필요합니다.

1. 트래킹 링크 랜딩 포맷 설정

랜딩 포맷을 'Custom Landing'으로 설정한 후 '다음' 버튼을 클릭합니다.

2. 랜딩 URL 설정

딥링킹을 처리할 페이지 URL을 입력한 후 트래킹 링크를 생성합니다.

② 딥링킹 페이지 수정

1. 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();

2. 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. 앱 내 지연된 딥링크 구현

앱에서 지연된 딥링크를 핸들링하도록 연동이 필요합니다.

각 플랫폼별 가이드를 참고하여 연동해주시길 바랍니다.

[Android 지연된 딥링크 연동 가이드] / [iOS 지연된 딥링크 연동 가이드]

2. 트래킹 링크 설정

지연된 딥링크를 사용하기 위해선 트래킹 링크 설정을 아래와 같이 변경해야 합니다.

1) 랜딩 포맷을 'Download + Deeplink'로 설정합니다.

2) 기설치자 랜딩지점(딥링크) 설정 탭에서 딥링크 패스 방식을 '동적 패스'로 선택합니다.

3) 미설치자 랜딩지점 설정 탭에선 '직접 설정'으로 변경 후 딥링크를 처리할 페이지 URL을 입력합니다.

4) 트래킹 링크 생성 시 추가된 deeplink_custom_path에 딥링크 처리 페이지 URL을 인코딩 후 입력합니다.

<!-- 랜딩URL : https://my.webpage.com/landing_url.html -->
https://ab-x.link/api/v1/click/OKmTnak6REe2AvFs4DdAtQ/dE6gSFmYJUSKuMpi1TXtdg?deeplink_custom_path=https%3A%2F%2Fmy.webpage.com%2Flanding_url.html

5) 트래킹 링크 클릭 후 앱 설치 및 실행 시, 디퍼드 딥링크 리스너로 딥링크 처리 주소가 전달되는지 확인합니다.

디퍼드 딥링크 리스너를 통해 전달되는 값 : https://my.webpage.com/landing_url.html

Previous셀프 검증 가이드 NextFAQ

Last updated 1 month ago