푸시 알림의 딥링크

필수 조건

이 기능을 사용하려면 먼저 Swift Braze SDK를 통합해야 합니다.

딥링크 처리하기

1단계: 계획 등록

딥링킹을 처리하려면 Info.plist 파일에 사용자 정의 스키마를 명시해야 합니다. 탐색 구조는 사전의 배열로 정의됩니다. 이러한 각 사전에는 문자열 배열이 포함되어 있습니다.

Xcode를 사용하여 Info.plist 파일을 편집합니다:

1. 새 키( URL types)를 추가합니다. Xcode는 자동으로 Item 0 사전을 포함하는 배열로 만듭니다.
2. Item 0에서 URL identifier 키를 추가합니다. 값을 커스텀 스키마로 설정합니다.
3. Item 0에서 URL Schemes 키를 추가합니다. 그러면 자동으로 Item 0 문자열을 포함하는 배열이 됩니다.
4. URL Schemes » Item 0 을 사용자 지정 구성표로 설정합니다.

또는 Info.plist 파일을 직접 편집하려면 다음 사양을 따를 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLName</key>
        <string>YOUR.SCHEME</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>YOUR.SCHEME</string>
        </array>
    </dict>
</array>

2단계: 스키마 허용 목록 추가

앱의 Info.plist 파일에 LSApplicationQueriesSchemes 키를 추가하여 canOpenURL(_:)에 전달할 URL 스키마를 선언해야 합니다. 이 허용 목록에 없는 스키마를 호출하려고 시도하면 시스템에서 기기 로그에 오류를 기록하고 딥링크가 열리지 않습니다. 이 오류의 예는 다음과 같습니다:

1
<Warning>: -canOpenURL: failed for URL: "yourapp://deeplink" – error: "This app is not allowed to query for scheme yourapp"

예를 들어, 인앱 메시지에서 Facebook 앱을 탭하여 열려면 앱의 허용 목록에 Facebook 커스텀 스키마(fb)가 있어야 합니다. 그렇지 않으면 시스템이 딥 링크를 거부합니다. 앱 내부의 페이지나 보기로 연결되는 딥링크는 여전히 앱의 Info.plist에 앱의 커스텀 스키마가 나열되어야 합니다.

허용 목록의 예는 다음과 같습니다:

1
2
3
4
5
6
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>myapp</string>
    <string>fb</string>
    <string>twitter</string>
</array>

자세한 내용은 Apple 설명서에서 LSApplicationQueriesSchemes 키를 참조하세요.

3단계: 핸들러 구현

앱을 활성화한 후 iOS는 application:openURL:options: 메서드를 호출합니다. 중요한 인수는 NSURL 객체입니다.

• swift
• objective-c

1
2
3
4
5
6
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
  let path = url.path
  let query = url.query
  // Insert your code here to take some action based upon the path and query.
  return true
}

1
2
3
4
5
6
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
  NSString *path  = [url path];
  NSString *query = [url query];
  // Insert your code here to take some action based upon the path and query.
  return YES;
}

앱 전송 보안(ATS)

Apple의 정의에 따르면, “앱 전송 보안은 앱과 웹 서비스 간의 연결 보안을 향상시키는 기능입니다. 이 기능은 보안 연결을 위한 모범 사례를 준수하는 기본 연결 요구 사항으로 구성되어 있습니다. 앱은 이 기본 동작을 재정의하고 전송 보안을 해제할 수 있습니다.”

ATS는 기본적으로 적용됩니다. 모든 연결은 HTTPS를 사용해야 하며, 순방향 비밀성을 지원하는 TLS 1.2를 사용하여 암호화해야 합니다. 자세한 내용은 ATS를 사용하여 연결하기 위한 요구 사항을 참조하세요. Braze가 최종 기기에 제공하는 모든 이미지는 TLS 1.2를 지원하고 ATS와 호환되는 콘텐츠 전송 네트워크(‘CDN’)에서 처리됩니다.

애플리케이션의 Info.plist 에서 예외로 지정하지 않는 한 이러한 요구 사항을 따르지 않는 연결은 다음과 유사한 오류와 함께 실패합니다.

오류 예시 1:

1
2
CFNetwork SSLHandshake failed (-9801)
Error Domain=NSURLErrorDomain Code=-1200 "An SSL error has occurred, and a secure connection to the server cannot be made."

예제 오류 2:

1
NSURLSession/NSURLConnection HTTP load failed (kCFStreamErrorDomainSSL, -9802)

ATS 규정 준수는 모바일 앱 내에서 열린 링크(클릭된 링크에 대한 기본 처리)에 대해 적용되며 웹 브라우저를 통해 외부에서 열린 사이트에는 적용되지 않습니다.

ATS로 작업하기

다음 중 한 가지 방법으로 ATS를 처리할 수 있지만, ATS 요구 사항을 준수하는 것이 좋습니다.

• comply
• partially disable
• fully disable

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
    <key>NSExceptionDomains</key>
    <dict>
        <key>example.com</key>
        <dict>
            <key>NSExceptionAllowsInsecureHTTPLoads</key>
            <false/>
            <key>NSIncludesSubdomains</key>
            <true/>
        </dict>
    </dict>
</dict>

1
2
3
4
5
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

URL 디코딩

SDK는 링크를 퍼센트 인코딩하여 유효한 URL을 생성합니다. 유니코드 문자와 같이 올바르게 형성된 URL에서 허용되지 않는 모든 링크 문자는 퍼센트 기호로 이스케이프 처리됩니다.

인코딩된 링크를 디코딩하려면 String 속성 removingPercentEncoding을 사용합니다. 또한 BrazeDelegate.braze(_:shouldOpenURL:)에서 true를 반환해야 합니다. 앱에서 URL 처리를 트리거하려면 콜투액션이 필요합니다. For example:

• swift
• objective-c

1
2
3
4
5
  func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    let urlString = url.absoluteString.removingPercentEncoding
    // Handle urlString
    return true
  }

1
2
3
4
5
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<NSString *, id> *)options {
  NSString *urlString = [url.absoluteString stringByRemovingPercentEncoding];
  // Handle urlString
  return YES;
}

앱 설정에 대한 딥링킹

UIApplicationOpenSettingsURLString 을 활용하여 사용자를 Braze 푸시 알림 및 인앱 메시지에서 앱 설정으로 딥링크할 수 있습니다.

앱에서 iOS 설정으로 사용자를 이동합니다:

1. 먼저, 애플리케이션이 스키마 기반 딥링크 또는 유니버설 링크를 사용하도록 설정되어 있는지 확인합니다.
2. 설정 페이지로 딥링킹할 URI를 결정합니다(예: myapp://settings 또는 https://www.braze.com/settings).
3. 사용자 정의 구성표 기반 딥링크를 사용하는 경우 application:openURL:options: 메서드에 다음 코드를 추가하세요:

• swift
• objective-c

1
2
3
4
5
6
7
func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
  let path = url.path
  if (path == "settings") {
    UIApplication.shared.openURL(URL(string:UIApplication.openSettingsURLString)!)
  }
  return true
}

1
2
3
4
5
6
7
8
9
10
- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
  NSString *path  = [url path];
  if ([path isEqualToString:@"settings"]) {
    NSURL *settingsURL = [NSURL URLWithString:UIApplicationOpenSettingsURLString];
    [[UIApplication sharedApplication] openURL:settingsURL];
  }
  return YES;
}

커스텀 옵션

기본 WebView 사용자 지정

Braze.WebViewController 클래스는 일반적으로 웹 딥링크에 대해 ‘앱 내에서 웹 URL 열기’를 선택한 경우 SDK에 의해 열린 웹 URL을 표시합니다.

BrazeDelegate.braze(_:willPresentModalWithContext:) 위임 메서드를 통해 Braze.WebViewController를 사용자 지정할 수 있습니다.

링크 처리 사용자 지정

BrazeDelegate 프로토콜을 사용하여 딥링크, 웹 URL, 유니버설 링크 등의 URL 처리를 사용자 지정할 수 있습니다. Braze 초기화 중에 위임을 설정하려면 Braze 인스턴스에서 위임 오브젝트를 설정합니다. 그러면 Braze는 URI를 처리하기 전에 위임의 shouldOpenURL 구현을 호출합니다.

유니버설 링크

Braze는 푸시 알림, 인앱 메시지, 콘텐츠 카드에서 유니버설 링크를 지원합니다. 유니버설 링크 지원을 사용하려면 configuration.forwardUniversalLinks를 true로 설정해야 합니다.

활성화하면 Braze는 application:continueUserActivity:restorationHandler: 메서드를 통해 앱의 AppDelegate로 유니버설 링크를 전달합니다.

또한 유니버설 링크를 처리하도록 애플리케이션을 설정해야 합니다. 애플리케이션이 유니버설 링크에 맞게 올바르게 구성되었는지 확인하려면 Apple의 설명서를 참조하세요.

예시

BrazeDelegate

다음은 BrazeDelegate 을 사용한 예제입니다. 자세한 내용은 Braze Swift 소프트웨어 개발 키트 참조를 참조하세요.

• swift
• objective-c

1
2
3
4
5
6
7
8
func braze(_ braze: Braze, shouldOpenURL context: Braze.URLContext) -> Bool {
  if context.url.host == "MY-DOMAIN.com" {
    // Custom handle link here
    return false
  }
  // Let Braze handle links otherwise
  return true
}

1
2
3
4
5
6
7
8
- (BOOL)braze:(Braze *)braze shouldOpenURL:(BRZURLContext *)context {
  if ([[context.url.host lowercaseString] isEqualToString:@"MY-DOMAIN.com"]) {
    // Custom handle link here
    return NO;
  }
  // Let Braze handle links otherwise
  return YES;
}