Skip to content

iOS 딥링킹 가이드

이 가이드는 사용 중인 메시징 채널과 Branch와 같은 타사 링크 제공업체 사용 여부에 따라 iOS 앱에 적합한 딥링킹 전략을 선택하는 데 도움을 줍니다.

구현 세부 사항은 딥링킹을 참조하십시오. 문제 해결을 위해서는 딥링킹 문제 해결을 참조하십시오.

링크 유형 선택

iOS 앱에서 Braze 메시지의 링크를 처리하는 방법은 세 가지입니다. 각각의 방식은 서로 다르게 작동하며, 서로 다른 채널과 사용 사례에 적합합니다.

커스텀 구성 딥링크

커스텀 스킴 딥링크(예: myapp://products/123)는 앱을 특정 화면으로 직접 엽니다. 제3자에 의해 링크가 수정되지 않는 채널에 대한 가장 간단한 옵션입니다.

다음과 같은 경우 커스텀 스킴 딥링크를 사용하십시오:

  • 푸시 알림, 인앱 메시지 또는 콘텐츠 카드 전송
  • 앱이 설치되어 있지 않으면 링크가 작동할 필요가 없습니다
  • 클릭 추적(이메일 서비스 공급자 링크 래핑)이 필요하지 않습니다.

다음과 같은 경우에는 커스텀 스킴 딥링크를 사용하지 마십시오:

  • 이메일 발송 — 이메일 서비스 공급자는 클릭 추적을 위해 링크를 감싸는데, 이로 인해 커스텀 스키마가 깨집니다.
  • 앱이 설치되지 않은 경우 웹 페이지로 돌아갈 수 있는 링크가 필요합니다.

유니버설 링크

유니버설 링크(예: https://myapp.com/products/123)는 iOS가 브라우저에서 열지 않고 앱으로 연결할 수 있는 표준 HTTPS URL입니다. 서버 측 구성(AASA 파일)과 앱 측 설정(연동 도메인 권한 부여)이 필요합니다.

다음과 같은 경우에 유니버설 링크를 사용하세요:

  • 이메일 발송 중. 귀사의 이메일 서비스 공급자는 클릭 추적을 위해 링크를 감싸므로, 링크는 반드시 HTTPS여야 합니다.
  • 링크가 감싸지거나 단축되는 SMS 또는 기타 채널을 통해 전송.
  • 앱이 설치되지 않았을 때 웹 페이지로 돌아갈 수 있는 링크가 필요합니다.
  • 귀사는 Branch 또는 Appsflyer와 같은 제3자 링크 제공업체를 사용하고 있습니다.

다음과 같은 경우에는 유니버설 링크를 사용하지 마십시오:

  • 푸시 알림, 인앱 메시지 또는 콘텐츠 카드에서만 딥링크가 필요합니다. 커스텀 구성은 더 간단합니다.

앱 내에서 웹 URL 열기

이 옵션은 앱 내에서 모달 WebView 안에 웹 페이지를 엽니다. Braze 소프트웨어 개발 키트가 완전히 처리합니다.Braze.WebViewController— URL 처리 코드를 직접 작성할 필요가 없습니다.

다음과 같은 경우에 “앱 내에서 웹 URL 열기”를 사용하세요:

  • 앱을 벗어나지 않고도 웹 페이지(예: 프로모션이나 기사)를 표시하고 싶습니다.
  • 해당 URL은 특정 앱 화면으로의 딥링크가 아닌 표준 HTTPS 웹 페이지입니다.

다음과 같은 경우에는 “앱 내에서 웹 URL 열기”를 사용하지 마십시오:

  • 앱에서 특정 보기로 이동해야 합니다. 대신 커스텀 스킴이나 유니버설 링크를 사용하세요.
  • 해당 웹 페이지는 인증이 필요하거나 임베딩을 차단하는 콘텐츠 보안 정책 헤더를 가지고 있습니다.

각 링크 유형에 필요한 사항

커스텀 구성 딥링크

유니버설 링크

앱 내에서 웹 URL 열기

AASA 파일이 필요할 때

애플 앱 사이트 연결(AASA) 파일은 유니버설 링크를 사용할 때만 필요합니다. 앱이 처리할 수 있는 URL을 iOS에 알려줍니다.

다음과 같은 경우 AASA 파일이 필요합니다:

  • 이메일 캠페인에서 딥링크를 전송합니다(이메일 서비스 공급자가 링크를 HTTPS 클릭 추적 URL로 감싸기 때문입니다).
  • SMS 캠페인에서 딥링크를 전송합니다(링크가 HTTPS URL로 단축될 수 있기 때문입니다).
  • 귀사는 Branch, Appsflyer 또는 다른 연결 제공업체를 사용합니다(해당 업체들이 자체 HTTPS 도메인을 사용하기 때문입니다).
  • 푸시 알림, 인앱 메시지 또는 콘텐츠 카드(덜 흔하지만 가능forwardUniversalLinks = true)에서 유니버설 링크를 사용합니다.

다음과 같은 경우에는 AASA 파일이 필요하지 않습니다:

  • 커스텀 스킴 딥링크(예: myapp://)는 푸시 알림, 인앱 메시지 또는 콘텐츠 카드에서만 사용됩니다.
  • 앱 내에서 웹 URL 열기 옵션을 사용합니다.

AASA 설정 방법에 대해서는 유니버설 링크 및 앱 링크를 참조하십시오.

앱 코드가 링크를 처리해야 할 때

사용하는 링크 유형에 따라 구현할 위임자 메서드가 달라집니다:

Braze와 함께 브랜치 사용하기

Branch를 링크 제공자로 사용하는 경우, 표준 유니버설 링크 설정 외에도 몇 가지 추가 단계가 필요합니다:

  1. 브랜치 소프트웨어 개발 키트: Branch의 설명서에 따라 Branch 소프트웨어 개발 키트를 통합하십시오.
  2. 관련 도메인: Xcode의 서명&기능(Signing Capabilities) 아래에 브랜치 도메인(예: applinks:yourapp.app.link)을 추가하세요.
  3. 브레이즈 델리게이트: 브랜치 링크를 Braze가 직접 처리하도록 두지 않고 브랜치 소프트웨어 개발 키트로 라우팅하도록braze(_:shouldOpenURL:) 구현하십시오.
  4. 전환형 유니버설 링크: Braze 소프트웨어 개발 키트 configuration.forwardUniversalLinks = true구성에서 설정하십시오.

구현 세부 사항 및 디버깅 안내는 딥링킹용 브랜치를 참조하십시오.

New Stuff!