公域集成指南

即日起，广告监测模块将不再作为火山引擎增长分析产品售卖时的默认自带模块，如您需要额外使用广告监测模块的相关功能，请咨询您的客户经理。

正如私域集成指南所述，ALink是集智能短链、深度链接与延迟深度链接等能力的一个综合系统，可用于私域&公域媒体，玩转多种营销场景，为您的用户创造极佳体验
本文介绍如何将ALink的系统能力应用于公域合作媒体之上，使得用户在公域场景下也可以使用Deep Link和Deferred Deep Link能力

下表罗列几个典型的使用ALink的在公域下的场景类型和涉及的能力配置：

营销人员应该深知自己的使用场景，确定需要配置的具体步骤，下面分3个步骤循序渐进的介绍了每种能力的集成细节，同时，也明确指出了何时让客户端开发人员参与进来
注：下面三个大步骤按照先后顺序逐步推进，有配置的依赖关系(下面合作渠道都以巨量引擎这个渠道为例)

3.1 合作渠道长链

3.1.1 概述

正常集成我们的RangersLog客户端SDK，创建合作渠道推广活动并生成点击和曝光的监测链接，配置到合作媒体侧，监测广告的点击和曝光数据，与此同时将App内发生的新安装激活与之归因，得到转化数据，用于广告效果分析

• 参与者：市场运营或者产品即可

• 前置条件：已正确集成RangersLog SDK

• 花费时间：大概20min

• 具体例子：

小明是一家电子商城网站的营销人员，该商城有一个移动App，叫做：Buyer Online。
小明计划一项在抖音上的App营销活动，目标是尚未安装该应用的用户，需要查看抖音带来的转化用户数据
为了解决这个问题，小明使用了广告监测巨量引擎渠道监测对接能力，创建监测链接将其投放到巨量引擎后台，当广告投放出去后，用户点击该广告，巨量会将点击数据上报到数据平台，如果该用户也下载安装了app，监测数据平台会对这些新安装进行归因，使小明能够在监测面板上查询该抖音推广活动带来的转化数据。

3.1.2 配置步骤

1）创建推广活动

• 从A/B测试 OR 增长分析产品进入，进入广告监测页面，点击左上角-创建推广活动，如下所示：

• 配置推广活动信息，如下图所示：

• 创建完成，如下图所示：

将点击和曝光监测链接copy，留作后用

2）媒体后台创建转化跟踪

上述创建完成监测链接后，根据对应渠道接入指南创建API转化跟踪，并将监测链接填写即可，这里不再赘述

3.1.3 测试

做转化跟踪联调，确定整个全链路是没问题，也不再赘述

3.2 深度链接

3.2.1 概述

上面我们成功配置了合作渠道的监测链接，这里重点介绍下合作渠道如何配置深度链接
深度链接是指通过手机系统级提供的能力将已安装App的用户从App端外直接带进端内的技术。
通过这种操作，您可以为用户提供优质的用户体验，从而极大加强用户与应用的互动，提升用户的数据转化。
基于此章节的步骤可配置深度链接，并通过系统地集成之，使得合作渠道侧将点击广告的已安装App的用户直接发送至App内部的某个页面

• 参与者：

  • 市场运营或者产品

  • iOS开发

  • Android开发

• 前置条件：已正确完成上一步合作渠道长链的配置

• 花费时间：大概2hour

• 具体例子：

快到双十一了，小明想针对已注册的老用户，做部分商城商品的促销活动，期望已注册老用户点击抖音上的广告时可以直达App内的商品活动页面，增加购买转化
为了达到这个目的，小明在巨量上创建广告并配置应用直达，同时定向这批用户，当已注册安装的用户在抖音上看到这个广告并点击时可以直接直达双十一商品活动页，如果是已经卸载的用户，应该直接跳转到app应用下载链接，促使老用户安装app

3.2.2 配置步骤

1） 更新合作渠道长链，开启再营销

主要是更新推广活动的开启再营销部分，如下图所示：

更新完成，继续下一步保存即可

2）copy直达链接/监测链接

上面更新完监测链接后，我们回到推广活动管理找到该活动，如下所示：

• 鼠标hover在绿色的再营销上面，会出现URL Scheme的tips，copy之，留作后面填写至媒体后台

• copy点击/曝光监测链接

目前deeplink_value还不支持单活动(链接)的动态拼接和裂变(后续会支持)，除此之外，我们提供了6个预定义参数: tr_shareuser/tr_admaster/tr_param1-4，可以帮助用户更好的分析和做运营
如果，不希望创建多个推广活动来做广告直达和营销，可以通过动态拼接上面的自定义参数来达到一样的效果，我们以tr_param1为例，该参数作为App端内直达页面的标识，拼接如下：

• URI Scheme: douyin://tr_token=aabbccdd&tr_pram1=page1

• 监测链接：${long_url}&tr_param1=page1

3）媒体后台配置直达链接

这里，我们以巨量引擎为例，其他渠道不一样，但基本配置流程都差不多
媒体后台创建API应用直达转化跟踪, 如下图所示：

4）客户端SDK集成ALink

上述，我们已经把页面和媒体侧后台全部配置完成，现在我们先把App端的sdk配置完成，然后再走端到端全链路联调测试，验证配置的正确
现在联系客户端开发同学做SDK集成开发, 注意：由于只是使用URI Scheme唤醒，因此可以跳过App Links和Universal Links的集成

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

• iOS集成：直接跳到iOS集成ALink SDK超链接

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

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

当然，返回的字段较多，你也可以直接使用其他字段来路由，比如：当前配置的推广活动链接名称：syz_抖音，对应变量名：name

3.2.3 测试

1）使用设备联调工具联调深度链接，确定配置的正确性

可以直接通过我们成熟的联调工具，确保数据平台和App SDK配置正确，步骤如下：

• 打开侧边栏联调管理, 添加联调设备(Android和iOS可以分别走一遍联调流程)，如下图所示：

• 设备名称：可任意自定义

• 设备操作系统：根据您实际添加的设备操作系统选择;

  • ios：国内和海外均使用idfa，可扫码采集获取

  • android：

    • 国内：使用imei/meid/oaid，手机拨号输入“*#06#”，并按下拨号键，即可查看。（注意区分imei和meid，如有两个imei，为确保准确，可分别使用两个imei创建两个联调设备）。

    • 国外：使用Google Aid。

• 在联调设备列表中，找到您添加的联调设备，点击【开始联调】，选择【深度链接与延迟深度链接】，如下图所示：

• 选择联调类型与联调链接，如下图所示：

• 链接类型：直接选择URI Scheme

• 选择链接：选择刚创建的链接即可

• 选择设备联调已安装应用，这个是用于联调深度链接的

• 正式进入深度链接联调：确保您的设备已安装APP，使用任意可扫码的APP（推荐使用自带浏览器）扫码页面二维码，然后进入落地页，点击打开App，查看App调起和页面跳转是否符合预期，如下图所示：

2）查询数据

查询是否正确上报再互动数据(App唤醒数据),在再营销活动分析页面查询，如下图所示：

注：

• 实时数据有5min的cache，联调后大概等个5min再查询

• 使用设备联调工具做唤起测试时，不会有点击产生，下面的真实场景测试是有的

3）媒体侧联调工具联调转化跟踪

上面，我们使用联调工具验证了配置的正确性，现在按照媒体后台正式联调直达转化跟踪
这里不赘述联调流程了，直接按照媒体侧联调工具步骤走即可，期望目标：

• 媒体侧：按照预设的转化目标回传，使得联调成功

• 监测数据平台：正确上报唤醒数据和转化事件

3.3 延迟深度链接

3.3.1 概述

为了让所有用户（无论是现有用户还是新用户）都能有一样的深度链接体验，ALink提供了延迟深度链接解决方案，当新用户安装应用时，并在第一次打开时，ALink会为应用提供归因信息，包括链接上配置的任何参数，客户端开发者可以使用这些数据将新用户转至应用内的指定页面。

• 参与者：

  • 市场运营或者产品

  • iOS开发

  • Android开发

• 前置条件：已正确完成前两步合作渠道长链和深度链接的配置

• 花费时间：大概2hour

• 具体例子：

小明关于双十一的短信商品营销活动成功地将老客户直达App内双十一商品营销页
然而，小明也知道，可能一些在抖音上看到广告的人已经卸载了或者从未安装过这款商城应用Buyer Online。他希望这些潜在用户享受与现有用户相同的活动产品，以提高转化率和用户满意度。

为了达到这个目的，小明在和客户端开发人员的合作下，集成了ALink的延迟深度链接功能。看到抖音广告的未安装用户在点击并安装后，第一次打开就会被直接带到双十一商品营销页

3.3.2 配置步骤

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

之前的章节1） 更新合作渠道长链，开启再营销 已经做了deeplink_value的配置，延迟深度链接完全可以沿用之前的配置，不做任何更新，当然，也可以换另外一个参数值用于延迟唤醒

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

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

• Android集成：直接跳到Android SDK集成延迟深度链接

• iOS集成：直接跳到iOS SDK集成延迟深度链接超链接

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

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

当然，返回的字段较多，你也可以直接使用其他字段来路由，比如：当前配置的推广活动链接名称：syz_抖音，对应变量名：name

3.3.3 测试

1）使用设备联调工具联调延迟深度链接

目前，我们的设备联调工具还不支持联调合作渠道延迟深度链接，待开发...
可以自己mock下数据来做联调，具体步骤：

• 选择联调设备，并获取联调设备的设备号信息

  • Android：imei或者oaid

  • iOS：idfa

• 模拟媒体渠道发送广告点击，以巨量为例：

  • copy巨量的点击监测链接，如：${URL}?promotion_channel_id=toutiao&action_type=click&tracking_id=TR_yWkwzt7R&ad_name=__AID_NAME__&mac_upper_nocolon_md5=__MAC__&mac_upper_withcolon_md5=__MAC1__&ua=__UA__&imei_md5=__IMEI__&androidid_lower_md5=__ANDROIDID__&os_code=__OS__&ip=__IP__&timestamp_ms=__TS__&convert_id=__CONVERT_ID__&oaid=__OAID__&oaid_md5=__OAID_MD5__&click_id=__CLICK_ID__&request_id=__REQUEST_ID__&sl=__SL__&ad_id=__AID__&campaign_id=__CAMPAIGN_ID__&campaign_name=__CAMPAIGN_NAME__&creative_id=__CID__&creative_name=__CID_NAME__&account_id=__ADVERTISER_ID__&tr_site_id=__CSITE__&ctype=__CTYPE__&idfa=__IDFA__&caid1=__CAID1__&caid2=__CAID2__&callback_param=__CALLBACK_PARAM__&geo=__GEO__&callback_url=__CALLBACK_URL__&union_set=__UNION_SET__

  • 根据OS类型替换对应的设备号信息

    • Android: 将宏__IMEI__替换成设备的imei的md5字符串，__OAID__ 替换成oaid

    • iOS：将__IDFA__ 替换成idfa

• 手机点击这个替换后的链接，发送模拟的点击数据

• 安装当前App：确保设备可以正确发生激活

  • 如果是新设备：直接安装这个debug包即可

  • 老设备：卸载重装下debug包

• 打开App看下路由行为是否符合期望

2）查询数据

查询是否正确上报点击和转化数据(点击和归因后的转化数),在再营销活动分析页面查询，如下图所示：

注：

• 实时数据有5min的cache，联调后大概等个5min再查询

• 再归因：卸载重装激活数据，新用户激活：完全的新安装激活数据