概述

您可以在旅程中使用深层链接，通用广告链接，快速链接和通用电子邮件。在本指南中，我们将引导您逐步了解如何配置默认和自定义链接行为，以及如何创建短链接和长链接。

默认链接行为

您的应用尚未安装

• 用户clicks Branch深度链接

• 设备navigates 到fallback （例如，应用商店或网站）

• 用户installs 和opens 您的应用

• Branch深度链接data 传递到您的应用中

您的应用已安装

• 用户clicks Branch深度链接

• 设备opens 您的应用程序或导航到预期的链接行为

• Branch深度链接data 传递到您的应用中

预期的链接行为

• 预期的链接行为取决于应用程序是否支持深度链接

• *Able to force app open 使用$uri_redirect_mode或启用Deepview

自定义链接行为

将数据从链接传递到应用

• 将链接数据添加到每个深度链接接

• 将键值对添加到您的快速链接

• 附加Query String请求参数 https://example.app.link/fzmLEhobLD?$custom_data=123&hello=world

退回到特定网址

• 确定深度链接接将导航到的位置

  • 您的应用尚未安装

  • [或] 另一个应用程序阻止其他应用程序进行深度链接

• Fallback替代值 （按优先级排序）

  • 添加Query String请求参数 https://example.app.link?$ios_url=https://example.com
  • 添加链接数据$ios_url = 'https://example.com' （ 文档 ）
  • 为深层视图添加链接数据$ios_deepview = 'deepviewId' （ 文档 ）
  • 在Branch Dashboard上全局启用Deep View
  • 添加链接数据$fallback_url = 'https://example.com' （ 文档 ）
  • 在Branch Dashboard上加上iOS/Android Custom URL
  • 在Branch Dashboard上加上Default URL ($fallback_url)

打开Web网页而不是应用

• 您的应用尚未安装
  • 设备navigates 到fallback （例如，应用商店或网站）
• 您的应用已安装
  • iOS： 需要覆盖Universal Links
    • 添加$web_only = true （ 文档 ）
    • 添加重定向$ios_url = 'https://google.com' （ 文档 ）
    • [或] 将/e/ 附加到深度链接接
      • 例如https://example.app.link/fzmLEhobLD - > https://example.app.link/e/fzmLEhobLD
  • Android： 需要覆盖App Links
    • 取消选中Enable App Links ，然后在Branch Dashboard上打Save
    • 添加重定向$android_url = 'https://google.com' （ 文档 ）
    • 添加带有$android_deeplink_path = 'random' （ docs ）的损坏的URI Scheme

社交链接行为

• 使用 OG标签将内容显示为Facebook，Twitter，Pinterest，iMessage等中的预览卡。
  • 基本是$og_title ， $og_description和$og_image_url
• 使用深度视图将内容显示为网站
  • 增加 install attribution
  • 在特定应用中完成深度链接接体验

UTM行为

❗️

默认启用

要禁用此功能，请转到Link Settings -> Advance Settings -> Analytics mapping with UTM 。

• 重定向到Web URL时，Branch自动将以下Branch Link分析标记中的任何值作为UTM参数传递：
  • ~campaign -> utm_campaign
  • ~channel -> utm_source
  • ~feature -> utm_medium
• 这适用于使用以下任一所定义的网页的URL $fallback_url ， $ios_url ， $android_url ， $desktop_url ， $original_url ，和$canonical_url 。
• 如果在重定向到的URL上已经检测到这些UTM参数，Branch将不会覆盖它们。
• 有关UTM参数的更多信息，请阅读Google Analytic ' s 自定义广告系列文章。

创建深度链接接

短链接

• 短链接是最常见的深度链接接
• 您可以自定义example.app.link的子域，或更改为自己的个人域（ links.yoursite.com ）
• 您可以在创建过程中将短代码的外观定制为自定义alias
  • 别名可以是短字符串，例如 https://example.app.link/october-sale
  • 或者可以是完整的链接路径，例如 https://example.app.link/product/id1234
• 短链接在链接创建时将链接数据封装在其中
  • 例如现有链接 https://example.app.link/fzmLEhobLD
• 短链接可以附加其他数据
  • 例如动态链接 https://example.app.link/fzmLEhobLD?content_id=123
• 创建短链接的方法
  • 使用快速链接进行快速链接创建和轻松跟踪
  • 使用我们的App SDK在您的应用程序内创建和共享链接
  • 使用我们的Web SDK 来创建有助于将您的网络用户转换为应用程序用户的链接
  • 使用我们的HTTP API 以编程方式从您的服务器创建链接
  • 使用我们的 Chrome扩展程序从您的浏览器生成链接

长链接

• 无需网络调用Branch服务即可创建长链接
• 长链接需要将链接数据添加为Quey String请求参数。确保对链接中的所有url进行URI编码。
  • 例如现有链接 https://example.app.link/fzmLEhobLD?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
  • 例如动态链接 https://example.app.link/?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
• 长链接需要使用/a/和分支键（如果使用custom link domain
  • 例如现有链接 https://link.example.com/5NPh/p4M09KRLrD?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
  • 例如动态链接 https://link.example.com/a/key_live_kaFuWw8WvY7yn1d9yYiP8gokwqjV0Swt?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
• 长链接需要使用/a/和分支键（如果使用bnc.lt
  • 例如现有链接 https://bnc.lt/5NPh/p4M09KRLrD?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
  • 例如动态链接 https://bnc.lt/a/key_live_kaFuWw8WvY7yn1d9yYiP8gokwqjV0Swt?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
• 将tags 添加到动态链接时，请分别输入每个标签
  • 例如 https://example.app.link/?foo=bar &标签= tag1 &标签= tag2

配置深度链接接

您可以'随意将自己的任何键值参数添加到“Beanch”链接。这些参数将通过Branch SDK传递到您的应用程序，但是某些键会有特定的额外效果。

保留的前缀

• Branch将其他属性添加到您的深度链接接数据中以解释链接

分析标签

• 这些标签可让您过滤和分組深度链接

• 这些标签可让您自定义单个链接的归因窗口

自订资料

• 传递任何自定义数据以在您的应用程序内部读取

重新导向

• 根据设备信息导航到其他位置
• 导航网址必须是网站，而不是深度链接接

强制重定向

• 点击Branch深链接时，防止其他应用发出错误消息

• 支持的应用程式
  • Facebook Newsfeed iOS
  • Instagram iOS
  • Twitter的iOS
  • Safari iOS
  • Firefox iOS & Android

深度链接

• 根据设备信息导航到其他位置

Content

• 处理内容属性

深景

• 启用/控制活动的Deepview 属性

• 控制被动式Deepview 模板

链接外观

• 自定义您的短链接的外观

打开图

• 处理Facebook属性

Twitter

• 处理Twitter属性

其他保留键

自定义标签

• 处理自定义元标记

• Valid dictionary example: "{"twitter:player:stream": "https://branch.io\"}". This will result in the following meta tag: <meta property="twitter:player:stream" content="https://branch.io" />
• 如果您通过仪表板创建链接，则不必担心将字典字符串化。它将自动完成。
• apple_touch_icon是词典中的特殊键。如果您进行了设置，我们将在抓取的HTML页面上添加一个<link rel="apple-touch-icon" href="<url>" /> 标签。这将允许您在iMessage，Safari书签，Slack等中显示用于预览的自定义图标。

通用物体

• 应用程序集成中分支通用对象的属性

BUO最佳做法

• 做
  • 跨应用实例将canonicalIdentifier 设置为唯一的重复数据消除值
  • 确保title ， contentDescription 和imageUrl 适当地表示对象
  • 初始化Branch通用对象，并在页面加载时使用VIEW_ITEM 事件调用logEvent
  • 当用户执行需要链接的操作时，请在生命周期的后期调用showShareSheet和createShortLink。
  • 当采取相应的用户操作时，调用其他对象事件（购买，共享完成等）
• 不要
  • 设置相同的title ， contentDescription 和imageUrl 在所有对象
  • 等待初始化对象并注册视图，直到用户共享
  • 等待初始化对象，直到方便地需要链接为止
  • 一次创建多个对象，并在for 循环中注册视图。

阅读深度链接接

• 深层链接数据从链接发送到应用程序集成

数据结构

• 示例深度链接接数据结构

{
          "identity_id": "427469360685348303",
          "link": "https://example.app.link?%24identity_id=427469360685348303",
          "session_id": "429691081177874743",
          "data": {
            "$canonical_identifier": "item/1503684554354.28",
            "$canonical_url": "https://example.com/home?utm_campaign=test&deeplink=value",
            "$desktop_url": "http://example.com/home",
            "$identity_id": "427469360685348303",
            "$og_description": "My Content Description",
            "$og_image_url": "http://lorempixel.com/200/200/",
            "$og_title": "46D6D28E-0390-40E4-A856-BD74F34D24C8",
            "$publicly_indexable": 1,
            "+click_timestamp": 1503684563,
            "+clicked_branch_link": true,
            "+is_first_session": false,
            "+match_guaranteed": true,
            "custom": "blue",
            "random": "FE848A5B-78F7-42EC-A253-9F795FE91692",
            "added": "1503684554354.33",
            "~campaign": "new launch",
            "~channel": "facebook",
            "~creation_source": 3,
            "~feature": "sharing",
            "~id": 429691043152332059,
            "~referring_link": "https://example.app.link/X7OsnWv9TF",
            "~stage": "new person",
            "~tags": [
              "one",
              "two"
            ]
          }
        }

回调值

• 其他属性从您的应用程序中的initSession 和网站集成中读取