트래킹 링크 파라미터를 Install Referrer 로 수신하기
개요
본 가이드는 디파이너리 트래킹 링크 내 설정된 파라미터를 Google Install Referrer 를 통해 앱으로 전달하는 방법에 대한 가이드 입니다.
[[인용:위험:보통]] 본 내용은 Install Referrer 가 연동된 Android 앱이 Google Play 로 배포되었을 경우에만 지원되며, iOS 에서는 지원하지 않습니다.
[[인용:위험:보통]] Install Referrer 를 통해 받은 데이터의 수치와, 디파이너리 콘솔의 트래킹 링크 리포트 수치와 차이가 있을 수 있습니다. 이는 디파이너리의 경우 어트리뷰션 방법론에 따라 디파이너리 내부 서버에서 계산을 거처 리포트가 보여지는 만큼, Install Referrer 를 통해 클라이언트 단에서 수집한 데이터의 수치와 차이가 있을 수 있습니다.
WorkFlow
트래킹 링크의 파리미터를 받기 위해서는 아래의 작업이 선행되어야 합니다.
- 앱 내 Install Referrer 라이브러리 설치 및 Install Referrer 를 데이터를 수신 받기 위한 코드 추가.
- Install Referrer 연동이 완료된 앱을 Google Play 에 배포.
- 트래킹 링크에 Install Referrer 로 수신할 파라미터 추가 및 데이터를 받기 위한 파라미터 추가.
- 트래킹 링크를 통해 앱을 설치하고 실행.
[[인용:경고:보통]] Install Referrer 는 앱 설치 후 실행 시 한번만 전달되며 트래킹 링크를 통한 딥링크 오픈시에는 데이터를 전달하지 않습니다.
앱 설정
Install Referrer 라이브러리 설치하기
Android 프로젝트 내 App 폴더에서 build.gradle 폴더를 열고 dependencies 에 아래와 같이 Install Referrer 라이브러리를 설치합니다.
dependencies {
implementation 'com.android.installreferrer:installreferrer:1.0'
}
Google Install Referrer 데이터 받기
Google Install Referrer 로 전달된 데이터를 수신 받기 위해서 아래와 같이 Install Referrer 라이브러리를 호출하여 데이터를 받습니다.
private void GetInstallReferrerData () {
InstallReferrerClient referrerClient;
referrerClient = InstallReferrerClient.newBuilder(MainActivity.this).build();
referrerClient.startConnection(new InstallReferrerStateListener() {
@Override
public void onInstallReferrerSetupFinished(int responseCode) {
switch (responseCode){
case InstallReferrerClient.InstallReferrerResponse.OK:
try {
// Google Install Referrer data from here
ReferrerDetails response = referrerClient.getInstallReferrer();
String referrerUrl = response.getInstallReferrer();
long referrerClickTime = response.getReferrerClickTimestampSeconds();
long appInstallTime = response.getInstallBeginTimestampSeconds();
Log.d("dfnlog", "Referrer_Data : " + referrerUrl);
Log.d("dfnlog", "Referrer Click Time : " + referrerClickTime);
Log.d("dfnlog", "Referrer App Install Time : " + appInstallTime);
} catch (RemoteException e) {
e.printStackTrace();
}
}
}
@Override
public void onInstallReferrerServiceDisconnected() {
Log.d("dfnlog", "Referrer state : Referrer Disconnect" );
}
});
}
트래킹 링크 설정
트래킹 링크 파라미터 추가
참고자료 : [파라미터를 이용한 광고 성과측정 세분화]
트래킹 링크 생성시 Install Referrer 로 전달받기 위한 파라미터를 추가합니다.
트래킹 링크 세팅이 완료되면 트래킹 링크 맨 뒤에 아래 스크린샷과 같이 트래킹 링크 맨 뒤에 "opt_deliver_referrer=true" 파라미터를 추가합니다.
예시 트래킹 링크
https://your_app_key.adtouch.adbrix.io/api/v1/click/tracking_id?utm_source=utm_test&utm_medium=utm_me_test &utm_campaign=utm_cam_test&opt_deliver_referrer=true
위 예시 트래킹 링크와 같이 세팅된 상태에서 트래킹 링크 클릭 후 Google Play 를 통해 앱을 설치하게 되면 트래킹 링크에 세팅된 파라미터 (utm_source=utm_test&utm_medium=utm_me_test &utm_campaign=utm_cam_test) 가 Google Install Referrer 로 전달 됩니다.