Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

Flutter 앱에서 동적 링크 생성

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Firebase Dynamic Links Builder API를 사용하여 짧거나 긴 동적 링크를 만들 수 있습니다. 이 API는 긴 동적 링크 또는 동적 링크 매개변수를 포함하는 개체를 수락하고 다음 예와 같은 URL을 반환합니다.

https://example.com/link/WXYZ
https://example.page.link/WXYZ

Android 앱에서 동적 링크를 만들려면 먼저 Firebase SDK를 포함해야 합니다. 앱이 동적 링크를 수신하도록 설정된 경우 이 단계를 이미 완료한 것이므로 이 섹션을 건너뛸 수 있습니다.

  1. 아직 수행하지 않은 경우 Flutter용 Firebase SDK를 설치하고 초기화합니다 .

  2. Flutter 프로젝트의 루트 디렉터리에서 다음 명령을 실행하여 동적 링크 플러그인을 설치합니다.

    flutter pub add firebase_dynamic_links
    
  3. Android 앱을 빌드하는 경우 Firebase 콘솔의 프로젝트 설정 페이지를 열고 SHA-1 서명 키를 지정했는지 확인하세요. 앱 링크를 사용하는 경우 SHA-256 키도 지정합니다.

  4. Firebase 콘솔에서 동적 링크 섹션을 엽니다.

    1. 동적 링크에 대한 도메인을 아직 설정하지 않은 경우 시작하기 버튼을 클릭하고 프롬프트를 따릅니다.

      이미 동적 링크 도메인이 있는 경우 기록해 두십시오. 프로그래밍 방식으로 동적 링크를 만들 때 동적 링크 도메인을 제공해야 합니다.

    2. 권장사항 : "더보기"(⋮) 메뉴에서 딥 링크 및 대체 링크에 허용되는 URL 패턴을 지정합니다. 이렇게 하면 권한이 없는 당사자가 도메인에서 제어하지 않는 사이트로 리디렉션되는 동적 링크를 생성하지 못하도록 방지할 수 있습니다.

      특정 URL 패턴 허용을 참조하십시오.

동적 링크를 만들려면 새 DynamicLinkParameters 개체를 만들고 buildLink() 또는 buildShortLink() 에 전달합니다.

다음 최소 예제는 Android의 com.example.app.android 와 iOS의 앱 com.example.app.ios 로 열리는 https://www.example.com/ 에 대한 긴 동적 링크를 생성합니다.

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildLink(dynamicLinkParams);

짧은 동적 링크를 만들려면 DynamicLinkParameters 개체를 buildShortLink() 에 전달합니다. 짧은 링크를 구축하려면 네트워크 호출이 필요합니다. 예를 들어:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

기본적으로 짧은 동적 링크는 몇 자 길이의 접미사를 사용하여 생성됩니다. 이렇게 하면 링크가 더 간결해지지만 누군가가 유효한 짧은 링크를 추측할 가능성도 있습니다. 종종 링크가 공개 정보로 연결되기 때문에 누군가 그렇게 해도 해가 되지 않습니다.

그러나 짧은 링크가 사용자별 정보로 연결되는 경우 누군가가 유효한 동적 링크를 추측할 가능성이 거의 없도록 17자 접미사로 더 긴 링크를 만들어야 합니다. 이렇게 하려면 ShortDynamicLinkType.unguessablebuildShortLink() 메서드에 전달합니다.

final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
    dynamicLinkParams,
    shortLinkType: ShortDynamicLinkType.unguessable,
);

Dynamic Link Builder API를 사용하여 지원되는 매개변수로 동적 링크를 생성할 수 있습니다. API 참조를 참조 하십시오.

다음 예시에서는 몇 가지 공통 매개변수가 설정된 동적 링크를 만듭니다.

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(
    packageName: "com.example.app.android",
    minimumVersion: 30,
  ),
  iosParameters: const IOSParameters(
    bundleId: "com.example.app.ios",
    appStoreId: "123456789",
    minimumVersion: "1.0.1",
  ),
  googleAnalyticsParameters: const GoogleAnalyticsParameters(
    source: "twitter",
    medium: "social",
    campaign: "example-promo",
  ),
  socialMetaTagParameters: SocialMetaTagParameters(
    title: "Example of a Dynamic Link",
    imageUrl: Uri.parse("https://example.com/image.png"),
  ),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

다음 방법으로 동적 링크 매개변수를 설정할 수 있습니다.

DynamicLink 매개변수
setLink 앱에서 열리는 링크입니다. 앱에서 처리할 수 있는 URL을 지정합니다. 일반적으로 앱 관련 논리(예: 사용자에게 쿠폰을 제공하거나 시작 화면 표시)를 시작하는 앱의 콘텐츠 또는 페이로드입니다. 이 링크는 올바른 형식의 URL이어야 하고 URL 인코딩이 적절해야 하며 HTTP 또는 HTTPS를 사용해야 하며 다른 동적 링크일 수 없습니다.
setDomainUriPrefix Firebase 콘솔에서 찾을 수 있는 동적 링크 URL 프리픽스입니다. Dynamic Link 도메인은 다음 예와 같습니다.
https://example.com/link
https://example.page.link
Android 매개변수
setFallbackUrl 앱이 설치되지 않은 경우 열리는 링크입니다. 앱이 설치되지 않은 경우 Play 스토어에서 앱을 설치하는 것 외에 콘텐츠의 모바일 웹 버전을 열거나 앱의 프로모션 페이지를 표시하는 것과 같은 다른 작업을 수행하려면 이를 지정하십시오.
최소 버전 설정 링크를 열 수 있는 앱 최소 버전의 versionCode입니다. 설치된 앱이 이전 버전인 경우 사용자는 앱을 업그레이드하기 위해 Play 스토어로 이동합니다.
Ios매개변수
setAppStoreId 앱이 설치되지 않은 경우 사용자를 App Store로 보내는 데 사용되는 앱의 App Store ID
setFallbackUrl 앱이 설치되지 않은 경우 열리는 링크입니다. 앱이 설치되지 않은 경우 App Store에서 앱을 설치하는 것 외에 콘텐츠의 모바일 웹 버전을 열거나 앱의 홍보 페이지를 표시하는 것과 같은 작업을 수행하려면 이를 지정하십시오.
setCustomScheme 앱의 번들 ID가 아닌 것으로 정의된 경우 앱의 사용자 지정 URL 스키마
setIpadFallbackUrl 앱이 설치되지 않은 경우 iPad에서 열리는 링크입니다. 앱이 설치되지 않은 경우 App Store에서 앱을 설치하는 것 외에 콘텐츠의 웹 버전을 열거나 앱의 홍보 페이지를 표시하는 것과 같은 작업을 수행하려면 이를 지정하십시오.
setIpadBundleId 링크를 열기 위해 iPad에서 사용할 iOS 앱의 번들 ID입니다. Firebase 콘솔의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다.
최소 버전 설정 링크를 열 수 있는 앱 최소 버전의 버전 번호입니다. 이 플래그는 앱이 열릴 때 앱에 전달되며 앱은 이 플래그로 수행할 작업을 결정해야 합니다.
NavigationInfo 매개변수
setForcedRedirectEnabled '1'로 설정하면 Dynamic Link가 열릴 때 앱 미리보기 페이지를 건너뛰고 대신 앱 또는 스토어로 리디렉션됩니다. 앱 미리보기 페이지(기본적으로 활성화됨)는 앱에서 동적 링크를 열 때 사용자를 가장 적절한 대상으로 보다 안정적으로 보낼 수 있습니다. 그러나 이 페이지 없이 동적 링크를 안정적으로 열 수 있는 앱에서만 동적 링크가 열릴 것으로 예상되는 경우 이 매개변수를 사용하여 비활성화할 수 있습니다. 이 매개변수는 iOS에서만 동적 링크의 동작에 영향을 미칩니다.
SocialMetaTag매개변수
setTitle 소셜 게시물에서 동적 링크를 공유할 때 사용할 제목입니다.
setDescription 소셜 게시물에서 동적 링크를 공유할 때 사용할 설명입니다.
setImageUrl 이 링크와 관련된 이미지의 URL입니다. 이미지는 300x200px 이상, 300KB 미만이어야 합니다.
GoogleAnalytics매개변수
setSource
setMedium
설정캠페인
setTerm
setContent
Google Play 분석 매개변수. 이러한 매개변수(`utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`)는 Play 스토어에 전달되고 링크 페이로드에 추가됩니다.
ItunesConnectAnalytics매개변수
setProviderToken
setAffiliateToken
setCampaignToken
iTunes Connect 분석 매개변수. 이러한 매개변수(`pt`, `at`, `ct`)는 App Store에 전달됩니다.