고급 설정 및 링크 도메인 변경

고급 설정 변경

Branch 대시보드의 Link Settings에서 고급 링크 설정을 변경할 수 있습니다.

  1. Match typeunique 또는 normal (기본값)로 설정합니다.
    가. 권장 : Normal . Unique 를 선택하면 Branch는 하나의 고유한 풋프린트가 존재하는 경우에만 매칭을 통해 설치 후 딥링크를 수행합니다. 예를 들어, 한 유저와 유저의 쌍둥이 형제가 각각 동일한 OS / 버전 등의 iPhone 5s를 가지고 있고, 각각 동일한 앱에 대해 서로 다른 링크를 클릭 한 다음 동시에 앱을 여는 경우가 있습니다. Unique가 설정된 경우, Branch는 딥링크를 수행하지 않습니다. 하지만 이는 대부분 매우 드문 특별한 상황을 위한 것이므로 설정하기를 원하지는 않을 것입니다.
  2. Duration 을 초로 설정합니다
    가. Duration은 click가 앱 open 혹은 시스템 삭제로 사용되기 전 시스템 내 존속 시간입니다. 이 값을 수정하여 유저의 핑거프린트 채취 대기 시간을 변경할 수 있습니다. 설정된 지속시간 내에 유저의 핑거프린트를 채취하고 나면 딥링크 데이터가 앱으로 유입됩니다. 기본 종료 시간은 2시간 (7200초) 입니다.
  3. UTM tags 을 설정합니다
    가. disabled 을 권장합니다. 이 기능을 활성화하면 Branch는 UTM 파라미터를 기반으로 채널, 기능, 캠페인, 태그 및 $키워드를 자동으로 설정합니다. 대시보드, API 또는 SDK를 통해 생성된 링크가 아닌 동적으로 생성된 링크에만 적용됩니다.
UTM 파라미터Branch 파라미터
utm_sourceChannel
utm_mediumFeature
utm_campaignCampaign
utm_contentTags
utm_termKeywords (대시보드에는 표시되지 않음)

링크 도메인 변경

app.link 도메인은 기본 Branch 도메인입니다. 대시보드 가입 시, 자동으로 다중 문자 스크램블이 있는 app.link 도메인의 하위 도메인(예: xxxxxx.app.link)이 할당됩니다. 링크 도메인을 커스텀 app.link 도메인, 커스텀 하위 도메인 또는 커스텀 루트 도메인으로 변경할 수 있습니다.

app.link 도메인 커스텀화

대부분의 Branch 고객은 자신의 app.link 도메인을 커스텀화하여 사용하고 있습니다. 이를 통해 Branch 서브 도메인을 브랜드에 매칭할 수 있기 때문입니다(예: yourbrand.app.link).

app.link 도메인을 커스텀화하는 방법:

  1. Review and understand our domain change warning
  2. Branch 대시보드의 Link Settings 페이지로 이동합니다.
  3. Change your subdomain. If you have any issues updating/changing your subdomain, click here to contact support.

🚧

Customize your app.link Subdomain

It is important to update your app.link subdomain before you begin your Branch app SDK integration; otherwise, you will need to make updates to your app’s associated domains and you may see strange link behavior.

Additionally, make sure the app.link subdomain that you want is available before making any changes to campaigns and app SDK updates.

❗️

Android App Links & Web-Only Limitations

Currently, we cannot support web-only link functionality ($web_only; links that only open the web even if the app is installed) and Android App Links together on custom root domains and subdomains. Android App Links force the app to open even if $web_only=true is specified on custom root domains and subdomains.

커스텀 서브 도메인 사용

고객사가 활용하는 도메인에 대하여 고도의 제약사항을 가지며 Branch 도메인이 자사의 하위 도메인과 매칭되기를 원한다면, 커스텀 서브 도메인(예: link.yourbrand.com)을 사용할 수 있습니다.

참고: 이렇게 하려면 자사의 도메인을 custom.bnc.lt으로 CNAME 지정해야 하며, Branch 앱 SDK가 이미 연동된 경우 관련 앱 내의 associated domain을 변경해야 합니다.

커스텀 서브 도메인을 사용하는 방법:

  1. Review and understand Domain change warning
  2. Review and understand Custom domain warning
  3. Review and understand Custom domain debugging
  4. Branch 대시보드의 Link Settings로 이동한 다음 링크 도메인을 커스텀 서브 도메인으로 변경합니다.
  5. 커스텀 서브 도메인에서 CNAME 레코드를 업데이트합니다.
    1. CNAME = custom.bnc.lt
  6. Link settings에서 Confirm을 클릭하십시오.
  7. AWS의 Route 53을 통해 도메인을 설정하는 경우 Hosted zones 섹션이 아닌 Registered Domains 탭에서 네임서버를 편집하도록 하십시오.

커스텀 루트 도메인 사용

일부(극소수) 회사는 Branch 도메인에 대해 완전히 별도의 도메인을 설정하여 커스텀 루트(예: yourbrand-link.com)를 만듭니다. 회사가 app.link 또는 커스텀 하위 도메인 옵션을 사용할 수 없는 경우에만 권장됩니다.

참고: 이 경우 도메인에 대한 NS 레코드를 업데이트해야 합니다.

커스텀 루트 도메인을 사용하는 방법:

  1. Review and understand Domain change warning
  2. Review and understand Custom domain warning
  3. Review and understand Custom domain debugging
  4. Change your link domain to your custom root domain on Link settings
  5. 를 업데이트하십시오. NS records on your custom root domain
    1. These values are unique per app and can only be found in your Branch dashboard when changing your link settings.
  6. Link settings에서 Confirm을 클릭하십시오.
  7. AWS의 Route 53을 통해 도메인을 설정하는 경우 Hosted zones 섹션이 아닌 Registered Domains 탭에서 네임서버를 편집하도록 하십시오.

Please reach out to your Branch account manager to enable web-only links on custom domains.

Redirect Allowlist

With Branch, you have the ability to set a specific whitelist of domains that you can allow your Branch Links to redirect to (set to disabled by default). With the Redirect Allowlist, you can limit Branch Link redirection to specific web domains or URI schemes across your Branch platform. List each of the domains you want to limit redirection to. We also support a “*” for wildcard subdomains.

For example, if your allowlist includes “branch.io”, “*.branch.io”, and “myapp://”, your deep links can only redirect to domains like branch.io, dashboard.branch.io, or myapp://.

It is recommended that you include the app store domains that are relevant to the way users download your app. For example: “play.google.com” and “apps.apple.com”

829829

문제 해결

도메인 변경 주의사항

  • 사용 Change link domain
  • app.link 에서 app.link으로
    • 이전 app.link 딥링크가 실패합니다.
    • 이전 app.link 딥링크는 '파일을 찾을 수 없음' 웹 사이트로 이동하고 앱을 열지 않습니다.
    • Your new app.link deep links will open your app after you update your code to append the new link domain
    • 이전 app.link 이 활성화된 경우 custom link domain instead로 전환하는 것이 좋습니다.
  • app.link 에서 custom link domain으로
    • 이전 app.link 딥링크는 계속 작동합니다.
    • Your new custom link domain deep links will open your app after you update your code to append the new link domain
  • custom link domain 에서 custom link domain으로
    • 이전 custom link domain 딥링크가 실패합니다.
    • Your new custom link domain deep links will open your app after you update your code to append the new link domain
  • 레거시 bnc.lt 에서 custom link domain 또는 app.link
    • bnc.ltcustom link domain / app.link 딥링크가 모두 작동합니다.
    • Your new custom link domain / app.link deep links will open your app after you update your code to append the new link domain

📘

커스텀 도메인으로 앱 내 코드 변경하는 방법

Intent Filter on Android 추가하기
new key in your apps Info.plist on iOS 추가하기

커스텀 도메인 주의사항

  • 사용 Change link domain
  • 딥링크에 자사 도메인을 사용하려면 custom link domainNS 또는 CNAME 레코드가 Branch를 가리켜야 합니다.
  • 도메인의 NS 또는 CNAME 레코드를 변경할 때마다 Branch를 도메인에 대해 권한 있는 등록자로 만듭니다. 이를 통해 Branch가 해당 도메인을 제어할 수 있으며 여러분은 해당 custom root domain 또는 custom subdomain 에 대한 접근권을 모두 잃게 됩니다. 웹 페이지는 공백이 되며 도메인 제어 주체는 Branch로 변경됩니다.
  • Branch는 도메인을 사용하여 모든 딥링크 트래픽을 라우트합니다. Branch는 또한 AASA 파일 및 SSL 인증서를 호스트합니다.
  • If you have content on your custom root domain (e.g. https://example.com/), Branch recommends using an unused custom subdomain instead (e.g. https://link.example.com/)

커스텀 도메인 디버깅

  • 사용 Change link domain
  • dig ns <domain> 또는 dig cname <domain>와 함께 도메인 레코드 변경 사항을 테스트할 수 있습니다.
  • 도메인 변경 시 기존 링크에 심각한 문제가 발생할 수 있으므로, Branch 용으로 사용할 도메인이나 서브 도메인은 처음에 하나를 선택하여 계속 사용하는 것이 좋습니다.
  • AWS의 Route 53을 통해 도메인을 구성하는 경우 Hosted zones 섹션이 아닌 Registered Domains 탭에서 네임서버를 편집하도록 하십시오.
  • Branch 링크 호스팅에 기본 웹사이트 도메인을 사용할 수 없습니다.
  • 커스텀 링크 도메인을 추가할 때 www 를 포함하지 마십시오.
  • 도메인에 설정된 CAA 레코드가 있는 경우 목록에 letsencrypt.org를 추가합니다.

권장 사항

For changing the Link Domain for both of your LIVE and TEST Branch apps, the best practice is changing your LIVE app firstly and then adding test into some where in the new domain name for the TEST app.

Notice, the LIVE and TEST apps cannot use the same customized Link Domain. For example, the LIVE app of Branch Monster Factory uses branchster.app.link for its LIVE app and branchster.test-app.link for its TEST app.


이 페이지가 도움이 되었습니까?