ディープリンク

ディープリンクを作成して、ユーザーをアプリ内の特定の場所に誘導します。Adjust SDKは、ユーザーがデバイスにアプリをインストール済みかどうかによって、異なるロジックを使用します。

ダイレクトディープリンクは、ユーザーがアプリをすでにデバイスにインストールしている場合に使用されます。そのリンクは、リンクで指定されたページにユーザーをリダイレクトします。
ディファードディープリンクは、ユーザーがアプリをデバイスにインストールしていない場合に使用されます。そのリンクは、ユーザーをアプリストアに送り、アプリを先にインストールしてもらいます。ユーザーがアプリをインストールすると、リンクで指定されたページが開きます。

SDKは、ユーザーがリンクからアプリを起動した後にディープリンクの情報を読み取ることができます。

ディープリンクの設定

ユーザーがアプリをインストールしている場合、ユーザーがディープリンクの情報を含むリンクをクリックするとアプリが起動します。Adjust SDKには、アプリ全体にディープリンクの情報を解析するツールが含まれます。

ディープリンクは、アプリレベルで設定する必要があります。使用するプラットフォームに合わせて、以下のリンク先のディープリンク設定手順に従ってください。

iOS
Android

ディープリンクを使用したリアトリビューション

ユーザーをリアトリビュートするには、ディープリンクURLでADJDeeplink / AdjustDeeplinkオブジェクトをインスタンス化し、 Adjust.processDeeplinkメソッドにパスする必要があります。 Adjust SDKは次に、ディープリンク内の新しいアトリビューションデータを検索します。SDKが新しい情報を見つけた場合、その情報をAdjustのサーバーに転送し、リアトリビューションを行います。

+ (void)processDeeplink:(ADJDeeplink *)deeplink

ディープリンクによるAdjustのリアトリビューションを有効にするには、アプリデリゲートコールバックの1つでディープリンクを取得したら、必ずAdjust.processDeeplinkメソッドを呼び出してください。

Swift
Objective-C

1
import Adjust
2

3
class AppDelegate {
4

5
   func application(application:UIApplication!, didFinishLaunchingWithOptions launchOptions:NSDictionary!) -> Bool {
6
      GeneratedPluginRegistrant.registerWithRegistry(self)
7
      // Override point for customization after application launch.
8
      return super.application(application, didFinishLaunchingWithOptions:launchOptions)
9
   }
10

11
   func application(application:UIApplication!, openURL url:NSURL!, sourceApplication:String!, annotation:AnyObject!) -> Bool {
12
     let deeplink = ADJDeeplink(deeplink: url)!
13
     Adjust.processDeeplink(deeplink)
14
      return true
15
   }
16

17
   func application(application:UIApplication!, continueUserActivity userActivity:NSUserActivity!, restorationHandler:([AnyObject]!)->Void) -> Bool {
18
         if (userActivity.activityType() == NSUserActivityTypeBrowsingWeb) {
19
            let deeplink = ADJDeeplink(deeplink: userActivity.webpageURL())!
20
            Adjust.processDeeplink(deeplink)
21
         }
22
         return true
23
   }
24
}

1
#import "Adjust.h"
2

3
@implementation AppDelegate
4

5
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
6
   [GeneratedPluginRegistrant registerWithRegistry:self];
7
   // Override point for customization after application launch.
8
   return [super application:application didFinishLaunchingWithOptions:launchOptions];
9
}
10

11
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
12
   [Adjust processDeeplink:[ADJDeeplink alloc] initWithDeeplink:url]];
13
   return YES;
14
}
15

16
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<uiuseractivityrestoring>> *restorableObjects))restorationHandler {
17
   if ([[userActivity activityType] isEqualToString:NSUserActivityTypeBrowsingWeb]) {
18
      [Adjust processDeeplink:[ADJDeeplink alloc] initWithDeeplink:[userActivity webpageURL]]];
19
   }
20
   return YES;
21
}
22

23
@end

public static void processDeeplink(AdjustDeeplink deeplink)

ディープリンクによるAdjustのリアトリビューションを有効にするには、アクティビティでディープリンクを取得したら、必ずAdjust.processDeeplinkメソッドを呼び出してください。

Kotlin
Java

1
import com.adjust.sdk.flutter.AdjustSdk
2
import io.flutter.embedding.android.FlutterActivity
3
// Used for post flutter 1.12 Android projects
4
//import io.flutter.app.FlutterActivity
5

6
class MainActivity : FlutterActivity() {
7
   // Either call make the call in onCreate.
8
   override fun onCreate(savedInstanceState: Bundle?) {
9
      super.onCreate(savedInstanceState)
10
      // GeneratedPluginRegistrant.registerWith(this)
11
      // Used only for pre flutter 1.12 Android projects
12
      Intent intent = getIntent()
13
      Uri data = intent.getData()
14
      Adjust.processDeeplink(new AdjustDeeplink(data), this)
15
   }
16

17
   // Or make the call in onNewIntent.
18
   override fun onNewIntent(intent: Intent?) {
19
      super.onNewIntent(intent)
20
      Uri data = intent.getData()
21
      Adjust.processDeeplink(new AdjustDeeplink(data), this)
22
   }
23
}

1
import com.adjust.sdk.flutter.AdjustSdk;
2
import io.flutter.embedding.android.FlutterActivity; // Used for post flutter 1.12 Android projects
3
//import io.flutter.app.FlutterActivity; // Used for pre flutter 1.12 Android projects
4

5
public class MainActivity extends FlutterActivity {
6
   // Either call make the call in onCreate.
7
   @Override
8
   protected void onCreate(Bundle savedInstanceState) {
9
      super.onCreate(savedInstanceState);
10
      // GeneratedPluginRegistrant.registerWith(this); Used only for pre flutter 1.12 Android projects
11

12
      Intent intent = getIntent();
13
      Uri data = intent.getData();
14
      Adjust.processDeeplink(new AdjustDeeplink(data), this);
15
   }
16

17
   // Or make the cakll in onNewIntent.
18
   @Override
19
   protected void onNewIntent(Intent intent) {
20
      super.onNewIntent(intent);
21
      Uri data = intent.getData();
22
      Adjust.processDeeplink(new AdjustDeeplink(data), this);
23
   }
24
}

ディファードディープリンク

bool? isDeferredDeeplinkOpeningEnabled;

SDKはデフォルトでディファードディープリンクを開きます。追加設定はありません。ConfigインスタンスのisDeferredDeeplinkOpeningEnabledプロパティを false に設定することで非有効化にすることができます。

1
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
2
//...
3
adjustConfig.isDeferredDeeplinkOpeningEnabled = false;
4
//...
5
Adjust.initSdk(adjustConfig);

ディファードディープリンクのコールバックを設定する

typedef void DeferredDeeplinkCallback(String? deeplink);
DeferredDeeplinkCallback? deferredDeeplinkCallback;

関数をconfigインスタンスのdeferredDeeplinkCallbackプロパティに追加することで、Adjust SDKがディファードディープリンクを受け取った際に、関数を呼び出すように設定することができます。この関数は、ディープリンクをString引数で受け取ります。

1
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
2
adjustConfig.deferredDeeplinkCallback = (String? deeplink) {
3
   print('[Adjust]: Received deferred deeplink: ' + deeplink);
4
};
5
Adjust.initSdk(adjustConfig);

例

この例では、ユーザーがディファードディープリンクを開いたときに、ディープリンクのアドレスをログに記録する方法を示しています。

1
import 'package:adjust_sdk/adjust.dart';
2
import 'package:adjust_sdk/adjust_config.dart';
3

4
initPlatformState() async {
5
   AdjustConfig config =
6
      new AdjustConfig('2fm9gkqubvpc', AdjustEnvironment.sandbox);
7
   config.logLevel = AdjustLogLevel.verbose;
8

9
   config.deferredDeeplinkCallback = (String? uri) {
10
      print('[Adjust]: Received deferred deeplink: ' + uri!);
11
   };
12

13
   Adjust.initSdk(config);
14
}

LinkMeを有効にする

bool? isLinkMeEnabled;

Adjust SDKでは、デバイスのペーストボードからディープリンクの情報をコピーすることが可能です。AdjustのLinkMeソリューションを組み合わせることで、iOS 15以降のデバイスでディファードディープリンクを有効化することができます。

ユーザーがLinkMeのURLをクリックすると、そのリンク情報をシステムのペーストボードにコピーするオプションがあります。Adjust SDKを使用してシステムのペーストボードを読み、ディープリンクの情報を確認することができます。ディープリンクがある場合、SDKはユーザーをアプリ内の正しいページに転送します。

アプリ内でペーストボードの確認を有効化するには、ConfigオブジェクトのisLinkMeEnabledプロパティをtrueに設定します。

1
AdjustConfig adjustConfig = new AdjustConfig('{YourAppToken}', AdjustEnvironment.sandbox);
2
//...
3
adjustConfig.isLinkMeEnabled = true;
4
//...
5
Adjust.initSdk(adjustConfig);