딥링크 생성
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
andopens
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 | 폴백; 다음을 사용하여 앱을 강제로 오픈할 수 있습니다. | 앱 |
Instagram Browser | 앱 | 앱 |
Instagram Stories | 폴백; 앱을 강제로 오픈할 수 있습니다. | 앱 |
Twitter Feed | 폴백; 강제로 앱을 오픈할 수 있습니다. 리다이렉션 폴백 | 앱 |
Twitter Browser | 앱 | 앱 |
Snap Messages | 앱 | 앱 |
Snap Stories | Fallback; review custom instructions for using Branch in Snap stories | 앱 |
폴백; App Store로 폴백하려면 링크에서 | 폴백 | |
폴백 | 폴백 | |
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을 구성해야 합니다. | 앱 |
Fallback; customize WeChat fallback urls | Fallback; customize WeChat fallback urls | |
앱; 클릭할 수 있기 위해 | 앱; 클릭할 수 있기 위해 | |
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
를 재정의해야합니다. - 안드로이드 : 은
App Links
를 재정의해야합니다.- Uncheck
Enable App Links
and then hitSave
on the Branch Dashboard - Add redirect
$android_url = 'https://google.com'
(docs) - Add a broken URI Scheme with
$android_deeplink_path = 'random'
(docs)
- Uncheck
- iOS : 은
- 더하다
-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 acustom 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 abnc.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_days | 7 | Time between a click and an install or reinstall. (i.e., https://branchster.app.link/hpNVE52gxE?$click_install_window_days=3) |
$click_session_start_window_days | 1 | Time 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_days | 30 | Time 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_days | 1 | Time 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_days | 1 | Time 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_days | 7 | Time 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 |
---|---|---|
random | 123 | 모든 key-value pair |
custom_data | true | 모든 key-value pair |
any_value | { 'random': 'dictionary' } | 모든 key-value pair |
look_at | [1,2,3,4,5,6] | 모든 key-value pair |
nav_here | content/123 | 모든 key-value pair |
리다이렉션
- 디바이스 정보에 따라 다른 위치로 이동
- 탐색 URL은 딥링크(Deep Link)가 아닌 웹사이트 여야합니다
키 | 기본값 | Usage |
---|---|---|
$fallback_url | 모든 플랫폼에 대한 리다이렉션 엔드 포인트를 변경하므로 플랫폼을 통해 활성화할 필요는 없습니다. Branch는 모든 로봇을 이 URL로 전달하며, 이는 링크에 입력된 모든 OG 태그보다 우선합니다. 시스템 전체 기본 URL (링크 설정에서 설정) | |
$fallback_url_xx | Change 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_url | Redirect URL for desktop devices - mobile users will default to the app store. | |
$ios_url | 앱의 iOS App Store 페이지에 대한 리다이렉션 엔드포인트 변경 (링크 설정에서 설정) | |
$ios_url_xx | Change 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_url | iPad에 대한 리다이렉션 엔드포인트를 변경합니다. $ios_url value | |
$android_url | 앱의 Android Play 스토어 페이지에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정) | |
$android_url_xx | Change 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_url | Samsung 디바이스에서 Samsung Galaxy Store로 리다이렉션합니다. 링크 레벨 제어 전용입니다. 형식은 다음과 같습니다. http://www.samsungapps.com/appquery/appDetail.as?appId=YOUR.PACKAGE.NAME | |
$huawei_url | Redirect 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_url | Windows OS Windows Phone 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정) | |
$blackberry_url | Blackberry OS BlackBerry 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정) | |
$fire_url | Amazon Fire OS Fire 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정) | |
$ios_wechat_url | Change the redirect endpoint for WeChat on iOS devices $ios_url value | |
$android_wechat_url | Android 디바이스에서 WeChat에 대한 리다이렉션 엔드포인트를 변경합니다. $android_url value | |
$web_only | false | 앱 대신 $fallback_url instead of the app |
$desktop_web_only | false | 앱 대신 $windows_desktop_url , $mac_desktop_url , $desktop_url , or $fallback_url in this order of precedence instead of the app |
$mobile_web_only | false | 앱 대신$ios_url , $android_url , or $fallback_url in this order of precedence instead of the app |
$after_click_url | false | When a user returns to the browser after going to the app, take them to this URL. iOS only; Android coming soon |
$afterclick_desktop_url | false | When 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_mode | 0 | Conservative mode. We don't try to open the app if the user can see an error. |
$uri_redirect_mode | 1 | Smart redirect mode. This is the default value that yields the same behavior as 0 until we know the user has the app installed through Branch persona data. In that case, force URI schemes to open the app. |
$uri_redirect_mode | 2 | Forceful 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_path | open?link_click_id=1234 | 모든 플랫폼의 딥링크(Deep Link) 경로를 설정하므로 플랫폼을 통해 활성화할 필요는 없습니다. Branch SDK는 이 매개 변수 집합이 포함된 링크를 받으면 포함된 유저 지정 URI 경로를 자동으로 로드합니다. |
$android_deeplink_path | Android 앱의 딥링크(Deep Link) 경로를 설정합니다. Branch SDK가 이 파라미터가 설정된 링크를 받으면 자동으로 포함된 맞춤형 Android URI 경로를 로드합니다. | |
$ios_deeplink_path | iOS 앱의 딥링크(Deep Link) 경로를 설정합니다. Branch SDK가 이 파라미터가 설정된 링크를 받으면 자동으로 포함된 맞춤형 iOS URI 경로를 로드합니다. | |
$ios_nativelink | Set 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_duration | 7200 | 어트리뷰션 윈도우라고도 하는 스냅샷 매칭 타임아웃(앱이 매칭하도록 오픈될 때까지 클릭이 기다리는 시간)을 제어할 수 있습니다. 초 단위로 지정됩니다. |
$exp_date | Expiry date for the content and any associated link data. Represented as UTC epoch milli second. The maximum date this can be set is 31 days in the future. | |
$always_deeplink | true | 링크가 항상 모바일 사이트로 폴백하도록 false to make links always fall back to your mobile site. Does not apply to Universal Links or Android App Links. |
$ios_redirect_timeout | 750 | 앱 스토어로 리다이렉션하기 전에 앱을 오픈하려고 시도한 후 클라이언트 측 JS가 기다리는 타임아웃을 제어합니다. 밀리초 단위로 지정됩니다. |
$android_redirect_timeout | 750 | Play 스토어로 리다이렉션하기 전에 앱을 오픈하려고 시도한 후 클라이언트 측 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_indexable | 1 | 여기서 수정할 수 없습니다. Branch Universal Object에서 설정해야 합니다. |
~keyword | 이 콘텐츠를 검색할 키워드입니다. 사용하려는 키워드로 string 배열을 지정하십시오. | |
$canonical_identifier | 이는 Branch가 동일한 항목의 여러 인스턴스에서 중복을 제거하는 데 도움이 되는 콘텐츠의 고유 식별자입니다. 적합한 옵션: 경로가 있는 웹사이트 또는 엔티티에 대한 식별자가 있는 데이터베이스 | |
$content_type | 존재하는 콘텐츠 유형에 대한 레이블입니다. Apple은 여기에 설명된 대로 균일한 유형의 식별자를 사용할 것을 권장합니다. | |
$do_not_process | false | 이렇게 하면 클릭 트래킹 및 링크 분석 저장이 방지됩니다. 딥링크(Deep Link) 데이터는 링크 클릭에서 앱 오픈까지 계속해서 앱으로 유입됩니다. |
Deepview
- Enable / control active deepview properties
키 | 기본값 | Usage |
---|---|---|
$ios_deepview | branch_default | iOS에 사용할 deepview 템플릿의 이름 |
$android_deepview | branch_default | Android에 사용할 deepview 템플릿의 이름 |
$desktop_deepview | branch_default | 데스크톱에 사용할 deepview 템플릿의 이름 |
- Control passive deepview templates
키 | 값 | 기본값 |
---|---|---|
$ios_passive_deepview | iOS에 사용할 템플릿의 이름 | branch_default |
$android_passive_deepview | Android에 사용할 템플릿의 이름 | branch_default |
$desktop_passive_deepview | The 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 allowlist your deep link with the Twitter Card Validator | |
$twitter_title | 대시보드에 설정 | Twitter 카드의 제목 설정 |
$twitter_description | 대시보드에 설정 | Twitter 카드에 대한 설명 설정 |
$twitter_image_url | 대시보드에 설정 | Twitter 카드의 이미지 URL 설정 |
$twitter_site | Twitter에 대한 사이트 설정 | |
$twitter_app_country | 앱 카드의 앱 국가 설정 | |
$twitter_player | 동영상 플레이어의 URL을 설정합니다. 기본값은 다음과 같습니다. $og_video . | |
$twitter_player_width | 플레이어의 너비를 픽셀 단위로 설정 | |
$twitter_player_height | 플레이어의 높이를 픽셀 단위로 설정 |
기타 예약된 키
키 | Usage |
---|---|
access_token or AccessToken | Branch에서 딥링크(Deep Link)가 유효한 Branch 링크인지 여부를 확인하는 데 사용됩니다. |
auth_token or AuthToken | Branch에서 딥링크(Deep Link)가 유효한 Branch 링크인지 여부를 확인하는 데 사용됩니다. |
data | 최상위 링크 정보를 포함하기 위해 Branch에서 사용합니다. 이 매개 변수가 쿼리 매개 변수를 추가하여 Branch 링크에 추가되면 삭제됩니다. 대시 보드를 통해 수동으로 링크를 만들 때 안전하게 사용할 수 있습니다. |
password | If this parameter is added to a Branch link via appending query params, it will be dropped |
auth | If 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 | |
canonicalUrl | SEO 목적으로 사용되는 표준 URL | $canonical_url | |
title | 콘텐츠의 이름 | $og_title | |
contentDescription | 콘텐츠에 대한 설명 | $og_description | |
contentImageUrl | 콘텐츠의 이미지 URL입니다. 절대 경로여야 합니다. | $og_image_url | |
price | 항목의 가격 | $amount | |
currency | ISO 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
andimageUrl
properly represent the object - 페이지 로드의
VIEW_ITEM
event on page load - 유저가 링크가 필요한 작업을 수행할 때 수명주기 후반에 showShareSheet 및 createShortLink를 호출하십시오.
- 해당 유저 조치가 수행 될 때 추가 오브젝트 이벤트 (구매, 공유 완료 등)를 호출하십시오.
- 값
- 금지 사항
- 모든 객체에 동일한
title
,contentDescription
andimageUrl
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 |
---|---|
| 설치/열기를 유도한 Branch 링크에 대해 자동으로 생성된 18자리 ID 번호 (동적 및 3P 링크의 경우 0) |
| 설치/열기를 유도한 리퍼링(Referring) 링크 (있는 경우) |
| 링크가 생성된 위치( |
| 100 % 정확도로 일치 한 경우 |
| 링크를 클릭한 경우 링크 클릭에 대한 리퍼러(Referrer) |
|
기본값은 |
| 유저가 이 세션을 트리거한 Branch 링크를 클릭했는지 여부를 나타냅니다. 기본값은 |
| Branch 링크가 아닌 경우 앱이 오픈되었습니다(써드파티, 유효하지 않은 Branch 딥링크(Deep Link) 또는 Branch 키 불일치). |
Updated about 1 month ago