딥링크 설정

사용자를 앱의 특정 페이지로 이동시키기 위해 딥링크를 생성할 수 있습니다. Adjust SDK는 사용자 기기에 앱이 이미 설치되어 있는지 여부에 따라 다른 로직을 적용합니다.

다이렉트 딥링킹: 사용자 기기에 앱이 이미 설치되어 있는 경우에 사용됩니다. 사용자는 링크가 의도한 페이지로 이동됩니다.
디퍼드 딥링킹: 사용자가 아직 앱을 설치하지 않은 경우에 사용됩니다. 링크는 먼저 사용자를 앱을 설치할 수 있는 스토어 페이지로 이동시킵니다. 사용자가 앱을 설치한 이후에 링크는 의도한 페이지를 엽니다.

SDK는 사용자가 링크를 통해 앱을 실행한 이후에 딥링크 데이터를 읽을 수 있습니다.

스킴 이름 설정

사용자가 앱을 설치한 경우, 사용자가 딥링크 정보가 포함된 링크를 클릭하면 딥링크가 실행됩니다. Adjust SDK는 앱에서 사용하기 위해 딥링크 정보를 파싱할 수 있는 툴을 포함하고 있습니다. 딥링킹을 설정하려면 고유한 스킴 이름 을 선택해야 합니다.

사용자가 딥링크를 클릭할 때 특정 활동이 실행되도록 설정할 수 있습니다. 이를 위해 다음을 수행하시기 바랍니다.

스킴 이름 을 AndroidManifest.xml 파일 내 활동에 지정합니다.
활동 정의에 intent-filter 노드를 추가합니다.
intent-filter 노드에 스킴 이름 을 포함하는 android:scheme 데이터 노드를 추가합니다.

예

이 예시에서는 스킴 이름 adjustExample을 사용하여 MainActivity라는 활동을 열도록 설정하는 방법을 보여줍니다.

<activity    android:name=".MainActivity"    android:configChanges="orientation|keyboardHidden"    android:label="@string/app_name"    android:screenOrientation="portrait">

   <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>

   <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="adjustExample" />
   </intent-filter>

   <intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="http" android:host="insights.go.link" />
    <data android:scheme="https" android:host="insights.go.link" />
   </intent-filter>

</activity>

이제 앱이 URI 스킴을 처리할 수 있습니다. 사용자가 스킴 이름 을 포함하는 deep_link 파라미터가 포함된 링크를 클릭하면 이 활동이 실행됩니다.

https://app.adjust.com/abc123?deep_link=adjustExample%3A%2F%2F

Android 앱 링크 구성

딥링크를 위해 Android 앱 링크를 설정하는 경우에도 스킴 이름을 구성해야 합니다.

Android 앱 링크의 경우, AndroidManifest.xml 파일에 intent 필터를 추가하여 앱이 처리할 수 있는 URL을 지정합니다. intent 필터에 android:autoVerify="true" 어트리뷰션과 함께 data 요소를 포함합니다.

이제 앱이 Android 앱 링크를 처리할 수 있습니다. 사용자가 insights.go.link 도메인이 포함된 링크를 클릭하면 앱이 자동으로 실행됩니다.

1
https://insights.go.link/login?adj_t=abc123

딥링크 정보 액세스

deep_link 파라미터의 콘텐츠 전송 위치를 지정할 수 있습니다. 이를 위해 AndroidManifest.xml 파일에서 활동에서 android:launchMode 속성을 설정합니다.

Adjust SDK는 onCreate 또는 onNewIntent 메서드를 사용하여 활동의 인텐트 객체 내에서 딥링크 정보를 전달합니다. 앱이 실행되고 두 메서드 중 하나가 실행된 후에 딥링크 콘텐츠에 액세스할 수 있습니다. 이후에 해당 정보를 앱의 다른 부분에서 액세스할 수 있습니다.

onCreate 또는 onNewIntent 메서드 내에서 getData() 메서드를 호출하여 딥링크 정보를 추출할 수 있습니다.

Kotlin
Java

1
override fun onCreate(savedInstanceState: Bundle?) {
2
   super.onCreate(savedInstanceState)
3
   setContentView(R.layout.activity_main)
4

5
   val intent = intent
6
   val data = intent.data
7
   // data.toString() -> This is your deep_link parameter value.
8
}

1
@Override
2
protected void onCreate(Bundle savedInstanceState) {
3
   super.onCreate(savedInstanceState);
4
   setContentView(R.layout.activity_main);
5

6
   Intent intent = getIntent();
7
   Uri data = intent.getData();
8
   // data.toString() -> This is your deep_link parameter value.
9
}

Kotlin
Java

1
override fun onNewIntent(intent: Intent?) {
2
   super.onNewIntent(intent)
3
   val data = intent?.data
4
   // data.toString() -> This is your deep_link parameter value.
5
}

1
@Override
2
protected void onNewIntent(Intent intent) {
3
   super.onNewIntent(intent);
4

5
   Uri data = intent.getData();
6
   // data.toString() -> This is your deep_link parameter value.
7
}

디퍼드 딥링크

Adjust SDK는 기본 설정에 따라 디퍼드 딥링크를 실행합니다. 추가 설정은 필요하지 않습니다. 이 행동을 비활성화하려면 setOnDeeplinkResponseListener 메서드를 사용하여 디퍼드 딥링크 콜백을 설정해야 합니다.

디퍼드 딥링크 콜백 설정

public void setOnDeeplinkResponseListener(OnDeeplinkResponseListener onDeeplinkResponseListener)

디퍼드 딥링크 수신 시 델리게이트 함수를 호출하도록 Adjust SDK를 구성할 수 있습니다. 이 델리게이트 함수는 딥링크를 String 인수로 수신합니다.

딥링크를 열려면 델리게이트 함수에서 true를 반환합니다. 열지 않으려면 false를 반환합니다.

1
val config = AdjustConfig(this, appToken, environment)
2
//...
3
config.setOnDeeplinkResponseListener { deeplink ->
4
   Log.d("example", "Deferred deep link callback called!")
5
   Log.d("example", "Deep link URL: $deeplink")
6
   true
7
}
8
//...
9
Adjust.onCreate(config)

1
AdjustConfig config = new AdjustConfig(this, appToken, environment);
2
//...
3
// Evaluate the deeplink to be launched.
4
config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() {
5
   @Override
6
   public boolean launchReceivedDeeplink(Uri deeplink) {
7
      Log.d("example", "Deferred deep link callback called!");
8
      Log.d("example", "Deep link URL: " + deeplink);
9

10
      return true;
11
   }
12
});
13
//...
14
Adjust.onCreate(config);

1
function deferredDeeplinkCallback(deeplink) {
2
   console.log("Deferred deep link callback called!");
3
   console.log(`Deep link URL: ${deeplink}`);
4
}
5
//...
6
let adjustConfig = new AdjustConfig(yourAppToken, environment);
7
adjustConfig.setOpenDeferredDeeplink(true);
8
adjustConfig.setDeferredDeeplinkCallback(deferredDeeplinkCallback);
9
//...
10
Adjust.start(adjustConfig);

예

다음 예시에서는 콜백 함수에서 false 값을 반환하여 SDK가 활동을 시작하는 것을 방지하는 방법을 보여줍니다.

Kotlin
Java

1
config.setOnDeeplinkResponseListener { deeplink ->
2
   false
3
}

1
config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() {
2
   @Override
3
   public boolean launchReceivedDeeplink(Uri deeplink) {
4
      return false;
5
   }
6
});

딥링크를 통한 리어트리뷰션

public static void appWillOpenUrl(Uri url, Context context)

Adjust를 통해 딥링크를 사용하여 리인게이지먼트 캠페인을 집행할 수 있습니다. 자세한 내용은 Campaign Lab에서 딥링크를 설정하는 방법을 확인하시기 바랍니다.

사용자를 리어트리뷰션하려면 앱에서 딥링크 콘텐츠를 수신할 때 appWillOpenUrl 메서드를 호출해야 합니다. 이후 Adjust SDK는 딥링크 내에서 새로운 어트리뷰션 데이터를 찾습니다. SDK가 새로운 정보를 찾으면 이는 리어트리뷰션을 위해 Adjust 서버로 전달됩니다.

1
override fun onCreate(savedInstanceState: Bundle?) {
2
   super.onCreate(savedInstanceState)
3
   setContentView(R.layout.activity_main)
4

5
   val intent = intent
6
   val data = intent.data
7
   Adjust.appWillOpenUrl(data, getApplicationContext())
8
}

1
@Override
2
protected void onCreate(Bundle savedInstanceState) {
3
    super.onCreate(savedInstanceState);
4
    setContentView(R.layout.activity_main);
5

6
    Intent intent = getIntent();
7
    Uri data = intent.getData();
8
    Adjust.appWillOpenUrl(data, getApplicationContext());
9
}

1
Adjust.appWillOpenUrl(deeplinkUrl);

링크 해석

public static void resolveLink(final String url,
                               final String[] resolveUrlSuffixArray,
                               final AdjustLinkResolutionCallback adjustLinkResolutionCallback)

일부 ESP(이메일 서비스 제공자)는 마케팅 캠페인에서 자체 커스텀 도메인을 사용합니다. 커스텀 도메인을 통해 클릭을 측정해야 하는 경우, 해당 링크를 해석하기 위해 SDK를 설정해야 합니다. 이를 위해 AdjustLinkResolution 클래스의 resolveLink 메서드를 호출합니다. Adjust SDK는 이후 딥링크를 열 때 해당 커스텀 링크를 따라가 해석합니다. 이를 통해 이메일 측정 캠페인과의 상호작용을 기록할 수 있습니다.

resolveLinkWithUrl 메서드는 다음 인수를 사용합니다.

url (String): 애플리케이션을 연 딥링크
resolveUrlSuffixArray (String[]): 해석해야 하는 구성된 캠페인의 커스텀 도메인
adjustLinkResolutionCallback (AdjustLinkResolutionCallback): 최종 URL을 반환하는 콜백.

메서드는 딥링크를 resolveUrlSuffixArray의 도메인에 대해 확인합니다. 일치하는 것이 없는 경우 딥링크 URL을 그대로 전달합니다. 일치하는 것이 있는 경우 링크를 해석하고, 결과 딥링크를 반환하도록 시도합니다. 이후 이를 콜백 파라미터에 보관합니다.

반환된 딥링크를 사용하여 사용자를 리어트리뷰션할 수 있습니다. 이를 위해 딥링크를 Adjust.appWillOpenUrl 메서드로 전달합니다.

Kotlin
Java

1
AdjustLinkResolution.resolveLink(url, arrayOf("example.com"), object : AdjustLinkResolution.AdjustLinkResolutionCallback {
2
   override fun resolvedLinkCallback(resolvedLink: Uri) {
3
         Adjust.appWillOpenUrl(resolvedLink, applicationContext)
4
   }
5
})

1
AdjustLinkResolution.resolveLink(url, new String[]{"example.com"}, new AdjustLinkResolution.AdjustLinkResolutionCallback() {
2
   @Override
3
   public void resolvedLinkCallback(Uri resolvedLink) {
4
      Adjust.appWillOpenUrl(resolvedLink, getApplicationContext());
5
   }
6
});