리디렉션 및 링크 도메인에 대한 링크 동작 설정
Overview
기본 링크 동작을 설정할 수 있습니다. 사용자 지정 링크 동작에서 설정을 변경하면 기본 링크 동작에 대해 설정한 값이 일반적으로 각 딥링크에 대해 재정의됩니다.
본 가이드에서는 Branch 링크에 대한 링크 도메인 및 기본 설정 방법을 다룹니다.
1. 기본 링크 동작
이것은 필수 설정입니다.
Configuration 페이지의 General 탭에 있는 Required Redirects 섹션 아래에 지정된 리다이렉트가 없는 모바일 디바이스에 대한 폴백 URL을 입력합니다.

2. 안드로이드 기본 링크 동작
이것은 필수 설정입니다.
- On the Configuration page, in the General tab, under the Required Redirects section, go to the Android Redirects section.
- 이 설정을 사용하여 안드로이드 딥링크의 기본 동작을 제어하십시오.
- 참고 : Play Store는 출시된 앱 용입니다. 앱을 찾을 수 없거나 로컬 / 개발 빌드인 경우 사용자 지정 URL 옵션을 사용하십시오.
- Enable App Links 를 선택하는 경우 이를 수행하려면 SHA256 인증서 핑거프린트를 생성해야 합니다.
keystore file
로 이동합니다 (배포되기 전에 APK 파일의 디버그 및 프로덕션 버전 구축에 사용됨)keytool -list -v -keystore my-release-key.keystore
을 실행하여 핑거프린트를 생성합니다.
* 핑거프린트 예 :
AA:C9:D9:A5:E9:76:3E:51:1B:FB:35:00:06:9B:56:AC:FB:A6:28: CE:F3:D6:65:38:18:E3:9C:63:94:FB:D2:C1
Branch 대시보드에 추가

3. iOS 기본 링크 동작
이것은 필수 설정입니다.
- Configuration 페이지에서 General tab, under the Required Redirects section, navigate to the iOS Redirect section.
- 이 설정을 사용하여 iOS에서 딥링크의 기본 동작을 제어하십시오.
- Enable Universal Links 을 선택하는 경우 앱의 Apple Developer Portal에 있는 Apple App Prefix 를 입력해야 합니다.
- If you would like to use deferred deep linking via NativeLink™, you can Enable NativeLink™. Users will be presented with a deepview that enables them to continue their user experience in an app by clicking on the main CTA with the following configurations:
- All iOS Traffic (All Browsers)
- All iOS 15+ Traffic (All Browsers)
- Only iOS Private Relay Traffic (Safari & In-App Safari Browsers)
Once enabled, follow the instructions in our developer documentation to use NativeLink™.
< iOS 12.3에서 App Store 리디렉션
12.3 미만의 iOS 버전을 사용중인 유저의 경우 앱 스토어로 리다이렉트 될 때 먼저 App Store를 오픈하도록 요청하는 팝업이 유저에게 나타납니다. 앱을 다운로드하려면 유저는 OK 을 클릭하여 App Store로 완전히 이동해야 합니다. 이 팝업은 iOS 차원에서 보여주는 것이므로, 유저 플로우에서 제거할 수 없습니다.
4. 소셜 미디어 미리보기
- Configuration 페이지의 General 탭에서 Social Media Preview 섹션으로 이동합니다.
- 다음 필드를 작성하여 소셜 미디어에서 공유하거나 재공유 할 때 설치 페이지 링크의 모양을 사용자 지정 하십시오.
가. Link Title
나. Description
다. Thumbnail Image

5. 링크 도메인
- Configuration 페이지의 General 탭에서 Link Domain 섹션으로 이동합니다.
- Choose a link domain which will be used for all your links:
a. Use My Own Domain
1. If you choose to use your own domain, enter your domain. The link domain is the website that hosts your deep links, it is not a deep link.
b. Change My app.link Subdomain
1. Here is where you can see and copy the current subdomain for your link domain. If you want to change it, click Change my app.link Subdomain.
2. Enter in a new subdomain.
3. Click Get when you're done.
If you have already changed your subdomain once, you will not have the option to change it again. If you need to make changes to the subdomain contact our Support team.

도메인 변경 주의사항 검토
app.link
에서app.link
가. 이전app.link
딥링크가 실패합니다.
나. 이전app.link
딥링크는 '파일을 찾을 수 없음' 웹 사이트로 이동하고 앱을 열지 않습니다.
다. 새로운app.link
딥링크는 앱 내 코드를 업데이트하여 새 링크 도메인을 추가한 후에만 앱을 열 수 있습니다.
다. 이전app.link
가 활성화되어 있으면 대신custom link domain
으로 전환하는 것이 좋습니다.app.link
에서custom link domain
가. 이전app.link
딥링크는 계속 작동합니다.
나. 새로운custom link domain
딥링크는 앱 내 코드를 업데이트하여 새 링크 도메인을 추가한 후에만 앱을 열 수 있습니다.custom link domain
에서custom link domain
가. 이전custom link domain
딥링크가 실패합니다.
나. 새로운custom link domain
딥링크는 앱 내 코드를 업데이트하여 새 링크 도메인을 추가한 후에만 앱을 열 수 있습니다.- 레거시
bnc.lt
에서custom link domain
가.bnc.lt
및custom link domain
딥링크가 모두 작동합니다.
나. 새로운custom link domain
딥링크는 앱 내 코드를 업데이트하여 새 링크 도메인을 추가한 후에만 앱을 열 수 있습니다.
If you wish to change your link domain, follow the steps outlined here.
6. 고급 설정
- Configuration 페이지의 General 탭에서 Advanced Settings 섹션으로 이동합니다.
- For URI Scheme Deep Link Mode 선택지를 사용하여 유니버설 링크 및 안드로이드 앱 링크가 실패할 때 Branch가 URI Scheme을 사용하여 앱을 여는 방법과 타이밍을 제어할 수 있습니다.
- Conservative 모드는 오류 메시지의 위험이 있는 경우 URI Scheme을 사용하지 않습니다. Intelligent Mode가 야기할 수 있는 URI 오류가 악화되는 것을 방지하기 위해 앱의 설치/재설치를 테스트하는 동안 연동 중에 이를 설정하는 것이 좋습니다.
- Intelligent mode is recommended 모든 곳에서 URI 스키마를 안전하게 사용하기 위해 Branch 데이터를 사용합니다. 앱이 삭제되면 특정 브라우저에서 오류 메시지가 발생할 위험이 다소 있습니다.
- Aggressive 모든 곳에서 URI Scheme을 강제 적용하여 앱이 없는 유저가 일부 브라우저에서 오류 메시지를 볼 수 있습니다.
- Limit link redirection to specific web domains across the entire deep link platform with a Redirect Allowlist. List each of the domains you want to limit redirection to by a comma. We also support a “*” for wildcard subdomains. Configuring this setting ensures that your links cannot be hijacked by malicious third parties to redirect to unauthorized content, malware, or fraudulent sites.

Redirect Allowlist
-
Match Type 선택 :
- Normal 이 권장됩니다.
- Unique 를 선택하면 Branch는 하나의 고유한 풋프린트가 존재하는 경우에만 매칭을 통해 설치 후 딥링크를 수행합니다. 예를 들어, 한 유저와 유저의 쌍둥이 형제가 각각 동일한 OS / 버전 등의 iPhone 5s를 가지고 있고, 각각 동일한 앱에 대해 서로 다른 링크를 클릭 한 다음 동시에 앱을 여는 경우가 있습니다. Unique가 설정된 경우, Branch는 딥링크를 수행하지 않습니다. 하지만 이는 대부분 매우 드문 특별한 상황을 위한 것이므로 설정하기를 원하지는 않을 것입니다.
-
추가로 다음을 활성화 / 비활성화할 수 있습니다.
a. Use UTM tags for analytics (for dynamically-created links) - 기본적으로 비활성화되어 있습니다. 이 기능을 활성화하면 Branch는 UTM 파라미터 기반으로 채널, 기능, 캠페인, 태그 및 $keywords 를 자동으로 설정합니다. 대시보드, API 또는 SDK를 통해 생성된 링크가 아닌 동적으로 생성된 링크에만 적용됩니다.
b. Analytics mapping with UTM - 기본적으로 활성화되어 있습니다. 기본값 : 웹 URL로 리다이렉트할 때 Branch는 다음의 Branch 링크 분석 태그의 값을 자동으로 UTM 파라미터로 변환하여 전달합니다 [~campaign -> utm_campaign, ~channel -> utm_source, ~feature -> utm_medium]. 리다이렉트되는 URL에 이미 UTM 파라미터가 있는 경우, Branch는 이를 자동으로 변환하지 않습니다.
c. Enable retrieving Last Attributed Touch Data via SDKs - 기본적으로 비활성화되어 있습니다. 클라이언트에서 마지막으로 기여한 터치 데이터를 수신할 수 있습니다.
UTM 파라미터 | Branch 파라미터 |
---|---|
| Channel |
| Feature |
| Campaign |
| Tags |
| Keywords (대시보드에는 표시되지 않음) |

7. 데스크톱 앱 기본 링크 동작
- Configuration 페이지의 General 탭에서 Desktop Redirects 섹션으로 이동합니다.
- Default Desktop 의 경우 다음 중 하나를 선택합니다.
가. Branch-hosted SMS Landing Page
나. Custom Landing Page - Mac Desktop 의 경우 다음을 입력하십시오.
가. Mac URI Scheme
나. Mac App Store URL - Windows Desktop
의 경우 가. Windows URI Scheme
나. Windows Store URL
다. Windows Package Family Name
참고 : 링크를 클릭할 때 앱이 설치되지 않은 경우, 데스크톱 URL 혹은 기본 URL으로 폴백합니다.

8. 고급 모바일 리다이렉트
Amazon Fire 기본 링크 동작
- Configuration 페이지의 General 탭에서 Advanced Mobile Redirects 섹션으로 이동합니다.
- Fire Redirects 섹션에 Amazon Fire ASIN 또는 Custom URL 를 입력하십시오.
iPad 리다이렉트 링크 동작
- Configuration 페이지의 General 탭에서 Advanced Mobile Redirects 섹션으로 이동합니다.
- iPad Redirects 섹션에서 iPad 앱에 대해 다른 App Store ID를 가지고 있거나 iPad 태블릿에서 다른 URL로 폴백하기를 원하는 경우 여기에 해당 URL을 지정하십시오.
안드로이드 태블릿 리다이렉트 링크 동작
- Configuration 페이지의 General 탭에서 Advanced Mobile Redirects 섹션으로 이동합니다.
- Android Redirects 섹션에서 태블릿 앱에 대해 다른 Play 스토어 패키지가 있거나 안드로이드 태블릿에서 다른 URL로 폴백하기를 원하는 경우 여기에 해당 URL을 지정하십시오.
WeChat 리다이렉트 링크 동작
- Configuration 페이지의 General 탭에서 Advanced Mobile Redirects 섹션으로 이동합니다.
- iOS 또는 안드로이드에서 WeChat은 앱 외부로의 딥링킹을 지원하지 않기 때문에 커스텀 URL로 폴백하고자 하는 경우 여기에 값을 입력하십시오.
FAQ
Updated about 1 month ago