딥링크 생성

Overview

Journeys(웹-투-앱 스마트배너), Universal Ads(광고 어트리뷰션), Quick Link 및 Universal Email(이메일-투-앱)에서 딥링크(Deep Link)를 사용할 수 있습니다. 이 가이드에서는 기본 및 맞춤형 링크 동작을 구성하는 방법과 숏링크 및 롱링크를 만드는 방법을 안내합니다.

기본 링크 동작

앱이 설치되지 않은 경우

• 유저 clicks on a Branch deep link

• 디바이스 navigates to the fallback (e.g. an app store or website)

  • 지원되는 앱 스토어:
    • 애플 앱 스토어
    • 구글 플레이
    • Huawei 앱 스토어
    • Vivo 앱 스토어
    • Oppo 앱 스토어
    • Baidu Mobile Assistant

• 유저 installs and opens your app

• Branch가 앱으로 딥링크(Deep Link) data into your app

앱이 설치된 경우

• 유저 clicks on a Branch deep link

• 디바이스 opens your app or navigates to expected link behavior

• Branch가 앱으로 딥링크(Deep Link) data into your app

예상 링크 동작

Mobile

• 예상 링크 동작은 앱이 딥링크를 지원하는지 여부에 따라 달라집니다.

• *Able to force app open 사용 $uri_redirect_mode or enabling a Deepview

데스크탑

• 예상 링크 동작은 앱이 딥링크를 지원하는지 여부에 따라 달라집니다.

• 기본적으로 URI scheme을 통해 앱을 실행하고 백그라운드에서 데스크탑으로 리다이렉션하는 폴백을 불러옵니다.

• *Only launches background desktop web fallbacks 사용 $afterclick_desktop_url

커스텀 링크 동작

링크에서 앱으로 데이터 전달

• Add link data to each deep link

• Quick Link에 키 및 해당 값 추가

• 쿼리 문자열 추가 https://example.app.link/fzmLEhobLD?$custom_data=123&hello=world

특정 URL로 폴백

• 딥링크(Deep Link)가 어디로 이동하는지 결정

  • 앱이 설치되지 않은 경우

  • [또는] 다른 앱은 링크가 앱 외부에서 딥 링크되지 않도록합니다.

• 폴백 재정의 (우선 순위 순)

  • 쿼리 문자열 추가 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
  • 안드로이드 : 은 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
  • Custom Alias와 함께 사용하면 커스텀 링크 도메인에서 작동하지 않습니다.

소셜 링크 행동

• 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으로 이동합니다.

• 웹 URL로 리디렉션하면 Branch는 다음 Branch 링크 분석 태그의 값을 UTM 파라미터로 자동으로 전달합니다.
  • ~campaign -> utm_campaign
  • ~channel -> utm_source
  • ~feature -> utm_medium
• 이는 다음 $fallback_url , $ios_url , $android_url , $desktop_url , $original_url 및 $canonical_url 중 하나를 사용하여 정의된 웹 URL에 적용됩니다.
• 리디렉션되는 URL에서 이러한 UTM 매개 변수가 이미 검색된 경우 Branch는 이를 덮어 쓰지 않습니다.
• For more information about UTM parameters, please read Google Analytic's Custom Campaigns article.

딥링크(Deep Link) 만들기

짧은 링크(Short Links)

• 짧은 링크는 가장 일반적인 딥링크(Deep Link)입니다
• 링크 example.app.link, or change to your own personal domain (links.yoursite.com)
• 생성하는 중에 단문 코드의 모양을 맞춤 설정된 alias during creation
  • 별칭은 짧은 문자열 일 수 있습니다. 예 : 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 Link 생성 및 쉬운 추적을 위해 Quick Link 사용
  • 앱 SDK를 사용하여 앱 내에서 링크 생성 및 공유
  • Web SDK를 사용하여 웹 유저를 앱 유저로 전환하는 데 도움이 되는 링크를 만듭니다.
  • HTTP API를 사용하여 서버에서 프로그래밍 방식으로 링크를 만듭니다.
  • Use our Chrome Extension to generate links from your browser

긴 링크(Long Links)

• 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

딥링크(Deep Link) 구성

Branch 링크에 자체적인 key-value 파라미터를 자유롭게 추가할 수 있습니다. 이러한 파라미터는 Branch SDK를 통해 앱에 전달되지만 일부 키에는 특정 추가 효과가 있습니다.

예약된 접두사

• Branch는 딥링크(Deep Link) 데이터에 추가 속성을 추가하여 링크를 설명합니다.

Keys for Reporting Analytics

• 이 레이블을 사용하면 딥링크(Deep Link)를 필터링하고 구성할 수 있습니다

• 이 레이블을 사용하면 단일 링크에 대한 어트리뷰션 윈도우를 유저 정의할 수 있습니다

맞춤형 데이터

• 앱 내에서 읽을 맞춤형 데이터 전달

리다이렉션

• 디바이스 정보에 따라 다른 위치로 이동
• 탐색 URL은 딥링크(Deep Link)가 아닌 웹사이트 여야합니다

강제 리다이렉션

• Branch 딥링크(Deep Link)를 클릭할 때 다른 앱의 오류 메시지 방지

• OS 레벨 리다이렉션 모드는 $ios_uri_redirect_mode 및 $android_uri_redirect_mode 파라미터를 사용하여 활성화할 수 있습니다.

• 지원되는 앱

  • Facebook 뉴스피드 iOS
  • Instagram iOS
  • Twitter iOS
  • Safari iOS
  • Firefox iOS 및 Android

딥링킹

• 디바이스 정보에 따라 다른 위치로 이동

콘텐츠

• 콘텐츠 속성 처리

Deepview

• Enable / control active deepview properties

• Control passive deepview templates

링크 모양

• 짧은 링크의 외관을 유저 정의하십시오

오픈 그래프

• 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은 사전의 특수 키입니다. 이를 설정 <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
  • 페이지 로드의 VIEW_ITEM event on page load
  • 유저가 링크가 필요한 작업을 수행할 때 수명주기 후반에 showShareSheet 및 createShortLink를 호출하십시오.
  • 해당 유저 조치가 수행 될 때 추가 오브젝트 이벤트 (구매, 공유 완료 등)를 호출하십시오.
• 금지 사항
  • 모든 객체에 동일한 title, contentDescription and imageUrl across all objects
  • 유저가 공유할 때까지 객체 초기화 및 뷰 등록을 기다립니다.
  • 편리하게 링크가 필요할 때까지 객체를 초기화하십시오.
  • 한 번에 여러 객체를 만들고 for loop.

딥링크(Deep Link) 읽기

• 딥링크(Deep Link) 데이터는 링크에서 앱 통합으로 전송됩니다.

데이터 구조

• 딥링크(Deep Link) 데이터 구조 예

{
          "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