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

Unity로 동적 링크 생성

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

Firebase 동적 링크 API를 사용하여 짧거나 긴 동적 링크를 만들 수 있습니다. API는 몇 가지 선택적 매개변수 구조를 사용하여 링크를 구축합니다. 이전에 생성된 긴 링크에서 짧은 링크를 만들 수도 있습니다. Dynamic Links API는 다음과 같은 URL을 생성합니다.

https://example.page.link/aSDf

시작하기 전에

Firebase 동적 링크 를 사용하려면 먼저 다음을 수행해야 합니다.

  • Unity 프로젝트를 등록하고 Firebase를 사용하도록 구성합니다.

    • Unity 프로젝트에서 이미 Firebase를 사용하고 있다면 이미 Firebase용으로 등록 및 구성된 것입니다.

    • Unity 프로젝트가 없는 경우 샘플 앱 을 다운로드할 수 있습니다.

  • Unity 프로젝트에 Firebase Unity SDK (구체적으로 FirebaseDynamicLinks.unitypackage )를 추가합니다.

Unity 프로젝트에 Firebase를 추가하려면 Firebase 콘솔 과 열려 있는 Unity 프로젝트 모두에서 작업이 필요합니다(예: 콘솔에서 Firebase 구성 파일을 다운로드한 다음 Unity 프로젝트로 이동).

동적 링크 URI 프리픽스 설정

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

  2. 아직 서비스 약관에 동의하지 않았고 동적 링크에 대한 URI 접두사를 설정하지 않은 경우 메시지가 표시되면 그렇게 하세요.

    동적 링크 URI 접두사가 이미 있는 경우 기록해 둡니다. 프로그래밍 방식으로 동적 링크를 만들 때 동적 링크 URI 접두사를 제공해야 합니다.

  3. 권장 : 딥 링크 및 대체 링크에서 허용되는 URL 패턴을 지정합니다. 이렇게 하면 권한이 없는 당사자가 도메인에서 제어하지 않는 사이트로 리디렉션되는 동적 링크를 생성하지 못하도록 방지할 수 있습니다. 화이트리스트 URL 패턴을 참조하십시오.

Firebase 콘솔 사용

테스트 목적으로 또는 마케팅 팀이 소셜 미디어 게시물과 같은 항목에서 사용할 수 있는 링크를 쉽게 만들기 위해 단일 동적 링크를 생성하려는 경우 가장 간단한 방법은 Firebase 콘솔 을 방문하여 동적 링크를 만드는 것입니다. 수동으로 단계별 양식을 따릅니다.

맞춤 도메인

goo.gl 또는 page.link 하위 도메인 대신 자체 도메인을 사용하여 동적 링크의 브랜딩을 더 잘 제어할 수 있습니다. 다음 안내 에 따라 프로젝트의 맞춤 도메인을 설정하세요.

Firebase 동적 링크 API 사용

매개변수에서 긴 동적 링크 만들기

동적 링크를 만들려면 DynamicLinkComponents 개체를 만들고 추가 구성을 위한 선택적 멤버를 설정한 다음 LongDynamicLink 속성에 액세스하여 링크 URL을 가져옵니다.

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

var components = new Firebase.DynamicLinks.DynamicLinkComponents(
    // The base Link.
    new System.Uri("https://www.example.com/"),
    // The dynamic link URI prefix.
    "https://example.page.link") {
      IOSParameters = new Firebase.DynamicLinks.IOSParameters("com.example.ios"),
      AndroidParameters = new Firebase.DynamicLinks.AndroidParameters(
        "com.example.android.package_name"),
    };
// do something with: components.LongDynamicLink

짧은 동적 링크 만들기

짧은 동적 링크를 만들려면 이전에 생성한 긴 링크를 Firebase.DynamicLinks.GetShortLinkAsync 에 전달하거나 위와 동일한 방식으로 DynamicLinkComponents 를 빌드합니다.

GetShortLinkAsync 는 선택적으로 PathLength 속성과 함께 추가 DynamicLinkOptions 구성 매개 변수를 사용하여 링크 생성 방법을 제어할 수 있습니다. 짧은 링크를 생성하려면 Firebase 백엔드에 대한 네트워크 요청이 필요하므로 GetShortLinkAsync 메서드가 비동기적으로 실행됩니다. GetShortLinkAsyncTask<Firebase.DynamicLinks.ShortDynamicLink> 를 반환합니다.

예를 들어:

var options = new Firebase.DynamicLinks.DynamicLinkOptions {
  PathLength = DynamicLinkPathLength.Unguessable
};

Firebase.DynamicLinks.DynamicLinks.GetShortLinkAsync(components, options).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("GetShortLinkAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("GetShortLinkAsync encountered an error: " + task.Exception);
    return;
  }

  // Short Link has been created.
  Firebase.DynamicLinks.ShortDynamicLink link = task.Result;
  Debug.LogFormat("Generated short link {0}", link.Url);

  var warnings = new System.Collections.Generic.List<string>(link.Warnings);
  if (warnings.Count > 0) {
    // Debug logging for warnings generating the short link.
  }
});

위의 예에서는 작업이 완료될 때 트리거되는 람다 식을 사용합니다.

,

Firebase 동적 링크 API를 사용하여 짧거나 긴 동적 링크를 만들 수 있습니다. API는 몇 가지 선택적 매개변수 구조를 사용하여 링크를 구축합니다. 이전에 생성된 긴 링크에서 짧은 링크를 만들 수도 있습니다. Dynamic Links API는 다음과 같은 URL을 생성합니다.

https://example.page.link/aSDf

시작하기 전에

Firebase 동적 링크 를 사용하려면 먼저 다음을 수행해야 합니다.

  • Unity 프로젝트를 등록하고 Firebase를 사용하도록 구성합니다.

    • Unity 프로젝트에서 이미 Firebase를 사용하고 있다면 이미 Firebase용으로 등록 및 구성된 것입니다.

    • Unity 프로젝트가 없는 경우 샘플 앱 을 다운로드할 수 있습니다.

  • Unity 프로젝트에 Firebase Unity SDK (구체적으로 FirebaseDynamicLinks.unitypackage )를 추가합니다.

Unity 프로젝트에 Firebase를 추가하려면 Firebase 콘솔 과 열려 있는 Unity 프로젝트 모두에서 작업이 필요합니다(예: 콘솔에서 Firebase 구성 파일을 다운로드한 다음 Unity 프로젝트로 이동).

동적 링크 URI 프리픽스 설정

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

  2. 아직 서비스 약관에 동의하지 않았고 동적 링크에 대한 URI 접두사를 설정하지 않은 경우 메시지가 표시되면 그렇게 하세요.

    동적 링크 URI 접두사가 이미 있는 경우 기록해 둡니다. 프로그래밍 방식으로 동적 링크를 만들 때 동적 링크 URI 접두사를 제공해야 합니다.

  3. 권장 : 딥 링크 및 대체 링크에서 허용되는 URL 패턴을 지정합니다. 이렇게 하면 권한이 없는 당사자가 도메인에서 제어하지 않는 사이트로 리디렉션되는 동적 링크를 생성하지 못하도록 방지할 수 있습니다. 화이트리스트 URL 패턴을 참조하십시오.

Firebase 콘솔 사용

테스트 목적으로 또는 마케팅 팀이 소셜 미디어 게시물과 같은 항목에서 사용할 수 있는 링크를 쉽게 만들기 위해 단일 동적 링크를 생성하려는 경우 가장 간단한 방법은 Firebase 콘솔 을 방문하여 동적 링크를 만드는 것입니다. 수동으로 단계별 양식을 따릅니다.

맞춤 도메인

goo.gl 또는 page.link 하위 도메인 대신 자체 도메인을 사용하여 동적 링크의 브랜딩을 더 잘 제어할 수 있습니다. 다음 안내 에 따라 프로젝트의 맞춤 도메인을 설정하세요.

Firebase 동적 링크 API 사용

매개변수에서 긴 동적 링크 만들기

동적 링크를 만들려면 DynamicLinkComponents 개체를 만들고 추가 구성을 위한 선택적 멤버를 설정한 다음 LongDynamicLink 속성에 액세스하여 링크 URL을 가져옵니다.

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

var components = new Firebase.DynamicLinks.DynamicLinkComponents(
    // The base Link.
    new System.Uri("https://www.example.com/"),
    // The dynamic link URI prefix.
    "https://example.page.link") {
      IOSParameters = new Firebase.DynamicLinks.IOSParameters("com.example.ios"),
      AndroidParameters = new Firebase.DynamicLinks.AndroidParameters(
        "com.example.android.package_name"),
    };
// do something with: components.LongDynamicLink

짧은 동적 링크 만들기

짧은 동적 링크를 만들려면 이전에 생성한 긴 링크를 Firebase.DynamicLinks.GetShortLinkAsync 에 전달하거나 위와 동일한 방식으로 DynamicLinkComponents 를 빌드합니다.

GetShortLinkAsync 는 선택적으로 PathLength 속성과 함께 추가 DynamicLinkOptions 구성 매개 변수를 사용하여 링크 생성 방법을 제어할 수 있습니다. 짧은 링크를 생성하려면 Firebase 백엔드에 대한 네트워크 요청이 필요하므로 GetShortLinkAsync 메서드가 비동기적으로 실행됩니다. GetShortLinkAsyncTask<Firebase.DynamicLinks.ShortDynamicLink> 를 반환합니다.

예를 들어:

var options = new Firebase.DynamicLinks.DynamicLinkOptions {
  PathLength = DynamicLinkPathLength.Unguessable
};

Firebase.DynamicLinks.DynamicLinks.GetShortLinkAsync(components, options).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("GetShortLinkAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("GetShortLinkAsync encountered an error: " + task.Exception);
    return;
  }

  // Short Link has been created.
  Firebase.DynamicLinks.ShortDynamicLink link = task.Result;
  Debug.LogFormat("Generated short link {0}", link.Url);

  var warnings = new System.Collections.Generic.List<string>(link.Warnings);
  if (warnings.Count > 0) {
    // Debug logging for warnings generating the short link.
  }
});

위의 예에서는 작업이 완료될 때 트리거되는 람다 식을 사용합니다.