동적 링크 지원 중단 FAQ

약 7년 전, URL을 보다 강력하게 만들기 위해(예: 런타임 조건에 따라 링크의 대상을 동적으로 변경) 동적 링크를 출시했습니다.

지난 몇 년 동안 웹 및 모바일 생태계는 앱 링크, Google Play 인스턴트, 범용 링크, 앱 클립과 같은 기술로 발전했으며 앱 사용자를 위해 앱 및 웹 전반에서 더욱 매끄럽고 예측 가능한 사용자 경험을 제공했습니다. Google은 이러한 기술을 직접 채택하고 생태계를 계속 발전시켜 나갈 때 개발자와 사용자에게 더 많은 이점이 있다고 생각합니다. 하지만 이러한 새로운 변경사항과 함께 Firebase 동적 링크가 빌드된 원래의 네이티브 API도 진화했으며 새로운 문제가 발생했습니다.

예를 들어 생태계 변화는 Firebase 동적 링크의 핵심 기능 중 하나에 대해 일관적으로 안정적인 환경을 제공하는 기능에 영향을 미쳤습니다. 즉, 플랫폼과 관계없이 앱 사용자가 설치 후 앱으로 원활하게 전환할 수 있습니다.

이상적이지 않은 환경을 계속 지원하는 대신 Firebase 동적 링크를 지원 종료하고 개발자의 다른 문제를 해결하는 데 리소스를 다시 집중하기로 결정했습니다.

이 변경사항으로 인해 시장에서 대체 솔루션 또는 플랫폼 제공업체를 평가하고 채택하는 데 시간이 걸린다는 점을 잘 알고 있습니다.

생태계가 계속 진화하고 변화함에 따라 개발자의 니즈에 맞게 Firebase를 계속 발전시켜 나가고 있습니다. Google은 Firebase 제품 전반에 걸쳐 새로운 기능 및 업데이트를 계속 출시할 예정이며, 앱 개발 여정에서 뛰어난 성과를 낼 수 있도록 최선을 다해 도와드리겠습니다.

알아두어야 할 사항은 무엇인가요?

2025년 8월 25일에 Firebase 동적 링크가 종료됩니다. Firebase 동적 링크(커스텀 도메인 및 page.link 하위 도메인에서 호스팅되는 링크 포함)에서 제공하는 모든 링크가 작동 중단되며 더 이상 새로운 링크를 만들 수 없습니다.

Firebase 동적 링크에서 마이그레이션하는 방법을 결정할 수 있도록 고려해야 할 추가 정보로 이 FAQ 문서를 계속 업데이트하고 현재 Firebase 동적 링크를 사용하는 방법과 일치할 수 있는 다양한 마이그레이션 시나리오에 대한 마이그레이션 가이드를 제공합니다.

또한 지원 종료일인 2025년 8월 25일이 다가옴에 따라 마이그레이션 작업을 지원할 수 있도록 추가 문제를 발견하여 더 많은 FAQ로 이 가이드를 계속 업데이트할 예정입니다.

아래 FAQ에서 가장 중요한 질문에 대한 답을 확인하세요.

마이그레이션을 시작하려면 아래의 '서비스에서 마이그레이션하는 방법' FAQ를 살펴보세요.

2025년 8월 25일에 Firebase 동적 링크가 종료됩니다. Firebase 동적 링크(커스텀 도메인 및 page.link 하위 도메인에서 호스팅되는 링크 포함)에서 제공하는 모든 링크가 작동 중단됩니다.

언제까지 마이그레이션하면 되나요?

2025년 8월 25일까지 마이그레이션을 완료해야 합니다.

예. 2025년 8월 25일에 동적 링크 서비스가 종료될 때까지 새 링크 및 기존 링크는 계속 작동합니다.

Firebase 동적 링크가 지원 중단되면 다음을 예상할 수 있습니다.

  • 모든 링크는 클릭되면 최종 사용자에게 HTTP 404 상태 응답을 반환합니다.

  • 다음에 대한 모든 HTTP 요청은

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks(Short Links API)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats(Link Stats API)

    400/403 HTTP 상태 응답을 반환합니다.

  • 앱에서 수행된 SDK 플랫폼 버전 및 API 호출에 따른 다음 동작은 다음과 같습니다.

    iOS

    사용 사례 API 호출 상태 코드 동작 앱이 비정상 종료되나요?
    짧은 링크 만들기

    shorten(Swift)

    shortenUrl(Swift)

    shortenWithCompletion(Objective-C)

    		 400 실패 이유가 표시되며 오류 발생 아니요*
    최초 실행 기여 분석

    FirebaseApp.configure(Swift)/FIRApp.configure(Objective-C)에서 자동으로 호출

    		 400 오류가 발생하지는 않지만 FDL 객체가 빈 데이터와 함께 다시 전송됩니다. 아니요*
    기여 분석 재개

    handleUniversalLink(Swift)

    handleUniversalLink(Objective-C)

    		 400 실패 이유가 표시되며 오류 발생 아니요*

    Android

    사용 사례 API 호출 상태 코드 동작 앱이 비정상 종료되나요?
    짧은 링크 만들기

    buildShortDynamicLink(Kotlin)

    buildShortDynamicLink(자바)

    		 400 실패 이유가 표시되며 오류 발생 아니요*
    최초 실행 기여 분석

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    		 400 태스크가 성공 응답을 반환하지만 FDL 데이터는 비어 있음 아니요*
    기여 분석 재개

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    		 400 태스크가 성공 응답을 반환하지만 FDL 데이터는 비어 있음 아니요*
    초대 수락 인텐트 리디렉션을 처리할 때(*.page.link 또는 커스텀 도메인에서) Google Play 서비스의 AppInvite 모듈 호출 400 Google PLay 서비스가 호출되면 스피너가 표시되고 400 응답이 반환되면 사라짐 아니요*

서비스에서 마이그레이션하려면 어떻게 해야 하나요?

Firebase 동적 링크 사용에 관한 요구사항은 개발자마다 다르다는 것을 확인했습니다.

자체 사용 사례와 Firebase 동적 링크 사용량의 평가에 따라 아래 시나리오 중 하나가 요구사항에 부합할 수 있습니다.

이 시나리오에서는 Adjust, Airbridge, AppsFlyer, Bitly, Branch, Kochava와 같은 다른 딥 링크 서비스 제공업체/공급업체 및 시장에 나와 있는 기타 유사한 제공업체를 사용하는 것이 좋습니다. 이러한 제공업체는 Google의 검증을 거치지 않았지만 Firebase 동적 링크와 유사한 기능을 제공합니다.

딥 링크 메타데이터를 내보낼 수도 있습니다. 이렇게 하면 원하는 제공업체로 링크를 더 쉽게 마이그레이션할 수 있습니다.

Firebase 동적 링크와 일치하는 기능이 있는 제공업체를 찾으려면 아래의 기능 목록을 참조하세요.

Firebase 동적 링크 기능:

  • 클릭 한 번으로 사용자를 기기의 올바른 스토어로 라우팅(필요한 경우 웹페이지로 대체)
  • 지연된 딥 링크를 사용하여 앱을 다운로드하고 설치한 후 사용자에게 연속된 여정 제공
  • 앱의 딥 링크가 설정된 콘텐츠를 통해 사용자에게 컨텍스트 기반 경험 제공(이미 설치된 경우).
  • 동적 링크 클릭 이벤트와 관련된 분석 데이터 제공
  • 짧은 링크 URL을 만드는 기능 제공
  • 소셜 공유를 위해 링크에 메타데이터를 추가하는 기능 제공

앱이 이미 설치된 후 앱에 딥 링크로 연결하는 것을 중요하게 생각하는데 어떻게 해야 하나요?

이 시나리오에서는 개발자가 사용자에게 딥 링크 환경을 제공할 수 있도록 플랫폼에서 지원하는 방법인 앱 링크와 범용 링크를 사용하는 것을 좋습니다.

앱 링크 및 범용 링크를 사용하여 마이그레이션하는 방법에 관한 자세한 내용은 이 가이드를 확인하세요.

또한 이 가이드에서는 필요한 경우 Firebase 호스팅을 사용하여 새 링크에 사용할 도메인에서 필요한 도메인 및 애셋 링크 확인 파일(예: 앱 링크용 assetlinks.json 파일, 범용 링크용 apple-app-site-association 파일)을 호스팅하는 방법도 설명합니다.

이 시나리오에서는 예정된 지원 종료일을 위해 앱에서 아무런 조치를 취하지 않아도 되지만 다음과 같은 조치를 취하는 것이 좋습니다.

  • 링크 메타데이터 내보내기 가이드에 따라 기존 Firebase 동적 링크를 검토하여 링크가 더 이상 제공되지 않으면 사용자 및 앱이 영향을 받지 않는지 확인합니다.

  • Firebase Console에서 Firebase 동적 링크 URL 프리픽스를 삭제합니다. 참고: URL 프리픽스 도메인은 2025년 8월 25일 이후에 자동으로 삭제됩니다.

  • 앱에서 Firebase 동적 링크 SDK를 삭제합니다.

요구사항에 부합하는 마이그레이션 시나리오가 없다면 Google에 알려 주세요.

짧은 링크 및 애널리틱스용 Firebase Dynamic Links API는 지원 종료일인 2025년 8월 25일까지 계속 사용할 수 있습니다.

이 날짜 이후에는 이 API를 더 이상 사용할 수 없으며 서비스가 종료됩니다.

링크 메타데이터를 내보내는 방법에 관한 안내는 링크 메타데이터 내보내기 가이드를 참조하세요.

내보내기 가이드를 사용하여 링크 자체가 포함된 Firebase 동적 링크 메타데이터를 가져올 수 있습니다.

Firebase Dynamic Links Analytics API를 사용하여 각각의 Firebase 동적 링크에 대해 링크 통계 데이터를 가져올 수 있습니다. 이 Analytics API는 최대 5QPS로 제한됩니다. API를 사용할 때 해당 요청 한도 내에서 작업하는 방법에 대한 예시는 이 Cloud Task 샘플을 참조하세요.

또한 Google 애널리틱스를 사용하여 Google 애널리틱스 고유의 앱 업데이트 이벤트를 비롯한 링크 분석 데이터 하위 집합의 데이터를 내보낼 수 있습니다.

마이그레이션을 위해 요청 비율을 높여야 하는 경우 Firebase 지원팀에 문의하세요.

도메인 및 링크 메타데이터는 2025년 8월 25일에 삭제 대상으로 표시되고 데이터 보관 정책에 따라 삭제됩니다.

아니요. 온보딩이 더 이상 불가능하므로 Firebase 동적 링크를 온보딩할 필요가 없습니다. 대신 이메일 링크 인증 시작에 관한 업데이트된 가이드를 따라 프로젝트에 이메일 링크 인증을 사용 설정하고 구현할 수 있습니다.

이 변경사항의 영향을 받는 작업의 전체 목록을 확인하세요.

이메일 링크 인증 및 Firebase를 통한 대역 외 이메일 작업은 계속 작동하지만 2025년 8월 25일에 Firebase Dynamic Links 서비스가 종료된 후 이러한 작업을 계속 사용하려면 최신 Firebase Authentication SDK로 업그레이드하고 새 솔루션으로 마이그레이션해야 합니다.

아래 링크된 가이드를 참조하여 마이그레이션을 완료하는 방법을 알아보세요.

이 변경사항의 영향을 받는 작업의 전체 목록을 확인하세요.

Firebase 인증 Android SDK 버전이 v20.0.0 미만이거나 BoM 버전이 26.0.0 미만인 경우 OAuth 흐름 구현에 어떤 영향을 미치나요?

Android 앱에서 OAuth 흐름 구현을 계속 사용하려면 최신 Firebase 인증 Android SDK(최소 v20.0.0)로 업데이트해야 합니다.

웹 앱의 Firebase 인증 이메일 작업에 영향을 미치나요?

아니요. Firebase 동적 링크 지원 중단은 휴대기기에서 수신되는 URL 처리에만 영향을 미칩니다.

Firebase JS SDK 라이브러리를 사용하여 Cordova 앱에서 OAuth 제공업체를 인증하는 구현에 영향을 미치나요?

예. Firebase JS SDK는 Firebase 동적 링크를 사용하여 OAuth 인증 흐름을 구현합니다. 인증 흐름을 완료하려면 OAuth 흐름을 수동으로 진행하면서 그 결과인 OAuth 인증 정보를 Firebase에 전달하여 흐름 구현을 수정해야 합니다.

자세한 내용은 Cordova 가이드를 참조하세요.

다양한 마이그레이션 시나리오를 자세히 설명하고 사용 가능한 다양한 대안에 관한 마이그레이션 가이드를 제공하는 '서비스에서 마이그레이션하는 방법' FAQ를 참조하세요.