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, um Links zu erstellen. Kurzlinks 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 schon für Firebase registriert und konfiguriert.

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

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

Wenn Sie Firebase zu Ihrem Unity-Projekt hinzufügen, müssen Sie sowohl in der Firebase Console als auch in Ihrem offenen Unity-Projekt Aufgaben ausführen. Sie laden beispielsweise Firebase-Konfigurationsdateien aus der Console herunter und verschieben sie dann in Ihr Unity-Projekt.

Dynamic Links-URI-Präfix festlegen

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

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

    Wenn Sie bereits ein Dynamic Links-URI-Präfix haben, notieren Sie es sich. Sie müssen ein Dynamic Links-URI-Präfix angeben, wenn Sie Dynamic Links programmatisch erstellen.

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

Verwenden Sie die Firebase Console.

Wenn ihr eine einzelne Dynamic Link generieren möchtet, entweder zu Testzwecken oder damit euer Marketingteam einen Link erstellen kann, der sich beispielsweise in einem Social-Media-Post verwenden lässt, besucht am besten die Firebase-Konsole und erstellt eine manuell, indem ihr dem Schritt-für-Schritt-Formular folgt.

Benutzerdefinierte Domains

Sie können das Branding Ihrer Dynamic Link besser steuern, wenn Sie Ihre eigene Domain anstelle einer goo.gl- oder page.link-Subdomain 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

Wenn Sie einen Dynamic Link erstellen möchten, erstellen Sie ein DynamicLinkComponents-Objekt, legen Sie die optionalen Mitglieder für die zusätzliche Konfiguration fest und rufen Sie dann das Attribut LongDynamicLink auf, um die Link-URL abzurufen.

Im folgenden Minimalbeispiel wird ein langer dynamischer 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

Kurzvideo erstellen: Dynamic Link

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

GetShortLinkAsync akzeptiert optional einen zusätzlichen DynamicLinkOptions-Konfigurationsparameter mit dem Attribut PathLength, mit dem Sie steuern können, wie der Link generiert werden soll. Für die Generierung von Kurzlinks ist eine Netzwerkanfrage an das Firebase-Backend 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.