리디렉션 및 링크 도메인에 대한 링크 동작 설정

Overview

기본 링크 동작을 설정할 수 있습니다. 사용자 지정 링크 동작에서 설정을 변경하면 기본 링크 동작에 대해 설정한 값이 일반적으로 각 딥링크에 대해 재정의됩니다.
본 가이드에서는 Branch 링크에 대한 링크 도메인 및 기본 설정 방법을 다룹니다.

1. 기본 링크 동작

이것은 필수 설정입니다.
Configuration 페이지의 General 탭에 있는 Required Redirects 섹션 아래에 지정된 리다이렉트가 없는 모바일 디바이스에 대한 폴백 URL을 입력합니다.

2. 안드로이드 기본 링크 동작

이것은 필수 설정입니다.

  1. On the Configuration page, in the General tab, under the Required Redirects section, go to the Android Redirects section.
  2. 이 설정을 사용하여 안드로이드 딥링크의 기본 동작을 제어하십시오.
  • 참고 : Play Store는 출시된 앱 용입니다. 앱을 찾을 수 없거나 로컬 / 개발 빌드인 경우 사용자 지정 URL 옵션을 사용하십시오.
  1. Enable App Links 를 선택하는 경우 이를 수행하려면 SHA256 인증서 핑거프린트를 생성해야 합니다.
  2. keystore file 로 이동합니다 (배포되기 전에 APK 파일의 디버그 및 프로덕션 버전 구축에 사용됨)
  3. 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 기본 링크 동작

이것은 필수 설정입니다.

  1. Configuration 페이지에서 General tab, under the Required Redirects section, navigate to the iOS Redirect section.
  2. 이 설정을 사용하여 iOS에서 딥링크의 기본 동작을 제어하십시오.
  3. Enable Universal Links 을 선택하는 경우 앱의 Apple Developer Portal에 있는 Apple App Prefix 를 입력해야 합니다.

❗️

< iOS 12.3에서 App Store 리디렉션

12.3 미만의 iOS 버전을 사용중인 유저의 경우 앱 스토어로 리다이렉트 될 때 먼저 App Store를 오픈하도록 요청하는 팝업이 유저에게 나타납니다. 앱을 다운로드하려면 유저는 OK 을 클릭하여 App Store로 완전히 이동해야 합니다. 이 팝업은 iOS 차원에서 보여주는 것이므로, 유저 플로우에서 제거할 수 없습니다.

4. 소셜 미디어 미리보기

  1. Configuration 페이지의 General 탭에서 Social Media Preview 섹션으로 이동합니다.
  2. 다음 필드를 작성하여 소셜 미디어에서 공유하거나 재공유 할 때 설치 페이지 링크의 모양을 사용자 지정 하십시오.
    가. Link Title
    나. Description
    다. Thumbnail Image

5. 링크 도메인

  1. Configuration 페이지의 General 탭에서 Link Domain 섹션으로 이동합니다.
  2. 모든 링크에 사용할 링크 도메인을 선택하십시오.
    Use My Own Domain
    1. 자사 도메인을 사용하기로 선택한 경우 도메인을 입력합니다. 링크 도메인은 딥링크를 호스트하는 웹 사이트이며 딥링크가 아닙니다.
    Change My app.link Subdomain
    1. 여기에서 링크 도메인의 현재 서브 도메인을 보고 복사할 수 있습니다. 변경하려면 Change my app.link Subdomain를 클릭하십시오.
    2. 새 서브도메인을 입력합니다.
    3. 입력 후 Get를 클릭합니다. 이미 서브도메인을 한 번 변경한 경우 다시 변경할 수 있는 옵션이 없습니다. 서브도메인을 변경해야 하는 경우 지원팀에 문의하세요.

도메인 변경 주의사항 검토

  1. app.link 에서 app.link
    가. 이전 app.link 딥링크가 실패합니다.
    나. 이전 app.link 딥링크는 '파일을 찾을 수 없음' 웹 사이트로 이동하고 앱을 열지 않습니다.
    다. 새로운 app.link 딥링크는 앱 내 코드를 업데이트하여 새 링크 도메인을 추가한 후에만 앱을 열 수 있습니다.
    다. 이전 app.link 가 활성화되어 있으면 대신 custom link domain 으로 전환하는 것이 좋습니다.
  2. app.link 에서 custom link domain
    가. 이전 app.link 딥링크는 계속 작동합니다.
    나. 새로운 custom link domain 딥링크는 앱 내 코드를 업데이트하여 새 링크 도메인을 추가한 후에만 앱을 열 수 있습니다.
  3. custom link domain 에서 custom link domain
    가. 이전 custom link domain 딥링크가 실패합니다.
    나. 새로운 custom link domain 딥링크는 앱 내 코드를 업데이트하여 새 링크 도메인을 추가한 후에만 앱을 열 수 있습니다.
  4. 레거시 bnc.lt 에서 custom link domain
    가. bnc.ltcustom link domain 딥링크가 모두 작동합니다.
    나. 새로운 custom link domain 딥링크는 앱 내 코드를 업데이트하여 새 링크 도메인을 추가한 후에만 앱을 열 수 있습니다.

링크 도메인을 변경 하려면 이곳에 설명된 단계를 따르십시오.

6. 고급 설정

  1. Configuration 페이지의 General 탭에서 Advanced Settings 섹션으로 이동합니다.
  2. For URI Scheme Deep Link Mode 선택지를 사용하여 유니버설 링크 및 안드로이드 앱 링크가 실패할 때 Branch가 URI Scheme을 사용하여 앱을 여는 방법과 타이밍을 제어할 수 있습니다.
    • Conservative 모드는 오류 메시지의 위험이 있는 경우 URI Scheme을 사용하지 않습니다. Intelligent Mode가 야기할 수 있는 URI 오류가 악화되는 것을 방지하기 위해 앱의 설치/재설치를 테스트하는 동안 연동 중에 이를 설정하는 것이 좋습니다.
    • Intelligent mode is recommended 모든 곳에서 URI 스키마를 안전하게 사용하기 위해 Branch 데이터를 사용합니다. 앱이 삭제되면 특정 브라우저에서 오류 메시지가 발생할 위험이 다소 있습니다.
    • Aggressive 모든 곳에서 URI Scheme을 강제 적용하여 앱이 없는 유저가 일부 브라우저에서 오류 메시지를 볼 수 있습니다.
  3. 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 AllowlistRedirect Allowlist

Redirect Allowlist

  1. Match Type 선택 :

    • Normal 이 권장됩니다.
    • Unique 를 선택하면 Branch는 하나의 고유한 풋프린트가 존재하는 경우에만 매칭을 통해 설치 후 딥링크를 수행합니다. 예를 들어, 한 유저와 유저의 쌍둥이 형제가 각각 동일한 OS / 버전 등의 iPhone 5s를 가지고 있고, 각각 동일한 앱에 대해 서로 다른 링크를 클릭 한 다음 동시에 앱을 여는 경우가 있습니다. Unique가 설정된 경우, Branch는 딥링크를 수행하지 않습니다. 하지만 이는 대부분 매우 드문 특별한 상황을 위한 것이므로 설정하기를 원하지는 않을 것입니다.
  2. 추가로 다음을 활성화 / 비활성화할 수 있습니다.

    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 - 기본적으로 비활성화되어 있습니다. 클라이언트에서 마지막으로 기여한 터치 데이터를 수신할 수 있습니다.

    d. Enable China Features - 기본적으로 비활성화되어 있습니다. China Features에는 Google이 지원되지 않는 안드로이드 디바이스에서 IMEI를 수집하는 기능이 있습니다. 진행 전에 계정 관리자에게 문의하고 문서를 검토하십시오.

UTM 파라미터

Branch 파라미터

utm_source

Channel

utm_medium

Feature

utm_campaign

Campaign

utm_content

Tags

utm_term

Keywords (대시보드에는 표시되지 않음)

7. 데스크톱 앱 기본 링크 동작

  1. Configuration 페이지의 General 탭에서 Desktop Redirects 섹션으로 이동합니다.
  2. Default Desktop 의 경우 다음 중 하나를 선택합니다.
    가. Branch-hosted SMS Landing Page
    나. Custom Landing Page
  3. Mac Desktop 의 경우 다음을 입력하십시오.
    가. Mac URI Scheme
    나. Mac App Store URL
  4. Windows Desktop
    의 경우 가. Windows URI Scheme
    나. Windows Store URL
    다. Windows Package Family Name

참고 : 링크를 클릭할 때 앱이 설치되지 않은 경우, 데스크톱 URL 혹은 기본 URL으로 폴백합니다.

8. 고급 모바일 리다이렉트

Amazon Fire 기본 링크 동작

  1. Configuration 페이지의 General 탭에서 Advanced Mobile Redirects 섹션으로 이동합니다.
  2. Fire Redirects 섹션에 Amazon Fire ASIN 또는 Custom URL 를 입력하십시오.

iPad 리다이렉트 링크 동작

  1. Configuration 페이지의 General 탭에서 Advanced Mobile Redirects 섹션으로 이동합니다.
  2. iPad Redirects 섹션에서 iPad 앱에 대해 다른 App Store ID를 가지고 있거나 iPad 태블릿에서 다른 URL로 폴백하기를 원하는 경우 여기에 해당 URL을 지정하십시오.

안드로이드 태블릿 리다이렉트 링크 동작

  1. Configuration 페이지의 General 탭에서 Advanced Mobile Redirects 섹션으로 이동합니다.
  2. Android Redirects 섹션에서 태블릿 앱에 대해 다른 Play 스토어 패키지가 있거나 안드로이드 태블릿에서 다른 URL로 폴백하기를 원하는 경우 여기에 해당 URL을 지정하십시오.

WeChat 리다이렉트 링크 동작

  1. Configuration 페이지의 General 탭에서 Advanced Mobile Redirects 섹션으로 이동합니다.
  2. iOS 또는 안드로이드에서 WeChat은 앱 외부로의 딥링킹을 지원하지 않기 때문에 커스텀 URL로 폴백하고자 하는 경우 여기에 값을 입력하십시오.

FAQ

약 1개월 전에 업데이트 됨



리디렉션 및 링크 도메인에 대한 링크 동작 설정


제안된 편집은 API 참조 페이지에서 제한됩니다.

Markdown 본문 콘텐츠에 대한 편집만 제안할 수 있지만 API 사양에는 제안할 수 없습니다.