셀프 딥링킹 가이드

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

셀프 딥링킹 구현 순서

---

1. 트래킹 링크 생성

2. 딥링킹 페이지 수정

3. 지연된 딥링크 구현

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

① 트래킹 링크 생성

---

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

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