深度链接LinkedME与Deeplink

一、前言

介绍

LinkedME是国内首家企业级深度链接服务提供商，致力于帮助移动APP解决用户增长和流量变现的问题。 LinkedME提供“一键活跃”，“场景还原”，“场景运营”等功能，大大提供APP的活跃度，更好地解决流量变现。致力于打造App与App之间的桥梁，感知用户行为，引发场景消费。

作用

由于苹果公司设立的安全机制限制了各APP之间的信息交互，LinkedMe使用Deeplink技术实现在A(App)点击链接，跳转到B(App)的某个界面，如果用户没有安装B(App)，则指引到App Store 下载，并且保证用户下载安装B(App)后，依旧可以跳转到具体页面。

二、配置及使用

1.准备工作

这里是LinkedME文档中心

1.1. 获取LinkedME Key

新用户：在官网网站注册账号，注册后创建应用，在后台导航栏“设置”中查看LinkedME Key。
老用户：已经在官网网站注册账号，直接创建应用（可以创建多个应用），直接到导航栏“设置”中查看LinkedME Key。

1.2. 获取LinkedME iOS SDK及Demo
到官方网站下载LinkedME-iOS-Deep-Linking-SDK，下载Demo工程

1. 导入SDK
   您可以直接导入下载的SDK或通过Cocoapods安装SDK

2.1. 直接导入LinkedME iOS SDK
把Demo工程中的LinkedME_iOS.framework，导入工程中。

CoreSpotlight.framework (status:Optional)
SystemConfiguration.framework
Security.framework
WebKit.framework
StoreKit.framework

注意事项：CoreSpotlight.framework必须标记为可选。

2.2. 通过Cocoapods安装SDK
如果您想更方便地集成/更新 LinkPage的SDK，可以使用Cocoapods工具，想要了解Cocoapods，推荐参考官方文档《CocoaPods安装和使用教程》。
编辑Podfile文件并添加以下代码

pod 'LinkedME_LinkPage'

运行 pod installin

从现在开始使用 .xcworkspace 打开项目，而不是 .xcodeproj
提示：如果提示[!] Unable to find a pod with name, author, summary, or description matching LinkedME_LinkPage
解决方法就是Finder前往资源库去删除缓存中的search_index.json
执行：rm -rf ~/Library/Caches/CocoaPods/search_index.json 再重新search/install/update

1. 基本配置
   3.1. 添加系统Framework
   CoreSpotlight.framework(status:Optional)
   SystemConfiguration.framework
   Security.framework
   WebKit.framework
   StoreKit.framework
   注意：CoreSpotlight.framework必须标记为可选。

3.2. 配置linkedme_key
打开info.plist文件
在列表中点击右键选择add row添加一个分组
创建一个新的item名称为linkedme_key，类型为Dictionary
在linkedme_key新增一个字符串类型的item，live字段，到后台“设置”->“应用”中进行查看

3.3. 配置URL Scheme
配置URL Scheme，以便通过URL Scheme来唤起APP
打开info.plist
找到URL Types（如果没有就右键add row添加一个）
添加”you app”(你的app的唯一标识字符串)

3.4. 配置Universal Link支持 (仅支持iOS 9)
配置Universal Link，使得iOS9中可以通过Universal Link来唤起APP
在左侧导航器中点击您的项目
选择’Capabilities’标签
打开’Associated Domains’开关
添加applinks:lkme.cc和applinks:www.lkme.cc

3.5. 添加URLScheme和Universal Link支持
在SDK中配置URL Scheme和Universal Link，使得可以通过URL Scheme和Universal Link唤起APP 在Appdelegate中实现下列方法：

- (BOOL)application:(UIApplication*)application openURL:(NSURL*)url sourceApplication:(NSString*)sourceApplication annotation:(id)annotation{
  //判断是否是通过LinkedME的UrlScheme唤起App
  if ([[url description] rangeOfString:@"click_id"].location != NSNotFound) {
    return [[LinkedME getInstance] handleDeepLink:url];
  }

  return YES;
}
//Universal Links 通用链接实现深度链接技术
- (BOOL)application:(UIApplication*)application continueUserActivity:(NSUserActivity*)userActivity restorationHandler:(void (^)(NSArray*))restorationHandler{

  //判断是否是通过LinkedME的Universal Links唤起App
  if ([[userActivity.webpageURL description] rangeOfString:@"lkme.cc"].location != NSNotFound) {
    return  [[LinkedME getInstance] continueUserActivity:userActivity];
  }
  return YES;
}
//URI Scheme 实现深度链接技术
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary *)options{
  NSLog(@"opened app from URL %@", [url description]);

  //判断是否是通过LinkedME的UrlScheme唤起App
  if ([[url description] rangeOfString:@"click_id"].location != NSNotFound) {
    return [[LinkedME getInstance] handleDeepLink:url];
  }
  return YES;
}

1. 深度链接功能
   本模块实现的功能是创建深度链接及通过深度链接跳转到APP内的详情页面，若想要使用如下功能，请务必将“基本配置”部分全部实现

4.1. 创建深度链接

温馨提示：如果web端集成了web sdk，则无需客户端创建深度链接，本节无需集成。
通过SDK创建深度链接，例如在分享页面时，页面的链接是通过SDK生成的深度链接，当打开分享内容时就可以通过深度链接唤起APP并进入对

//创建短链
-(void)addPara{
  self.linkedUniversalObject = [[LMUniversalObject alloc] init];
  self.linkedUniversalObject.title = title;//标题
  LMLinkProperties *linkProperties = [[LMLinkProperties alloc] init];
  linkProperties.channel = @"";//渠道(微信,微博,QQ,等...)
  linkProperties.feature = @"Share";//特点
  linkProperties.tags=@[@"LinkedME",@"Demo"];//标签
  linkProperties.stage = @"Live";//阶段
  [linkProperties addControlParam:@"View" withValue:arr[page][@"url"]];//自定义参数，用于在深度链接跳转后获取该数据，这里代表页面唯一标识
  [linkProperties addControlParam:@"LinkedME" withValue:@"Demo"];//自定义参数，用于在深度链接跳转后获取该数据，这里标识是Demo 
  //开始请求短链
  [self.linkedUniversalObject getShortUrlWithLinkProperties:linkProperties andCallback:^(NSString *url, NSError *err) {
    if (url) {
      NSLog(@"[LinkedME Info] SDK creates the url is:%@", url);
      //拼接连接
      [H5_LIVE_URL stringByAppendingString:arr[page][@"form"]];
      [H5_LIVE_URL stringByAppendingString:@"?linkedme="];
      H5_LIVE_URL = [NSString stringWithFormat:@"https://www.linkedme.cc/h5/%@?linkedme=",arr[page][@"form"]];
      //前面是Html5页面,后面拼上深度链接https://xxxxx.xxx (html5 页面地址) ?linkedme=(深度链接)
      //https://www.linkedme.cc/h5/feature?linkedme=https://lkme.cc/AfC/mj9H87tk7
      LINKEDME_SHORT_URL = [H5_LIVE_URL stringByAppendingString:url];      
    } else {
      LINKEDME_SHORT_URL = H5_LIVE_URL;
    }
  }];
}

参数名称 含义 功能

Channel 渠道 表示深度链接的渠道，方便统计分析和追踪，例如微信、微博，百度等等；
Feature 特点 表示深度链接的特点，例如邀请，分享等等；
Tags 标签 表示深度链接的标签特性，自定义任何值；
Stage 阶段 表示深度链接的阶段特性，比如第一版产品发布，第二版本测试等等；

4.2. 解析深度链接
通过深度链接唤起APP时，解析深度链接携带的参数以打开对应页面

4.2.1. 配置AppDelegate
Objective-C请先进行如下配置：
在AppDelegate中引入头文件#import

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.'
//初始化及实例
LinkedME* linkedme = [LinkedME getInstance];

//    //注册需要跳转的viewController
UIStoryboard * storyBoard=[UIStoryboard storyboardWithName:@"Main" bundle:[NSBundle mainBundle]];
DetailViewController  *dvc=[storyBoard instantiateViewControllerWithIdentifier:@"detailView"];

//[自动跳转]如果使用自动跳转需要注册viewController
//    [linkedme registerDeepLinkController:featureVC forKey:@"LMFeatureViewController"];

//获取跳转参数
[linkedme initSessionWithLaunchOptions:launchOptions automaticallyDisplayDeepLinkController:NO deepLinkHandler:^(NSDictionary* params, NSError* error) {
  if (!error) {
    //防止传递参数出错取不到数据,导致App崩溃这里一定要用try catch
    @try {
      NSLog(@"LinkedME finished init with params = %@",[params description]);
      //获取标题
      NSString *title = [params objectForKey:@"$og_title"];
      NSString *tag = params[@"$control"][@"View"];

      if (title.length >0 && tag.length >0) {
//如果app需要登录或者注册后，才能打开详情页，这里可以先把值存起来，登录/注册完成后，再使用
        //[自动跳转]使用自动跳转
        //SDK提供的跳转方法
        /**
        *  pushViewController : 类名
        *  storyBoardID : 需要跳转的页面的storyBoardID
        *  animated : 是否开启动画
        *  customValue : 传参
        *
        *warning  需要在被跳转页中实现次方法 - (void)configureControlWithData:(NSDictionary *)data;
        */

        //  [LinkedME pushViewController:title storyBoardID:@"detailView" animated:YES customValue:@{@"tag":tag} completion:^{
        
        //  }];

        //自定义跳转
        dvc.openUrl = params[@"$control"][@"ViewId"];
        [[LinkedME getViewController] showViewController:dvc sender:nil];
      }
    } @catch (NSException *exception) {

    } @finally {
    }
  } else {
    NSLog(@"LinkedME failed init: %@", error);
  }
}];
  return YES;
}

1. 其他功能
   5.1. Debug模式
   在Debug模式下会打印日志

[linkedme setDebug];

5.2. 测试模式
若想测试集成SDK后是否能正确生成并解析深度链接，可以使用测试模式。测试模式需要先在后台中注册您的测试设备，测试设备产生的数据将进入测试系统（Test）中。
在后台(Dashboard)中-设置-测试-添加测试设备
OC：通过[LinkedME getTestID]获取设备ID,去后台中添加设备
Swift：通过LinkedME.getTestID()获取设备ID,去后台中添加设备

5.3. Spotlight 索引
配置Spotlight索引后，可以在iPhone的系统级搜索（主屏下拉或下拉菜单中的搜索）中搜索内容并直接打开APP的特定页面

5.3.1. 创建Spotlight索引

NSSet *keyWord = [NSSet setWithObjects:@"linkedme", nil];

需要传递的参数

NSSet *set5 = [NSSet    setWithObjects:@"linkedme",@"linked",@"深度链接", nil];

关键字详解

title   标题
description 描述
publiclyIndexable   是否公开
type    类型
thumbnailUrl    缩略图Url
keywords    关键字
userInfo    用户详情
expirationDate  失效日期,设置失效日期会自动删除索引
identifier  标志符
callback    回调
spotlightCallback   Spotlight回调

5.3.2. 删除索引
删除所有索引

[LinkedME removeAllSearchItems];

通过spotlightIdentifier删除索引

[LinkedME removeSearchItemWith:@[@"linkedme"]];

dg思考的问题

LinkedMe通过链接把用户带领到未知的地方，是否会恶意引导去下载某些APP呢？