Dynamic Links mit Unity erstellen

Mit der Firebase Dynamic Links API können Sie kurze oder lange Dynamic Links erstellen. Die API verwendet mehrere optionale Parameterstrukturen zum Erstellen von Links. Kurze Links können auch aus einem zuvor generierten langen Link erstellt werden. Die Dynamic Links API generiert eine URL wie die folgende:

https://example.page.link/aSDf

Hinweis

Bevor Sie Firebase Dynamic Links, verwenden können, müssen Sie Folgendes tun:

  • Registrieren Sie Ihr Unity-Projekt und konfigurieren Sie es für die Verwendung von Firebase.

    • Wenn Ihr Unity-Projekt bereits Firebase verwendet, ist es bereits registriert und für Firebase konfiguriert.

    • Wenn Sie kein Unity-Projekt haben, können Sie eine Beispiel-App herunterladen.

  • Fügen Sie Ihrem Unity-Projekt das Firebase Unity SDK hinzu, insbesondere FirebaseDynamicLinks.unitypackage.

Das Hinzufügen von Firebase zu Ihrem Unity-Projekt umfasst Aufgaben in der Firebase Konsole und in Ihrem geöffneten Unity-Projekt (Sie laden beispielsweise Firebase-Konfigurationsdateien aus der Konsole herunter und verschieben sie dann in Ihr Unity-Projekt).

URI-Präfix festlegenDynamic Links

  1. Öffnen Sie in der Firebase Konsole den Dynamic Links Bereich.

  2. Wenn Sie die Nutzungsbedingungen noch nicht akzeptiert und ein URI-Präfix für Ihre Dynamic Links festgelegt haben, tun Sie dies, wenn Sie dazu aufgefordert werden.

    Notieren Sie sich das Dynamic Links URI-Präfix, falls Sie bereits eines haben. Sie müssen ein Dynamic Links URI-Präfix angeben, wenn Sie Dynamic Links programmatisch erstellen.

  3. Empfohlen: Geben Sie die in Ihren Deeplinks und Fallback-Links zulässigen URL-Muster an. So verhindern Sie, dass nicht autorisierte Parteien erstellen, die von Ihrer Domain zu Websites weiterleiten, die Sie nicht kontrollieren.Dynamic Links Weitere Informationen finden Sie unter Bestimmte URL-Muster zulassen.

Firebase Konsole verwenden

Wenn Sie einen einzelnen Dynamic Link generieren möchten, entweder zu Testzwecken oder damit Ihr Marketingteam ganz einfach einen Link erstellen kann, der beispielsweise in einem Social-Media-Beitrag verwendet werden kann, ist es am einfachsten, die Firebase Konsole zu öffnen und ihn manuell über das Schritt-für-Schritt-Formular zu erstellen.

Benutzerdefinierte Domains

Sie können die Marke Ihres Dynamic Link's besser kontrollieren, indem Sie anstelle einer goo.gl oder page.link-Subdomain Ihre eigene Domain verwenden. Folgen Sie dieser Anleitung, um eine benutzerdefinierte Domain für Ihr Projekt einzurichten.

Firebase Dynamic Links API verwenden

Langen Dynamic Link aus Parametern erstellen

Erstellen Sie ein DynamicLinkComponents-Objekt, legen Sie alle optionalen Elemente für die zusätzliche Konfiguration fest und greifen Sie dann auf die LongDynamicLink-Eigenschaft zu, um die Link-URL abzurufen.

Im folgenden Minimalbeispiel wird ein langer Dynamic Link zu „https://www.example.com/“ erstellt, der unter Android mit der Android-App „com.example.android“ und unter iOS mit der App „com.example.ios“ geöffnet wird:

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

Kurzen Dynamic Link erstellen

Wenn Sie einen kurzen Dynamic Link erstellen möchten, übergeben Sie einen zuvor generierten langen Link an Firebase.DynamicLinks.GetShortLinkAsync oder erstellen Sie DynamicLinkComponents auf dieselbe Weise wie oben.

GetShortLinkAsync akzeptiert optional einen zusätzlichen DynamicLinkOptions-Konfigurationsparameter mit der PathLength-Eigenschaft, mit der Sie steuern können, wie der Link generiert werden soll. Für die Generierung kurzer Links ist eine Netzwerkanfrage an das Firebase-Back-End erforderlich. Daher wird die Methode GetShortLinkAsync asynchron ausgeführt. GetShortLinkAsync gibt ein Task<Firebase.DynamicLinks.ShortDynamicLink> zurück.

Beispiel:

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.
  }
});

Im obigen Beispiel wird ein Lambda-Ausdruck verwendet, der ausgelöst wird, wenn die Aufgabe abgeschlossen ist.