概述

您可以在 Journey (站到端引流)，Universal Ads（全域广告归因）链接，Quick Links（快速链接)和 Universal Email中使用深度链接。在本指南中，我们将帮助您逐步了解如何设置默认和自定义链接行为，以及如何创建短链接和长链接。

默认链接行为

您尚未安装应用

• 用户 clicks on a Branch deep link

• 设备 navigates to the fallback (e.g. an app store or website)

  • 支持的 App Stores：
    • 苹果应用商店
    • Google Play
    • 华为 App Store
    • Vivo App Store
    • Oppo App Store
    • 百度移动助手

• 用户 installs and opens your app

• Branch 传递深度链接 data into your app

已安装您的应用

• 用户 clicks on a Branch deep link

• 设备 opens your app or navigates to expected link behavior

• Branch 传递深度链接 data into your app

预期的链接行为

移动

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

• *Able to force app open 使用 $uri_redirect_mode or enabling a Deepview

桌面

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

• 默认情况下，我们尝试通过 URI 方案启动应用，并在后台加载桌面重新定向后备

• *Only launches background desktop web fallbacks 使用 $afterclick_desktop_url

自定义链接行为

将数据从链接传递到应用

• Add link data to each deep link

• 将 key-values 对组添加到您的 Quick Links（快速链接)上

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

返回到特定网址

• 根据以下情况确定深度链接将前往的位置

  • 您尚未安装应用

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

• Fallback 将取代（按优先级排序）

  • 添加请求参数（Query String） https://example.app.link?$ios_url=https://example.com
  • Add link data $ios_url = 'https://example.com' (docs)
  • Add link data for a deep view $ios_deepview = 'deepviewId' (docs)
  • 在Branch Dashboard上全面启用Deep View
  • Add link data $fallback_url = 'https://example.com' (docs)
  • 在Branch Dashboard上添加iOS/Android Custom URL
  • 在Branch Dashboard上添加Default URL ($fallback_url)

打开网页不是应用

• 您尚未安装应用
  • 设备 navigates to the fallback (e.g. an app store or website)
• 已安装您的应用
  • iOS: 需要取代Universal Links
    • Add $web_only = true (docs)
    • Add redirect $ios_url = 'https://google.com' (docs)
    • [或] 将/e/附加到深度链接上
      • 例如，https://example.app.link/fzmLEhobLD > https://example.app.link/e/fzmLEhobLD
  • Android：需要取代App Links
    • Uncheck Enable App Links and then hit Save on the Branch Dashboard
    • Add redirect $android_url = 'https://google.com' (docs)
    • Add a broken URI Scheme with $android_deeplink_path = 'random' (docs)
• 添加 -web in the link domain: e.g. branch.app.link > branch-web.app.link
  • 与自定义别名一起使用时，不适用于自定义链接域。

社交链接行为

• Use OG Tags to display content as a preview card in Facebook, Twitter, Pinterest, iMessage, etc.
  • 基本项为$og_title, $og_description以及$og_image_url
• Use Deep Views to display content as a website
  • 增加 install attribution
  • Completes deep linking experience in certain apps

UTM 行为

❗️

默认启用

要取消此功能，请前往 Link Settings -> Advance Settings -> Analytics mapping with UTM。

• 重定向到网页网址时，Branch 会自动将链接分析标记中的值作为 UTM 参数进行传递：
  • ~campaign -> utm_campaign
  • ~channel -> utm_source
  • ~feature -> utm_medium
• 这一点适用于通过以下几点定义网页网址$fallback_url， $ios_url， $android_url， $desktop_url， $original_url，和$canonical_url。
• 如果在重定向到的 URL 上已经检测到这些 UTM 参数，这些 URL 则不会被取代。
• For more information about UTM parameters, please read Google Analytic's Custom Campaigns article.

创建深度链接接

短链接

• 短链接是最常见的深度链接接
• 您可以自定义以下子域 example.app.link, or change to your own personal domain (links.yoursite.com）
• 您可以根据需要自定义短代码 alias during creation
  • 别名（Aliases）可以是短字符，例如 https://example.app.link/october-sale
  • 或者可以是完整的链接路径，例如 https://example.app.link/product/id1234
• Short links encapsulate link data inside them on link creation
  • 例如现有链接 https://example.app.link/fzmLEhobLD
• 短链接可以附加其他数据
  • 例如动态链接 https://example.app.link/fzmLEhobLD?content_id=123
• 创建短链接的方法
  • 使用 Quick Links（快速链接)进行快速创建并轻松追踪链接
  • 使用我们的 App SDK 在您的应用内创建和分享链接
  • 使用我们的 Web SDK 来创建有助于将您的网页用户转化为应用用户的链接
  • 使用我们的 HTTP API 从您的服务器通过编程方式创建链接
  • Use our Chrome Extension to generate links from your browser

长链接

• 无需网络调用 Branch 服务即可创建长链接
• Long links need link data to be added as a query string. Be sure to URI encode any urls in the link.
  • 例如现有链接 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
• Long links need a /a/ and a Branch Key if you use 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
• Long links need a /a/ and a Branch Key if you use 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 to a dynamic link, enter each tag separately
  • e.g. https://example.app.link/?foo=bar&~tags=tag1&~tags=tag2

设置深度链接

您可以选择将您的 key-value 参数添加到 Branch Link 上。Branch SDK 会将这些参数传递到您的应用（部分 key 存在特殊情况）。

保留的前缀

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

分析标签

• 您可以通过这些标签对深度链接进行筛选和分組

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

自订数据

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

重新导向

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

强制重定向

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

• 可以通过使用参数$ios_uri_redirect_mode和$android_uri_redirect_mode来启用 OS 级重定向模式。

• 支持的应用

  • Facebook Newsfeed iOS
  • Instagram iOS
  • Twitter iOS
  • Safari iOS
  • Firefox iOS & Android

深度链接

• 根据设备信息前往其他位置

Content

• 处理内容属性

Deepview

• Enable / control active deepview properties

• Control passive deepview templates

链接外观

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

Open Graph

• 处理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 是词典中的特殊 key。如果您对此做出了设置，我们将添加 <link rel="apple-touch-icon" href="<url>" /> tag to the scraped HTML page. This will allow you to show a custom icon for previews in iMessage, Safari Bookmarks, Slack, etc.

Universal Object

• 应用集成中的 Branch Universal Object

BUO最佳实践

• 要
  • 将 canonicalIdentifier to a unique, de-duped value across instances of the app
  • 请确保 title， contentDescription and imageUrl properly represent the object
  • 初始化 Branch Universal Object，并使用 logEvent 调用 VIEW_ITEM event on page load
  • 当用户执行需要链接的操作时，请在生命周期的后期调用showShareSheet和createShortLink。
  • 当采取相应的用户操作时，调用其他对象事件（购买，分享完成等）
• 不要
  • 设置相同 title， contentDescription and imageUrl across all objects
  • 等待初始化对象并注册视图，直到用户分享
  • 等待初始化对象，直到方便地需要链接为止
  • 一次创建多个对象并在一个画面中显示视图 for loop.

阅读深度链接接

• 深度链接数据从链接发送到应用集成

数据结构

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

{
          "randomized_bundle_token": "427469360685348303",
          "link": "https://example.app.link?%24randomized_bundle_token=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",
            "$randomized_bundle_token": "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"
            ]
          }
        }

回调值

• Additional properties read from the initSession within your app and website integrations