ディープリンク

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

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

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

ディープリンクを設定する

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

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

iOS
Android

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

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

iOS

+ (void)processDeeplink:(ADJDeeplink *)deeplink

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

Swift
Objective-C

1
import AdjustSdk
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 <AdjustSdk/AdjustSdk.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

Android

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
adjustConfig.isDeferredDeeplinkOpeningEnabled = false;
3

4
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

6
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
adjustConfig.isLinkMeEnabled = true;
3

4
Adjust.initSdk(adjustConfig);

リファラーを使用したディープリンクを処理する

オプションのリファラーURLは、ディープリンクやアプリのソースを計測して、より正確なアトリビューションやリアトリビューション、ディープリンクを実現するために使用されます。例えば、SEOやオーガニック検索、Adjustリンクなどのチャネルには直接使用されません。クライアントのルートドメインでAndroidアプリリンクが実装されており、それによってアプリが起動する場合、そのチャネルでは、ユーザーのアトリビューションまたはリアトリビューションを行うために、リファラーURLから得られるシグナルに依存する場合があります。

この情報をアプリ内で取得できる場合は（iOSおよびAndroidでの取得方法を参照）、以下のようにSDKにリファラー情報を渡すことができます。

1
AdjustDeeplink adjustDeeplink = new AdjustDeeplink("DeepLinkThatLaunchedAnApp");
2
adjustDeeplink!.referrer = "Referrer";
3

4
Adjust.processDeeplink(adjustDeeplink);