Dynamic Links mit Unity erstellen

Mit der Firebase Dynamic Links API kannst du kurze oder lange Dynamic Links erstellen. Die API unterstützt mehrere optionale Parameterstrukturen zum Erstellen von Links. Kurze Links können auch aus zuvor generierten langen Links erstellt werden. Die Dynamic Links API generiert eine URL wie diese:

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 in Ihrem Unity-Projekt bereits Firebase verwendet wird, ist es bereits für Firebase registriert und konfiguriert.

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

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

Beachten Sie, dass das Hinzufügen von Firebase zu Ihrem Unity-Projekt sowohl Aufgaben in der Firebase-Konsole als auch in Ihrem offenen Unity-Projekt erfordert (z. B. laden Sie Firebase-Konfigurationsdateien von 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 ein 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 sich dieses. 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 Dritte Dynamic Links erstellen, die von Ihrer Domain zu Websites weiterleiten, die nicht Ihnen gehören. Weitere Informationen finden Sie unter URL-Muster für die weiße Liste.

Firebase-Konsole verwenden

Wenn Sie eine einzelne Dynamic Link generieren möchten, entweder zu Testzwecken oder damit Ihr Marketingteam auf einfache Weise einen Link erstellen kann, der z. B. in einem Beitrag in sozialen Medien verwendet werden kann, rufen Sie die Firebase Console auf und erstellen Sie manuell einen Link, der dem Schritt-für-Schritt-Formular entspricht.

Benutzerdefinierte Domains

Wenn Sie Ihre eigene Domain anstelle einer goo.gl- oder page.link-Subdomain verwenden, haben Sie mehr Kontrolle über das Branding Ihrer Dynamic Link. Folgen Sie dieser Anleitung, um eine benutzerdefinierte Domain für Ihr Projekt einzurichten.

Firebase Dynamic Links API verwenden

Lange Dynamic Link aus Parametern erstellen

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

Im folgenden Minimalbeispiel wird ein langer dynamischer Link zu https://www.beispiel.de/ erstellt, der unter Android mit der Android-App com.beispiel.android und unter iOS mit der App com.beispiel.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 du einen kurzen dynamischen Link erstellen möchtest, übergebe einen zuvor generierten langen Link an Firebase.DynamicLinks.GetShortLinkAsync oder erstelle DynamicLinkComponents auf die gleiche Weise wie oben.

GetShortLinkAsync kann optional einen zusätzlichen DynamicLinkOptions-Konfigurationsparameter mit der PathLength-Eigenschaft haben, mit dem Sie festlegen 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 GetShortLinkAsync-Methode asynchron ausgeführt. GetShortLinkAsync gibt 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 Beispiel oben wird ein Lambda-Ausdruck verwendet, der ausgelöst wird, wenn die Aufgabe abgeschlossen ist.