딥링크 생성

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

Platform

iOS

Android

Facebook Newsfeed

폴백; Facebook 앱 링크를 통해 딥 링크 가능

Facebook Browser

Facebook Messenger

폴백; Facebook 앱 링크를 통해 딥 링크 가능

Facebook Messenger Browser

Instagram Profile

폴백; 다음을 사용하여 앱을 강제로 오픈할 수 있습니다. $uri_redirect_mode=2

Instagram Browser

Instagram Stories

폴백; 앱을 강제로 오픈할 수 있습니다.

Twitter Feed

폴백; 강제로 앱을 오픈할 수 있습니다. 리다이렉션 폴백 $ios_url or $fallback_url redirect fallbacks require web SDK 2.48.0+ init on the website

Twitter Browser

Snap Messages

Snap Stories

Fallback; review custom instructions for using Branch in Snap stories

Reddit

폴백; App Store로 폴백하려면 링크에서 $use_https_app_store: true in link to fallback to App Store

폴백

Pinterest

폴백

폴백

Pinterest Browser

Google+

폴백; 앱 스토어 리다이렉션이 작동하지 않습니다.

폴백

Chrome Browser

Chrome Address Bar

폴백

폴백; 딥링크(Deep Link) 데이터가 앱으로 전달되지 않습니다.

Safari Browser

해당 없음

Safari Address Bar

Fallback; Blocked by Apple

해당 없음

Firefox Browser

폴백

Firefox Address Bar

폴백

UC Browser

해당 없음

Naver Browser

해당 없음

Kakao Browser

해당 없음

Opera Browser

Ghostery Browser

폴백; 쿼리 string을 인코딩해야 합니다($ = %24).

Google Hangouts

폴백; 앱을 강제로 오픈할 수 있습니다.

Samsung SMS

해당 없음

Samsung SMS Browser

해당 없음

Apple iMessage

해당 없음

Apple Business Chat

해당 없음

Slack

앱; Safari로 링크를 오픈하려면 Slack을 구성해야 합니다.

WeChat

Fallback; customize WeChat fallback urls

Fallback; customize WeChat fallback urls

WhatsApp

앱; 클릭할 수 있기 위해 app.link require https/http to be clickable

앱; 클릭할 수 있기 위해 app.link require https/http to be clickable

LINE

폴백; 앱을 강제로 오픈할 수 있습니다.

Discord

Apple Mail

해당 없음

Gmail

Yahoo Mail

폴백; 앱을 강제로 오픈할 수 있습니다.

TikTok

앱을 홍보하는 광고가 유저를 앱 스토어로 안내합니다.

앱을 홍보하는 광고가 유저를 앱 스토어로 안내합니다.

TikTok

유저를 앱 스토어가 아닌 랜딩 페이지로 안내하는 광고가 인앱 브라우저에서 오픈됩니다.

유저를 앱 스토어가 아닌 랜딩 페이지로 안내하는 광고가 인앱 브라우저에서 오픈됩니다.

데스크탑

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

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

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

Platform

Mac

Windows

Safari

App; Supports Universal Linking

Firefox

앱*

앱*

Chrome

앱*

앱*

Edge

Internet Explorer

해당 없음

앱*

Slack

App; Supports Universal Linking

커스텀 링크 동작

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

  • 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

UTM 동작

❗️

기본적으로 활성화됨

이 기능을 비활성화하려면 Link Settings -> Advance Settings -> Analytics mapping with UTM으로 이동합니다.

995995
  • 웹 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

딥링크(Deep Link) 구성

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

예약된 접두사

  • Branch는 딥링크(Deep Link) 데이터에 추가 속성을 추가하여 링크를 설명합니다.
접두사Usage
$Branch 예약 키워드
~Branch 분석 데이터
+Branch 추가 값

Keys for Reporting Analytics

  • 이 레이블을 사용하면 딥링크(Deep Link)를 필터링하고 구성할 수 있습니다
기본값Usage
~channel or channel채널을 사용하여 링크가 유저에게 도달하는 경로를 태그합니다. 예를 들어 'Facebook' or 'LinkedIn' to help track clicks and installs through those paths separately
~feature or feature링크가 연결될 수 있는 앱의 기능입니다. 예를 들어 추천 프로그램을 구축한 경우 기능 '추천' 링크에 레이블을 지정합니다.
~campaign or campaign이 필드를 사용하여 실제 캠페인별로 링크를 구성하십시오. 예를 들어, 새로운 기능이나 제품을 출시했으며 그 주위에 캠페인을 진행하려는 경우
~campaign_id이 필드를 사용하여 실제 캠페인 ID별로 링크를 구성합니다. 예를 들어 새로운 기능이나 제품을 출시하고 이를 중심으로 캠페인을 운영하려는 경우
~customer_campaign라스트 어트리뷰션 터치에서 확인된 고객 캠페인입니다. 클라이언트가 링크에 지정할 수 있습니다.
~stage이를 사용하여 링크가 생성될 때 유저의 진행률 또는 범주를 분류하십시오. 예를 들어, 레벨 1, 레벨 3 및 5에서 초대 시스템에 액세스할 수 있는 경우 이 매개 변수를 사용하여 각 레벨에서 생성된 링크를 구별할 수 있습니다.
~tags or tags다음 무제한 값을 가진 자유 양식의 입력값입니다. ['string']. Use it to organize your link data with labels that don't fit within the bounds of the above
~secondary_publisher마지막으로 터치 한 것으로 지정된 보조 게시자. 광고 네트워크에 의해 전달됩니다.
~customer_secondary_publisher라스트 어트리뷰션 터치에서 확인된 하위 퍼블리셔의 ID입니다. 클라이언트가 링크에 지정할 수 있습니다.
~creative_name라스트 어트리뷰션 터치에서 확인된 크리에이티브 이름입니다.
~creative_id라스트 어트리뷰션 터치에서 확인된 크리에이티브 ID입니다.
~ad_set_name라스트 어트리뷰션 터치에서 확인된 광고 세트 이름입니다.
~ad_set_id라스트 어트리뷰션 터치에서 확인된 광고 세트 ID입니다.
~customer_ad_set_name라스트 어트리뷰션 터치에서 확인된 고객 광고 세트 이름입니다. 클라이언트가 링크에 지정할 수 있습니다.
~ad_name라스트 어트리뷰션 터치에서 확인된 광고 이름입니다.
~ad_id라스트 어트리뷰션 터치에서 확인된 광고 ID입니다.
~customer_ad_name라스트 어트리뷰션 터치에서 확인된 고객 광고 이름입니다. 클라이언트가 링크에 지정할 수 있습니다.
~keyword라스트 어트리뷰션 터치에서 확인된 키워드입니다.
~keyword_id마지막 터치의 키워드에 대한 고유 ID
~customer_keyword마지막 터치의 고객 키워드입니다. 클라이언트가 링크에 지정할 수 있습니다.
~placement분석 태그로 설정된 마지막 터치의 게재 위치입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다.
~placement_id분석 태그로 설정된 마지막 터치의 게재 위치 ID입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다.
~customer_placement분석 태그로 설정된 마지막 터치의 고객 지정 게재 위치입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다. 클라이언트가 링크에 지정할 수 있습니다.
~sub_site_name광고가 표시된 사이트에 대한 참조입니다.
~customer_sub_site_name광고가 표시된 사이트에 대한 고객 참조. 클라이언트가 링크에 지정할 수 있습니다.
  • 이 레이블을 사용하면 단일 링크에 대한 어트리뷰션 윈도우를 유저 정의할 수 있습니다
기본값Usage
$click_install_window_days7Time between a click and an install or reinstall. (i.e., https://branchster.app.link/hpNVE52gxE?$click_install_window_days=3)
$click_session_start_window_days1Time between a click and an open or web session start. (i.e., https://branchster.app.link/hpNVE52gxE?$click_session_start_window_days=7)
$click_conversion_window_days30Time between a click and a conversion event. Conversion events include commerce events (e.g. purchase, add to cart), all custom events, and all view events like pageviews & content views. (i.e., https://branchster.app.link/hpNVE52gxE?$click_session_start_window_days=30)
$impression_install_window_days1Time between an ad impression and an install or reinstall. (i.e., https://branchster.app.link/hpNVE52gxE?$impression_install_window_days=3)
$impression_session_start_window_days1Time between an ad impression and an open or web session start. (i.e., https://branchster.app.link/hpNVE52gxE?$impression_session_start_window_days=1)
$impression_conversion_window_days7Time between an ad impression and a conversion event. Conversion events include commerce events (e.g. purchase, add to cart), all custom events, and all view events like pageviews & content views. (i.e., https://branchster.app.link/hpNVE52gxE?$impression_session_start_window_days=7)

맞춤형 데이터

  • 앱 내에서 읽을 맞춤형 데이터 전달
Usage
random123모든 key-value pair
custom_datatrue모든 key-value pair
any_value{ 'random': 'dictionary' }모든 key-value pair
look_at[1,2,3,4,5,6]모든 key-value pair
nav_herecontent/123모든 key-value pair

리다이렉션

  • 디바이스 정보에 따라 다른 위치로 이동
  • 탐색 URL은 딥링크(Deep Link)가 아닌 웹사이트 여야합니다
기본값Usage
$fallback_url모든 플랫폼에 대한 리다이렉션 엔드 포인트를 변경하므로 플랫폼을 통해 활성화할 필요는 없습니다. Branch는 모든 로봇을 이 URL로 전달하며, 이는 링크에 입력된 모든 OG 태그보다 우선합니다. 시스템 전체 기본 URL (링크 설정에서 설정)
$fallback_url_xxChange the redirect endpoint for all platforms based on a lower-case Alpha-2 country code. For example, $fallback_url_de="..." would redirect Germany deep link clicks. You should also set $fallback_url to act as the global redirect in addition to the country-specific ones. WARNING: platform specific redirects (like $ios_url or $desktop_url) are set, they will override the country-specific redirect. Thus, the recommendation is to only use $fallback_url_xx for the country specific redirects and $fallback_url to catch all other users.
$desktop_urlRedirect URL for desktop devices - mobile users will default to the app store.
$ios_url앱의 iOS App Store 페이지에 대한 리다이렉션 엔드포인트 변경 (링크 설정에서 설정)
$ios_url_xxChange the redirect endpoint for iOS based on a lower-case Alpha-2 country code. For example, $ios_url_de="..." would redirect Germany deep link clicks. You should also set $ios_url to act as the global redirect in addition to the country-specific ones.
$ipad_urliPad에 대한 리다이렉션 엔드포인트를 변경합니다. $ios_url value
$android_url앱의 Android Play 스토어 페이지에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정)
$android_url_xxChange the redirect endpoint for Android based on a lower-case Alpha-2 country code. For example, $android_url_de="..." would redirect Germany deep link clicks. You should also set $android_url to act as the global redirect in addition to the country-specific ones.
$samsung_urlSamsung 디바이스에서 Samsung Galaxy Store로 리다이렉션합니다. 링크 레벨 제어 전용입니다. 형식은 다음과 같습니다. http://www.samsungapps.com/appquery/appDetail.as?appId=YOUR.PACKAGE.NAME
$huawei_urlRedirect to the Huawei App Gallery on Huawei devices. Only link level control. Format should be https://appgallery.huawei.com/app/<<HUAWEI_APP_GALLERY_ID>>
$windows_phone_urlWindows OS Windows Phone 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정)
$blackberry_urlBlackberry OS BlackBerry 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정)
$fire_urlAmazon Fire OS Fire 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정)
$ios_wechat_urlChange the redirect endpoint for WeChat on iOS devices $ios_url value
$android_wechat_urlAndroid 디바이스에서 WeChat에 대한 리다이렉션 엔드포인트를 변경합니다. $android_url value
$web_onlyfalse앱 대신 $fallback_url instead of the app
$desktop_web_onlyfalse앱 대신 $windows_desktop_url, $mac_desktop_url, $desktop_url, or $fallback_url in this order of precedence instead of the app
$mobile_web_onlyfalse앱 대신$ios_url, $android_url, or $fallback_url in this order of precedence instead of the app
$after_click_urlfalseWhen a user returns to the browser after going to the app, take them to this URL. iOS only; Android coming soon
$afterclick_desktop_urlfalseWhen a user on desktop returns to the desktop browser after going to the desktop app, take them to this URL.

강제 리다이렉션

  • Branch 딥링크(Deep Link)를 클릭할 때 다른 앱의 오류 메시지 방지
Usage
$uri_redirect_mode0이것은 유저에게 오류가 발생했을 때 앱을 오픈하려 하지 않는 표준 동작을 발생시키는 기본값입니다.
$uri_redirect_mode1스마트 리다이렉션 모드. 유저가 Branch 페르소나 데이터를 통해 앱을 설치했음을 알 때까지 0과 동일한 동작입니다. 이 경우 URI 스킴이 앱을 열도록합니다.
$uri_redirect_mode2Forceful redirect mode. Always try to force open the app, even if it risks showing an error message when the app is not installed.
  • OS 레벨 리다이렉션 모드는 $ios_uri_redirect_mode$android_uri_redirect_mode 파라미터를 사용하여 활성화할 수 있습니다.

  • 지원되는 앱

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

딥링킹

  • 디바이스 정보에 따라 다른 위치로 이동
기본값Usage
$deeplink_pathopen?link_click_id=1234모든 플랫폼의 딥링크(Deep Link) 경로를 설정하므로 플랫폼을 통해 활성화할 필요는 없습니다. Branch SDK는 이 매개 변수 집합이 포함된 링크를 받으면 포함된 유저 지정 URI 경로를 자동으로 로드합니다.
$android_deeplink_pathAndroid 앱의 딥링크(Deep Link) 경로를 설정합니다. Branch SDK가 이 파라미터가 설정된 링크를 받으면 자동으로 포함된 맞춤형 Android URI 경로를 로드합니다.
$ios_deeplink_pathiOS 앱의 딥링크(Deep Link) 경로를 설정합니다. Branch SDK가 이 파라미터가 설정된 링크를 받으면 자동으로 포함된 맞춤형 iOS URI 경로를 로드합니다.
$ios_nativelinkSet to true to make the link route to a NativeLink™ used for enabling deferred deep linking on iOS 15+ & Private Relay. Can also be set to a deepview/template key to manually trigger the launch of a specific NativeLink™ deepview.
$desktop_deeplink_path데스크톱 앱의 딥링크(Deep Link) 경로를 설정하십시오. 이 매개 변수를 가져와 유저를 적절히 라우팅해야합니다.
$match_duration7200어트리뷰션 윈도우라고도 하는 스냅샷 매칭 타임아웃(앱이 매칭하도록 오픈될 때까지 클릭이 기다리는 시간)을 제어할 수 있습니다. 초 단위로 지정됩니다.
$link_exp_dateExpiry date for the content and any associated link data. Represented as UTC epoch millisecond. The maximum date this can be set is 31 days in the future.
$always_deeplinktrue링크가 항상 모바일 사이트로 폴백하도록 false to make links always fall back to your mobile site. Does not apply to Universal Links or Android App Links.
$ios_redirect_timeout750앱 스토어로 리다이렉션하기 전에 앱을 오픈하려고 시도한 후 클라이언트 측 JS가 기다리는 타임아웃을 제어합니다. 밀리초 단위로 지정됩니다.
$android_redirect_timeout750Play 스토어로 리다이렉션하기 전에 앱을 오픈하려고 시도한 후 클라이언트 측 JS가 기다리는 타임아웃을 제어합니다. 밀리초 단위로 지정됩니다.
$custom_sms_text데스크톱 클릭을 위해 이 링크로 전송되는 문자 메시지 링크 텍스트입니다. 설정에 Text Me The App 페이지의 {{ link }} Value of Text me the app page in Settings
$marketing_title딥링크(Deep Link)의 마케팅 제목을 설정하십시오.
$deeplink_no_attribution링크가 항상 모바일 사이트로 폴백하도록 true for the links to only support deep linking without any attribution for that link.

콘텐츠

  • 콘텐츠 속성 처리
기본값Usage
$publicly_indexable1여기서 수정할 수 없습니다. Branch Universal Object에서 설정해야 합니다.
~keyword이 콘텐츠를 검색할 키워드입니다. 사용하려는 키워드로 string 배열을 지정하십시오.
$canonical_identifier이는 Branch가 동일한 항목의 여러 인스턴스에서 중복을 제거하는 데 도움이 되는 콘텐츠의 고유 식별자입니다. 적합한 옵션: 경로가 있는 웹사이트 또는 엔티티에 대한 식별자가 있는 데이터베이스
$content_type존재하는 콘텐츠 유형에 대한 레이블입니다. Apple은 여기에 설명된 대로 균일한 유형의 식별자를 사용할 것을 권장합니다.
$do_not_processfalse이렇게 하면 클릭 트래킹 및 링크 분석 저장이 방지됩니다. 딥링크(Deep Link) 데이터는 링크 클릭에서 앱 오픈까지 계속해서 앱으로 유입됩니다.

Deepview

기본값Usage
$ios_deepviewbranch_defaultiOS에 사용할 deepview 템플릿의 이름
$android_deepviewbranch_defaultAndroid에 사용할 deepview 템플릿의 이름
$desktop_deepviewbranch_default데스크톱에 사용할 deepview 템플릿의 이름
기본값
$ios_passive_deepviewiOS에 사용할 템플릿의 이름branch_default
$android_passive_deepviewAndroid에 사용할 템플릿의 이름branch_default
$desktop_passive_deepviewThe name of the template to use for Desktop.branch_default

링크 모양

  • 짧은 링크의 외관을 유저 정의하십시오
기본값Usage
alias없음표준 인코딩된 단문 URL을 대체할 링크 별칭(Alias)을 지정합니다(예: https://example.app.link/aQXXDHaxKF > https://example.app.link/october-campaign or https://example.app.link/product/id1234). Link aliases must be unique per app (a 409 error will occur if you create an alias already taken). Also note that we don't currently support single character path segments after the domain (/a/, /b/, /c/, etc).

오픈 그래프

  • Facebook 속성 처리
기본값Usage
$og_title대시보드에 설정소셜 미디어 디스플레이에 표시될 링크 제목을 설정합니다.
$og_description대시보드에 설정소셜 미디어 디스플레이에 표시될 링크 설명을 설정하십시오.
$og_image_url대시보드에 설정소셜 미디어 디스플레이에 표시될 링크 이미지를 설정하십시오.
$og_image_width소셜 미디어 디스플레이를 위해 이미지 너비를 픽셀 단위로 설정합니다.
$og_image_height소셜 미디어 디스플레이를 위해 이미지 높이를 픽셀 단위로 설정합니다.
$og_video소셜 미디어 디스플레이에 표시될 동영상을 설정합니다.
$og_url소셜 미디어 디스플레이에 표시될 링크의 기본 URL을 설정하십시오.
$og_type소셜 미디어 디스플레이에 표시될 유저 정의 카드 형식 링크 유형을 설정합니다. Facebook에 딥링크(Deep Link)를 공유할 때는 이 속성을 설정하지 마세요.
$og_redirect(고급, 권장되지 않음) 적절한 태그를 모두 검색하기 위해 소셜 미디어 로봇을 리다이렉션할 맞춤형 URL을 설정합니다.
$og_app_id대시보드에 설정(거의 사용되지 않음) 앱 ID 태그를 설정합니다.

Twitter

  • Twitter 속성 처리
기본값Usage
$twitter_card링크의 Twitter 카드 유형을 설정합니다.(예: player) (you must whitelist your deep link with the Twitter Card Validator
$twitter_title대시보드에 설정Twitter 카드의 제목 설정
$twitter_description대시보드에 설정Twitter 카드에 대한 설명 설정
$twitter_image_url대시보드에 설정Twitter 카드의 이미지 URL 설정
$twitter_siteTwitter에 대한 사이트 설정
$twitter_app_country앱 카드의 앱 국가 설정
$twitter_player동영상 플레이어의 URL을 설정합니다. 기본값은 다음과 같습니다. $og_video.
$twitter_player_width플레이어의 너비를 픽셀 단위로 설정
$twitter_player_height플레이어의 높이를 픽셀 단위로 설정

기타 예약된 키

Usage
access_token or AccessTokenBranch에서 딥링크(Deep Link)가 유효한 Branch 링크인지 여부를 확인하는 데 사용됩니다.
auth_tokenor AuthTokenBranch에서 딥링크(Deep Link)가 유효한 Branch 링크인지 여부를 확인하는 데 사용됩니다.
data최상위 링크 정보를 포함하기 위해 Branch에서 사용합니다. 이 매개 변수가 쿼리 매개 변수를 추가하여 Branch 링크에 추가되면 삭제됩니다. 대시 보드를 통해 수동으로 링크를 만들 때 안전하게 사용할 수 있습니다.
passwordIf this parameter is added to a Branch link via appending query params, it will be dropped
authIf this parameter is added to a Branch link via appending query params, it will be dropped.

커스텀 태그

  • 커스텀 메타 태그 처리
$custom_meta_tags태그 키 및 값의 유효한 문자열화된 JSON 사전
  • 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에 대한 속성
기본값Usage링크 속성
canonicalIdentifier(필수) 이는 Branch가 동일한 항목의 여러 인스턴스에서 중복을 제거하는 데 도움이 되는 콘텐츠의 고유 식별자입니다. 적합한 옵션: 경로가 있는 웹사이트 또는 엔티티에 대한 식별자가 있는 데이터베이스$canonical_identifier
canonicalUrlSEO 목적으로 사용되는 표준 URL$canonical_url
title콘텐츠의 이름$og_title
contentDescription콘텐츠에 대한 설명$og_description
contentImageUrl콘텐츠의 이미지 URL입니다. 절대 경로여야 합니다.$og_image_url
price항목의 가격$amount
currencyISO 4217 통화 코드로 가격을 나타내는 통화$currency
contentIndexingMode"public"다음 값 중 하나로 설정할 수 있습니다. "public" or "private". Public indicates that you'd like this content to be discovered by other apps.$publicly_indexable
contentMetadata모든 맞춤형 key-value 데이터(예: { "custom": "data" }

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

Usage

~id

설치/열기를 유도한 Branch 링크에 대해 자동으로 생성된 18자리 ID 번호 (동적 및 3P 링크의 경우 0)

~referring_link

설치/열기를 유도한 리퍼링(Referring) 링크 (있는 경우)

~creation_source

링크가 생성된 위치(0 API
, 1 Quick Link, 2 SDK, 3 iOS SDK
, 4 Android SDK
, 5 Web SDK, 6 Dynamic, 7 Third party)

+match_guaranteed

100 % 정확도로 일치 한 경우

+referrer

링크를 클릭한 경우 링크 클릭에 대한 리퍼러(Referrer)

+is_first_session

true if first session (install), false if any other session (open) or if it did not previously exist in the Branch Link Graph.

기본값은 false.

+clicked_branch_link

유저가 이 세션을 트리거한 Branch 링크를 클릭했는지 여부를 나타냅니다.

기본값은 false.

+non_branch_link

Branch 링크가 아닌 경우 앱이 오픈되었습니다(써드파티, 유효하지 않은 Branch 딥링크(Deep Link) 또는 Branch 키 불일치).


What’s Next