Dynamic Links mit Unity erstellen

Du kannst kurze oder lange Dynamic Links mit der Firebase Dynamic Links API erstellen. Die API zum Erstellen von Links mehrere optionale Parameterstrukturen benötigt. Kurzlinks können auch aus einem zuvor generierten langen Link erstellt werden. Dynamic Links API wird eine URL wie die folgende generiert:

https://example.page.link/aSDf

Hinweis

Vor der Verwendung Firebase Dynamic Links, sind folgende Schritte erforderlich:

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

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

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

  • 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 im Firebase-Konsole und im geöffneten Unity-Projekt (Beispiel: Sie laden Firebase-Konfigurationsdateien aus der Console herunter und in Ihr Unity-Projekt importieren.

URI-Präfix Dynamic Links festlegen

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

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

    Wenn Sie bereits das URI-Präfix Dynamic Links haben, notieren Sie es sich. Erforderliche Schritte ein Dynamic Links-URI-Präfix anzugeben, 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 Unbefugte Sie erstellen Dynamic Links, die Nutzer von Ihrer Domain zu Websites weiterleiten, die Sie nicht besuchen Steuerung. 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 für Ihr Marketingteam Links zu erstellen, die z. B. in einem Beitrag in sozialen Medien verwendet werden können, ist die einfachste Methode, sollten Sie die Firebase Console aufrufen, und erstellen Sie manuell ein Konto. Folgen Sie dazu dem Schritt-für-Schritt-Formular.

Benutzerdefinierte Domains

Sie können das Branding von Dynamic Link besser kontrollieren, indem Sie Ihr eigenes verwenden Domain anstelle einer goo.gl- oder page.link-Subdomain. Folgen Sie dieser Anleitung, um eine benutzerdefinierte Domain für Ihr Projekt einzurichten.

Firebase Dynamic Links API verwenden

Lange Dynamic Link aus Parametern erstellen

Um einen dynamischen Link zu erstellen, erstellen Sie ein DynamicLinkComponents-Objekt und legen Sie der optionalen Mitglieder für eine zusätzliche Konfiguration und greifen Sie dann auf die LongDynamicLink, um die Link-URL abzurufen.

Mit dem folgenden minimalen Beispiel wird ein langer dynamischer Link erstellt, https://www.beispiel.de/, die mit Ihrer Android-App geöffnet wird com.beispiel.android auf Android und die App com.beispiel.ios unter iOS:

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

Um einen kurzen dynamischen Link zu erstellen, übergeben Sie einen zuvor generierten langen Link an Firebase.DynamicLinks.GetShortLinkAsync oder DynamicLinkComponents bauen wie oben beschrieben.

GetShortLinkAsync verwendet optional eine zusätzliche DynamicLinkOptions-Konfiguration mit der Eigenschaft PathLength verwenden, sodass Sie steuern können, wie der Link generiert werden sollen. Für die Generierung von Kurzlinks ist eine Netzwerkanfrage an die Firebase-Back-End, sodass die Methode GetShortLinkAsync asynchron ausgeführt wird. 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 obigen Beispiel wird ein Lambda-Ausdruck verwendet, der ausgelöst wird, wenn die Aufgabe abgeschlossen.