本文为您介绍DataFinder上进行渠道追踪时，使用Alink的操作指导。

基本概念

典型场景

ALink是集合智能短链、深度链接等能力的一个综合系统，使用ALink可为您的用户创造更好的体验，将其从自有媒体源（主要是私域流量，如：官网/社交App/短信/邮箱/横幅等）转换为您的移动应用用户，同时灵活构建数据报表，帮助您轻松玩转拉新、沉默用户唤醒、流失用户召回、用户裂变分享等多种营销场景。
下表罗列几个典型的使用ALink的场景类型和涉及的能力配置。

当前仅APP端支持集成Alink。

ALink集成是需要多方人员协作的，主要涉及的角色与操作流程如下。

前提条件

集成ALink前，您需先创建推广渠道，用于后续创建ALink自定义链接时选用对应的推广渠道。创建推广渠道的操作详情请参见step1：配置与管理渠道。

step1：进入ALink配置页面

登录并进入DataFinder控制台后，单击顶部导航 运营优化 > 渠道追踪，单击页面左侧菜单栏的“ALink” 进入ALink配置页面。

step2：新建ALink模版

单击页面顶部的“新建模板”，在弹窗中配置ALink模板信息。

配置基础信息

配置智能短链

配置深度链接

# 安卓应用签名
12:9C:23:45:1A:41:5C:7C:49:C7:E8:AB:33:9A:11:3D:32:3F:D7:F1:D9:DE:2B:5E:A3:BC:FA:36:91:AC:0F:84

# 安卓包名
com.game.player

# iOS Team ID
ABC9T5ADEF

# Bundle ID
com.game.player

jd://product/1

step3：创建自定义链接

创建完模版后，可以基于此模版创建自定义链接。在Alink页面中，点击【新建链接】，即可在弹窗中配置自定义链接参数。

基础配置

链接创建一共分三步，首先是：基础配置。

配置智能短链

默认情况下，这里的地址栏都会被之前的模版配置的所填充，您也可以在这里更新修改，之后便会在该链接中生效。

配置深度链接

深度链接是再营销的一种技术手段，配置上需要在上述步骤中启动再营销开关之后，便可以在再营销查询面板上看该链接的再互动数据。

step4：（可选）配置落地页

由于设备系统唤起的限制，除了短信/Email等投放媒介可直接点击ALink链接唤起App，其他投放媒介一般都需要借助H5页来唤起，因此，最好配置H5落地页，提升各种场景的App唤起率。

1. 点击完成链接创建的最右侧，选择配置落地页，如下图所示：
   

2. 点击配置落地页，如下所示：
   

   参数	配置说明
   落地页url	填写App的推广H5落地页地址。
   配置代码	是兼容多种社交App和浏览器，尽可能提升App唤起的Deep Link JS SDK，联系前端同学，将此段代码集成到上面填写的H5落地页中，其中几个参数解释如下： Token: 当前链接的唯一标识，这个会在生成Deep Link JS代码的时候自动填充，可以不用管 enableClip：是表示是否开启剪切板，默认关闭，这个会在下面的延迟深度链接章节详细介绍 recordClick: 是否记录点击，默认情况下不需要开启，否则会重复记录点击数据，具体场景参考下面的FAQ章节：FAQ- 10：想用自己的H5链接投放 button：是触发唤醒或者下载app的按钮，需要做绑定，使用H5中button的id替换默认的downloadButton

以下为几个集成H5的特殊case：

1. H5页的button比较多，都需要绑定到Deep Link上，可以自己按照button规则重写代码，比如：

   // 下面是旧的button绑定
   var button = document.getElementById('downloadButton');
   
   
   // 新的button绑定，绑定到class上(这只是其中一个例子，完全可以按照自己需要定义绑定)
   var button = document.querySelectorAll(".invokeButton");
   

2. 不想强制绑定页面按钮，由自己的自定义点击事件中触发

   1. 在页面中引入JS SDK，示例：<script src="``https://lf3-data.volccdn.com/obj/data-static/data/dp/openapp/index.1.4.1.cn.js``"></script>（可以从配置落地页的代码框里拿到）

   2. 页面初始化，进行JS SDK的初始化工作，并将初始化实例绑定在全局（在代码中export 全局实例也是可以的）

      <script>
          window.__Alink__ = new window.Alink({
              token: '${token}', // 填写上图中的token
              ....              // 其他配置参数
              onReady: function () {}, // 空的onReady函数，必传
          })
       </script>
      

   3. 在自己绑定的点击事件中触发唤醒或下载，如下：

      function buttonClick() {
        // 触发唤醒或下载操作
        window.__Alink__.invokeOrInstall();
      }
      

3. H5页面想自定义解析参数透传到端内，而不是默认拼接在链接的查询字符串上
   目前，invokeOrInstall函数支持可选预置参数的入参，注意：参数的值一定要是字符串
   伪代码样例如下：

   // 调用示例 
   var myObj = {tr_shareuser: "syz", tr_param1: "ID123434", other: "extra"};
   invokeOrInstall(myObj);
   

   根据自己的需求，按照预置的6个自定义参数传入进去即可

step5：客户端SDK集成ALink

好了，前置配置已完成，现在联系客户端开发同学做SDK集成开发

• Android集成：直接跳到Android SDK 集成
• iOS集成：直接跳到iOS SDK集成

在onALinkData接口中，app开发者可以根据返回的数据来决定用户的接下来的动作，拿一开始小明的双十一商品页营销举例，使用配置的deeplink_value写下如下伪代码：

func onALinkData(alinkData map[string]string) {
    if alinkData['deeplink_value'] == '双十一' {
        navagateToDoubleElevenPage()   // 将当前用户路由到双十一营销页面会场
    }
}

当然，返回的字段较多，您也可以直接使用其他字段来路由，比如：当前配置的推广活动链接名称：小明_双十一_商品营销，对应变量名：name。

特殊场景：延迟深度链接配置说明

1）更新自定义链接，设置深度链接参数或者自定义参数，用于延迟直达

上述步骤中，深度链接 - 参数配置 已经做了deeplink_value或者tr_param的配置，延迟深度链接完全可以沿用之前的配置，不做任何更新，当然，也可以换另外一个参数用于延迟唤醒。

2）更新H5落地页配置(可选)

如果，上面深度链接配置的落地页并且集成了Deep Link JS SDK，则可以通过启用剪切板来提升延迟唤醒的准确度
原理：H5上sdk会将用户点击信息存入设备剪切板，当安装App并打开后，客户端SDK读取以达到精准的场景还原
只需要把Deep Link JS SDK中配置enableClip设置成true即可，这个也需要客户端SDK对应开启配置，请参考下文

3）客户端集成延迟深度链接

现在联系客户端开发同学做SDK集成开发：

• Android集成：直接跳到Android SDK 集成
• iOS集成：直接跳到iOS SDK集成

在onAttributionData接口中，app开发者可以根据返回的数据来决定用户的接下来的动作，拿一开始小明的双十一商品页营销举例，使用配置的deeplink_value写下如下伪代码：

func onAttributionData(attributionData map[string]string) {
    if attributionData['deeplink_value'] == '双十一' {
        navagateToDoubleElevenPage()   // 将当前用户路由到双十一营销页面会场
    }
}

当然，返回的字段较多，您也可以直接使用其他字段来路由，比如：当前配置的推广活动链接名称：小明_双十一_商品营销，对应变量名：name

这里列出做ALink联调可能遇到的问题，并给出自查步骤，如果自查步骤验证后无法解决，可以直接联系您的CSM反馈

Q1 联调App唤起不成功

唤起的前置条件：

• 当前App在手机中是已安装状态
• 正确按照深度链接配置

可按照以下几点自查下：

• 联调方式是什么？
  • 直接扫码或者直接点击ALink短链是唤起不了的(在短信里是可以的)，一般都是需要使用H5页面做承载，具体教程参考：深度链接 - 配置****落地页
  • 通过设备联调工具来做联调的，那看下一步
• 如果是URI Schema联调：确保iOS或者Android都已经在App内配置好

且，当前App是手机中是已安装状态

• 如果是ALink的链接联调：
  • Android: 联调页主要是使用URI Schema唤起，所以需要看下APP内是否正确配置
  • iOS：联调页主要是用Universal Links唤起，检查点包括：
    • 监测配置面板的BundleID和TeamID配置，访问：https://${subdomain}.``volctracer.com/.well-known/apple-app-site-association， 看是否可以下载文件，以及文件中的内容是否符合预期
    • SDK的Universal Links集成是否正确
• 如果是使用短信来做真实场景测试联调：这里主要用到了Android的App Links和iOS和Universal Links

和上述基本一致，提前检查监测面板和SDK对应配置是否正确，额外注意一点：ALink只会跳转形如：${domain}/a/${token}的链接，直接点击域名是不会唤醒的

Q2 使用设备联调工具联调深度链接，发现再营销分析页面没有点击数据

唤起的前置条件：

• 当前App在手机中是已安装状态
• 正确按照深度链接配置
• 联调正常唤醒App，并到指定页面
• 使用设备联调工具不会产生点击数据
• 使用短信媒介直接点击ALink链接唤起的场景也不会有点击（此时，Http请求会被系统拦截，所以没有点击）
• 页面实时数据查询有5min的cache，因此联调后大概等个5min再查询

Q3 成功唤起App，但页面没有再互动数据

唤起的前置条件：

• 正确按照深度链接配置
• 联调正常唤醒App，并到指定页面

如果保证上述前置条件满足，一般肯定会有再互动数据
如果唤起现象是正常唤起主页，但没有按预期跳转到指定页面，一般来说，是SDK没有正确回调onALinkData接口，因而也不会上报再互动事件数据
首先，SDK开启Debug日志并关闭加密，看下/service/2/alink_data接口请求和返回的结果是什么，要确保：SDK设置的appid和ALink所在的appid必须一致，否则接口会返回400，当然也不会回调

Q4 联调延迟深度链接，无法正确导航至指定页面

唤起的前置条件：

• 联调手机未安装App包
• 正确按照延迟深度链接配置
• 如果是Android，要确保开启延迟深度链接开关，iOS660及以后版本也增加了开关，和Android对齐，升级时注意启用开关
• 如果不是新手机，确保每次安装的Debug包的渠道或者版本号换下，否则不会产生安装激活数据，就不会有归因，当然不会回调onAttributionData接口
• 开启Debug日志，并关闭加密，看下接口/service/2/attributuion_data的请求和响应数据，并联系CSM内部提oncall查看

Q5 联调延迟深度链接，每次打开App都会跳转到指定页面(预期是第一次才会跳转)

唤起的前置条件：

• 联调手机未安装App包
• 正确按照延迟深度链接配置
• 按预期正确延迟唤醒App，导航到指定页面
• 确保跳转逻辑是否在onAttributionData里做的
• 如果不是，业务里一般会将参数临时保存，在跳转完成后要及时清理这个临时数据，否则每次打开都会跳转

Q6 联调延迟深度链接成功，但再营销分析页面没有再归因和激活数据

唤起的前置条件：

• 联调手机未安装App包
• 正确按照延迟深度链接配置
• 按预期正确延迟唤醒App，导航到指定页面
• 再归因数据：老设备的卸载重装数据，新用户激活：完全的新设备安装激活数据
• 一般确保前置条件满足，肯定会有激活数据产生，可以看下是否是实时查询的5min缓存导致

Q7 Deep Link配置完成落地页且集成了Deep Link JS SDK，商店跳转还需要单独开发吗？

不需要，一旦正确集成了我们的Deep Link JS SDK，未安装的商店跳转都由落地页SDK控制，跳转的商店地址使用的是链接中配置的Android和iOS的URL，所以，这里注意点：Android和iOS URL栏最好填写下载地址，而不是另外一个落地页，下图补充下配置了落地页的跳转链路：
暂时无法在飞书文档外展示此内容

Q8 私部场景下，如何增加ALink短域名?

SaaS场景下由广告监测提供ALink短域名，并允许客户定义三个子域名，但在私有化场景下，由客户提供域名支持ALink链接生成，默认使用埋点日志上报域名
如果客户想增加新的短域名用于ALink使用，步骤如下：

• 客户侧：申请新的短域名，将其按照埋点日志域名步骤转发到私部机器上，一般做A记录解析
• Rangers侧：增加ALink短域名解析和配置

上面两侧做好后，客户便可以在建立模版时选择该新的短域名，用于ALink链接创建,如下图所示：

客户的技术侧需要集成的sdk中增加新增的短域名，增加后再进行联调使用。
技术侧调整如下：

• iOS端：配置Universal Links时domain配置，在原来的ALink域名处增加新的短域名；（文档中客户端SDK**集成ALink-iOS集成-1.2Universal Links）
• Android端：配置App Links时domain配置，在原来的ALink域名处增加新的短域名；（文档中客户端SDK**集成ALink-Android集成-1.2配置App Links）
• H5端：Deep Link JS SDK Script中domain配置，在原来的ALink域名处增加新的短域名。（文档中集成步骤-2.深度链接-配置步骤-4；3.延迟深度链接-配置步骤-2）

Q9 SDK更新到iOS660版本后，需要手动配置开启延迟深度链接

config.enableDeferredALink = YES;

Q10 想使用自己的H5落地页链接投放，而不是ALink链接，怎么做？

默认，客户拿出去做投放的链接是平台上生成的ALink短链
但，因为某种原因，想使用自己的H5落地页链接做投放，但又想实现Deep Link和Deferred Deep Link
此时，只需要在Deep Link JS SDK上开启记录点击即可，样例代码：

<script src="https://lf3-data.volccdn.com/obj/data-static/data/dp/openapp/index.1.4.3.cn.js"></script>
<script>
    var alink = new window.Alink({
        token: '${token}',
        enableClip: false,  //是否开启剪贴板（用于分享裂变场景，默认关闭）
        recordClick: true, // 是否记录点击，默认不需要开启
        onReady: function () {
          // 执行初始化操作或者事件绑定
          console.log('alink ready')
          var m = this;
          var button = document.getElementById('downloadButton');
          if (button) {
            button.onclick = function () {
              m.invokeOrInstall();
            };
          }
        },
    })
 </script>

配置完成并投放出去后，虽然没有通过ALink链接进到落地页，当未安装App时，跳转到应用商店便会记录点击数据，用于延迟深度链接归因