深度链接

您可以创建深度链接来将用户转到应用中的特定页面。针对用户是否已在设备上安装您的应用，Adjust SDK 会使用不同的逻辑：

直接深度链接：用于用户已经安装应用的情况。用户会被转向链接中指定的页面。
如果用户尚未安装应用，那么就会发生延迟深度链接。链接首先会将用户转向应用商店页面来安装应用。用户安装后，就会被带到链接中指定的页面。

用户通过链接打开应用后，SDK 就可以读取深度链接数据了。

设置深度链接

如果用户已经安装了您的应用，那么在与包含深度链接信息的链接互动时，应用就会打开。Adjust SDK 中包含的工具能够解析深度链接信息，在应用中使用。

您需要在应用层级上设置深度链接。请按照下方链接中的说明，在您的目标平台上设置深度链接：

iOS
安卓

通过深度链接进行再归因

要对用户进行再归因，您需要使用深度链接 URL 实例化一个ADJDeeplink/AdjustDeeplink对象并将其传递至Adjust.processDeeplink方法。这样，Adjust SDK 就会在深度链接中寻找新的归因信息。如果 SDK 找到新信息，就会将其转发至 Adjust 服务器进行再归因。

iOS

+ (void)processDeeplink:(ADJDeeplink *)deeplink

要通过深度链接启用 Adjust 再归因，请确保在应用代理回传中获得深度链接后调用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

安卓

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);