Firebase 문제로 고통받기 전에 헤어지는 방법: 실무자를 위한 전환 가이드

Firebase Dynamic Links(FDL)는 모바일 앱 딥링크를 위한 종합적인 솔루션이었습니다. 하지만 Google이 이 서비스의 지원 종료를 발표하면서, 많은 개발자와 제품 팀은 대안을 찾아야 했습니다. 적합한 솔루션을 찾았다면, 이제 FDL에서 성공적으로 전환하는 방법을 이해해야 합니다.

본 가이드에서는 원활한 전환을 보장하기 위한 핵심 고려사항과 모범 사례를 중심으로 마이그레이션 프로세스의 각 단계를 단계별로 안내합니다.

알아야 할 사항

Firebase Dynamic Links 서비스가 2025년 8월 25일에 종료되었습니다. 이에 따라 개발자는 App Links, Universal Links 또는 서드파티 딥링크 솔루션과 같은 대체 수단을 도입해야 합니다.

기존 링크는 서비스 종료 시점까지 동작을 유지했으나, 현재는 새로운 링크 작성이 불가능합니다.

또한 개발자는 기존 링크의 메타데이터를 내보내고, 서비스 종료에 따른 딥링크 기능 변화에 맞춰 앱 업데이트를 검토해야 합니다.

기존 Firebase Dynamic Links를 내보낼 때는 보유한 링크를 전수 점검하고 트래픽이 높은 링크를 우선순위에 두는 것이 필수적입니다. 차세대 대체 솔루션을 선정한 이후에는 링크 메타데이터 내보내기가 성공적인 마이그레이션에 핵심적인 역할을 합니다.

성공적인 마이그레이션을 위한 준비 사항

첫째, 앱 배포 주기와 앱 버전 업데이트 추이를 정확하게 파악하세요. 모든 사용자에게 앱 업데이트가 완료되기까지 얼마만큼의 시간이 소요될까요?

둘째, 현재 구축된 시스템 현황과 신규 솔루션에서 반드시 지원해야 하는 기능 요소를 명확히 파악해야 합니다. 신규 프로젝트의 경우, 향후 마이그레이션 문제를 예방하기 위해 시작 단계부터 새로운 딥링크 솔루션을 적용하시기 바랍니다.

• 현재 사용 현황 진단:
  • 어떤 사용자 흐름이 이에 의존하고 있나요? 온보딩 프로세스에서의 신규 사용자 경험, 추천 프로그램, 앱 프로모션, 유료 캠페인 등이 해당될 수 있습니다.
  • 링크는 어떻게 생성되고 있나요? 수동 생성, 마케팅 툴 내부 생성, 백엔드 API, 앱 내 콘텐츠 공유 등 다양한 방식이 있습니다.
  • 성과는 어떻게 측정되고 있나요? 어떤 소스가 클릭, 참여, 전환을 이끌어냈는지 확인해야 합니다.
• 요구사항 정의 — 대체 솔루션을 탐색할 때 비용, API 제한, 성능 관련 변수를 방지하기 위한 핵심 단계입니다.
  • 고려해야 할 잠재적 필요사항 목록은 다음과 같습니다.
• 크로스 플랫폼 딥링크 – 단일 링크로 iOS 및 Android 지원
• 디퍼드 딥링크
• 브랜드 링크 도메인
• 캠페인 레벨 측정 및 애널리틱스
• QR 코드 지원
• SDK 성능 및 연동 복잡성
• 볼륨 및 스케일 예측
• 일별/월별 링크 생성량 및 생성 프로세스(자동 vs. 수동)

또한 App Link 또는 Universal Link 구성 파일을 호스팅하기 위한 신규 도메인을 미리 프로비저닝해야 합니다.

마이그레이션 방법: 구현 체크리스트

1) 대체 솔루션 선정

이전 섹션에서 정리한 시스템 요구사항을 바탕으로 후보 솔루션을 압축하고 테스트를 진행하세요. 마이그레이션 절차의 편의성을 높이기 위해 Android App Links 및 iOS Universal Links를 도입하는 것을 강력히 권장합니다.

2) 딥링크 환경 설정

• 서드파티 제공업체를 선택한 경우 브랜드 도메인, 인증서, DNS CNAME을 포함한 환경 설정을 직접 관리해야 합니다.
• Android 앱의 경우, 앱 매니페스트를 업데이트하여 딥링크 URL을 처리하고 앱을 App Links와 연동하도록 인텐트 필터를 설정하세요. 또한 웹사이트 도메인에 assetlinks.json 파일을 호스팅해야 합니다. 이 파일은 App Links 작동을 위해 도메인과 Android 앱 간의 보안 연결을 생성합니다. assetlinks.json의 URL에 정상적으로 접근할 수 있는지 확인하세요.
• iOS 앱의 경우, 프로젝트 설정을 업데이트하여 어소시에이티드 도메인을 구성하고 Universal Links를 처리하도록 설정하세요. 여기에는 자격 증명 수정, 딥링크 URL 수신을 위한 애플리케이션 코드 업데이트, 웹사이트 도메인 내 apple-app-site-association 파일 호스팅 작업이 포함됩니다. apple-app-site-association 파일은 해당 웹 도메인의 콘텐츠를 처리할 수 있도록 승인된 앱 목록을 제공합니다. apple-app-site-association의 URL에 제대로 접근할 수 있는지 확인하세요.
• 이후 모바일 앱에 선택한 제공업체의 SDK를 연동하세요.

3) 링크 매핑 전략 수립

각 FDL 유형 및 사용 사례를 신규 시스템의 동일 항목에 매핑하여, 각 링크가 올바른 앱 페이지 또는 웹 페이지로 연결되도록 하세요. 개발자, QA, 지원 팀이 쉽게 이해할 수 있도록 이 로직을 명확히 문서화해 두어야 합니다.

4) Firebase 형식의 링크를 신규 형식으로 변환

링크 매핑을 마쳤다면, 해당 링크가 어떤 데이터 구조와 상세 수준을 지원하는지 알 수 있습니다. 이제 신규 링크의 어떤 파라미터가 기존과 동일한 기능을 지원하는지 확인해야 합니다.

다음과 같은 구체적인 옵션들이 있습니다.

• 단순히 이름만 다른 경우: 1:1 매핑이 가능하므로 쉽게 처리할 수 있습니다.
• 기본 기능으로 지원되지 않는 경우: 이 경우 커스텀 파라미터를 직접 생성해야 합니다.
• 다른 상세 수준으로 지원되는 경우: 리포팅 시 기준이 될 적절한 상세 수준을 직접 결정해야 합니다.

5) 리디렉션 처리 구현

가능하다면 기존 FDL 도메인에서 신규 링크 도메인으로의 리디렉션을 설정하세요. 이 작업은 Firebase 프로젝트에서 사용된 도메인에 대한 제어 권한이 필요할 수 있습니다.

도메인을 직접 소유하고 있다면 신규 도메인으로의 리디렉션을 손쉽게 설정할 수 있습니다.

도메인을 소유하고 있지 않다면 다음과 같은 대안을 적용할 수 있습니다:

• 가능한 경우, 딥링크를 위한 Firebase 내 커스텀 도메인으로 전환
• 리디렉션을 처리할 프록시 서버 구축
• 다양한 채널에 수동으로 게시된 기존 링크를 수정하도록 사용자에게 안내

6) 애플리케이션 코드 업데이트

• 신규 SDK를 앱에 연동하세요.
• 새로운 SDK 기능에 맞춰 링크 파싱 및 라우팅 로직을 업데이트하세요. 앱의 설치 여부와 관계없이 새로운 SDK가 사용자를 앱 내의 올바른 화면이나 콘텐츠로 정확히 이동시키는지 확인해야 합니다. 앱이 설치되어 있지 않은 경우 디퍼드 딥링크를 활용하여, 사용자가 앱을 설치한 후 원하는 콘텐츠로 이동할 수 있도록 처리해야 합니다.
• 필요한 경우 기존 레거시 링크에 대한 하위 호환성을 유지하세요.

7) 단계별 마이그레이션

단계적인 마이그레이션을 추진하면 사용자 흐름이 끊기는 리스크를 줄일 수 있습니다. 리스크가 낮거나 트래픽이 적은 링크부터 먼저 진행하는 것을 권장합니다.

더 많은 흐름을 안정화할수록 시스템에 대한 신뢰도가 높아지며, 최종 완료 단계에 도달할 때까지 적용 유스케이스를 점진적으로 확대해 나갈 수 있습니다.

8) 테스트, 테스트, 또 테스트!

테스트는 구현 과정에서 가장 핵심적인 단계입니다. 테스트를 많이 거칠수록 서비스 안정성에 대한 확신이 높아집니다.

무엇을 테스트해야 할까요?

• OS 버전별 iOS 및 Android 환경
• 신규 설치, 앱 업데이트, 재참여 시나리오
• 다양한 링크 유형(웹, 앱, SMS, 이메일, QR 코드 등)
• 오프라인 접속이나 링크 공유 앱 사용 등 예외적인 케이스
• 클릭 가능한 링크를 직접 생성하여, 사용자가 App Links 및 Universal Links를 클릭했을 때 앱 내 의도한 화면이나 액티비티로 정확히 연결되는지 확인

Firebase에서 앱스플라이어로 마이그레이션하는 방법

단 몇 단계만으로 Firebase Dynamic Links에서 앱스플라이어의 딥링크 스위트로 마이그레이션할 수 있습니다. 여기서는 전체적인 프로세스를 개략적으로 안내해 드리며, 더욱 상세한 절차는 Firebase 마이그레이션 단계별 가이드를 참조하시기 바랍니다.

1단계: 앱스플라이어 계정 생성

앱스플라이어 계정을 생성하고 적절한 권한을 가진 계정 사용자를 추가하세요.

2단계: 앱 추가

앱스플라이어 딥링크 스위트에 앱을 추가하세요. 이 단계에서는 귀사의 활성 사용자 정의에 맞추어 리어트리뷰션 윈도우를 설정할 수도 있습니다. 기본값은 90일로 설정되어 있습니다.

3단계: OneLink 템플릿 생성

OneLink 템플릿은 생성하는 모든 딥링크의 리디렉션 로직을 위한 기본 토대가 됩니다. 템플릿을 추가하거나 수정하려면 앱스플라이어 어드민 사용자이거나 해당 권한을 보유하고 있어야 합니다.

4단계: 앱스플라이어 SDK 설정

앱스플라이어 SDK는 앱과 앱스플라이어 플랫폼을 연결해 주는 역할을 합니다. 이를 통해 통합된 형태의 딥링크 및 어트리뷰션을 제공합니다.

5단계: 파라미터 매핑 이해

Firebase Dynamic Links는 앱스플라이어와 서로 다른 파라미터를 사용합니다. 파라미터 간의 대응 관계를 올바르게 매핑하고 이해해야 Firebase에서 마이그레이션을 완료한 후에도 기존과 동일한 성과를 얻을 수 있습니다.

6단계: 매핑된 파라미터로 OneLink 링크 생성

매핑된 파라미터를 활용하여 이제 템플릿 기반의 OneLink 링크를 생성할 수 있습니다. CSV 파일을 통한 대량 생성, OneLink API를 활용한 프로그래밍 방식 생성, 앱스플라이어 대시보드 내 개별 생성, SDK 내부 생성, 또는 수동으로 조합하는 롱링크 형태 등 다양한 방식으로 작업이 가능합니다.

Firebase Dynamic Links에서 앱스플라이어 Deep Linking Suite로 마이그레이션하는 방법에 대한 자세한 안내는 헬프센터에서 확인하실 수 있습니다.

Firebase에서 앱스플라이어로 마이그레이션해야 하는 이유

Firebase Dynamic Links에서 앱스플라이어로 마이그레이션하는 것은 단순히 기존 딥링크 캠페인을 지속하는 것 이상의 장점을 제공하며, 장기적인 비즈니스 이점을 가져다줍니다. 앱스플라이어의 Deep Linking Suite는 앱의 성장에 맞춰 유연하게 확장할 수 있도록 설계되었습니다.

Firebase가 Google 광고 제품에 최적화되도록 설계된 반면, 앱스플라이어는 90개 이상의 비용 API 파트너 및 350개 이상의 클릭 파트너와 연동되어 Meta, TikTok, Snap과 같은 플랫폼을 포함한 옴니채널 ROI 가시성을 제공합니다.

또한 앱스플라이어의 Deep Linking Suite에는 스마트 배너, 스마트 스크립트, ESP 연동 등 Firebase에서 지원하지 않는 다양한 기능이 포함되어 있습니다. 이러한 기능들은 모두 상용화 단계의 완성도를 갖추고 지속적으로 관리되어 매끄러운 고객 여정을 제공합니다.

마이그레이션 모범 사례

프로세스 최적화

Firebase에서 마이그레이션하는 과정은 기존의 오래된 사용자 흐름을 정리하고, 성과가 저조했던 부분을 개선하며, 성장을 위한 새로운 아이디어를 시도할 수 있는 좋은 기회입니다.
이러한 변경 사항은 진행 과정에서 반드시 문서화해 두세요. 모든 시스템이 안정적으로 자리를 잡은 후에는 리텐션, 전환율 또는 기타 핵심 성과 지표(KPI)를 극대화하기 위해 사용자 흐름을 개선하고 최적화해 나갈 수 있습니다.

핵심 요약

Firebase Dynamic Links 서비스가 종료됨에 따라 다른 솔루션으로의 마이그레이션은 필수적인 단계가 되었지만, 이를 너무 부담스럽게 느낄 필요는 없습니다. 현재 설정 상태를 진단하고, 필요한 요구사항을 정의하며, 적합한 대체 솔루션을 선택함으로써 기능 손실 없이 안정적인 전환을 이룰 수 있습니다.

핵심은 단계별로 마이그레이션을 계획하고 실행하는 것입니다. 충분한 테스트와 단계적인 적용을 통해 문제를 사전에 방지하고 향후 딥링크 전략을 최적화할 수 있습니다.

또한 마이그레이션은 사용자 흐름을 효율화하고 앱의 성능을 향상시키며, 궁극적으로 더 높은 사용자 참여를 이끌어낼 수 있는 기회라는 점을 기억하세요.

신속한 마이그레이션을 준비 중이신가요? 앱스플라이어의 Deep Linking Suite는 퀄리티 저하 없이 원하는 만큼 빠르게 마이그레이션을 완료할 수 있도록 필요한 툴과 서비스를 제공합니다.

더 알아보기.

FAQ