当已安装应用的用户点击 Adjust 链接时,直接深度链接可确保将用户直接转到应用内的特定内容。
工作原理
- 用户点击 Adjust 链接。
- 操作系统打开您的应用,并将深度链接发送至原生代码 (iOS 或 Android)。
app_links库会将链接转发至您的 Flutter 代码。- 您的代码会将链接发送至 Adjust SDK 进行归因。SDK 还能解析短品牌化链接。
- 您的代码会根据已解析的链接为用户导航。
Adjust SDK 方法
处理深度链接 (推荐)
使用 Adjust.processDeeplink 方法,该方法会执行以下操作:
- 记录深度链接点击的归因
- 将品牌化短链接解析为其等效的品牌化长链接
- 按原样透传所有其他链接
static Future<String?> processDeeplink(String deeplink)应用将打开 URL (遗留)
Adjust.appWillOpenUrl 方法会记录来自深度链接点击的归因,但不会解析短品牌化链接。
static void appWillOpenUrl(String url)processDeeplink 方法会取代该遗留方法。
实施
使用 app_links 库接收深度链接,并将其发送至 Adjust SDK。
dependencies: app_links: ^6.0.0 # check pub.dev for latest versionfinal _appLinks = AppLinks();
Future<void> _initDeepLinks() async { // Handle link when app is started from a deep link final initialLink = await _appLinks.getInitialLink(); if (initialLink != null) { _handleDeepLink(initialLink); }
// Handle links when app is already running _appLinks.uriLinkStream.listen(_handleDeepLink);}
Future<void> _handleDeepLink(Uri incomingLink) async { // Send deep link to Adjust's servers for attribution. // If short branded link, receive long link. // Otherwise, receive original link. final resolvedLink = await Adjust.processDeeplink(incomingLink.toString());
// Handle failure if resolvedLink is null if (resolvedLink == null) return;
/* * TODO: Handle the deep link and navigate to the appropriate screen. * * Possible resolvedLink formats: * * 1. https://brandname.go.link/?adj_t=def456& * adj_link=https%3A%2F%2Fexample.com%2Fsummer-clothes%3Fpromo%3Dbeach * -> extract and decode the deep link from adj_link * * 2. https://brandname.go.link/summer-clothes?promo=beach&adj_t=def456 * -> extract path from the URL * * 3. example://summer-clothes?promo=beach&adj_t=def456 * -> extract path from the URL * * Note (Android only): If your Android app scheme path differs from iOS, * you may receive: * https://brandname.go.link/?adj_t=def456& * adj_deep_link=example%3A%2F%2Fandroid-specific-path%3Fparam%3Dvalue * -> extract and decode the deep link from adj_deep_link */}Android: 专用深度链接活动
如果您的主要活动为 singleTop、standard或未指定启动模式,则需要创建专用的深度链接活动,以确保深度链接能在应用已经运行的情况下正确打开。
之所以有必要,是因为如果配置有误,深度链接就可能在新的任务或另一个应用任务中启动应用 (例如浏览器) 导致两个应用实例同时运行。
原生 Android 设置
- 使用专用深度链接活动方法配置 manifest
- 创建一个 DedicatedDeepLinkActivity,将深度链接转发到您的主 FlutterActivity
深度链接如何抵达您的 Flutter 代码
- 用户点击 Adjust 链接。
- 操作系统使用深度链接 Intent 打开您的
DedicatedDeepLinkActivity。 DedicatedDeepLinkActivity使用标记将 Intent 转发至您的主FlutterActivity,将现有实例置于最前面。FlutterActivity将深度链接 URI 发送至 FlutterEngine。- FlutterEngine 会将 URI 发送至您的 Dart 代码,
app_links会在代码中接收该 URI。
无论您使用哪种 Flutter 深度链接库,该流程都是相同的。除上述代码外,您无需额外的 Flutter 代码即可与 Adjust SDK 集成。