Buka konsol

Membuat Dynamic Links dengan Unity

Anda dapat membuat Dynamic Link pendek atau panjang dengan Firebase Dynamic Links API. API ini mengambil beberapa struktur parameter opsional untuk membuat link. Link pendek juga dapat dibuat dari link panjang yang dihasilkan sebelumnya. Dynamic Links API akan menghasilkan URL seperti berikut:

https://example.page.link/aSDf

Sebelum memulai

Sebelum dapat menggunakan Firebase Dynamic Links, Anda harus:

  • Mendaftarkan project Unity Anda dan mengonfigurasikannya untuk menggunakan Firebase.

    • Jika project Unity Anda telah menggunakan Firebase, berarti project tersebut telah terdaftar dan dikonfigurasikan untuk Firebase.

    • Jika belum memiliki project Unity, Anda dapat mendownload aplikasi contoh.

  • Menambahkan Firebase Unity SDK (khususnya, FirebaseDynamicLinks.unitypackage) ke project Unity Anda.

Perlu diperhatikan bahwa menambahkan Firebase ke project Unity Anda melibatkan tugas di Firebase console dan di project Unity yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari konsol, lalu memindahkannya ke project Unity).

Menetapkan awalan URI Dynamic Links

  1. Di Firebase console, buka bagian Dynamic Links.

  2. Jika Anda belum menyetujui persyaratan layanan dan menetapkan awalan URI untuk Dynamic Links, lakukanlah saat diminta.

    Jika Anda sudah memiliki awalan URI Dynamic Links, catatlah. Anda harus menyediakan awalan URI Dynamic Links ketika membuat Dynamic Links secara terprogram.

  3. Direkomendasikan: Tentukan pola URL yang diizinkan di deep link dan link fallback. Dengan melakukan tindakan tersebut, Anda mencegah pihak yang tidak diberi otorisasi agar tidak membuat Dynamic Links, yang mengalihkan dari domain Anda ke situs yang tidak Anda kontrol. Lihat Pola URL yang diizinkan.

Menggunakan Firebase console

Jika Anda ingin membuat Dynamic Link tunggal, baik untuk tujuan pengujian, atau agar tim pemasaran Anda dapat dengan mudah membuat link untuk digunakan pada sesuatu, seperti postingan media sosial, cara yang paling mudah adalah dengan mengunjungi Firebase console dan membuatnya secara manual dengan mengikuti petunjuk langkah demi langkah.

Domain kustom

Anda dapat memiliki kontrol yang lebih besar terhadap branding Dynamic Link jika menggunakan domain milik sendiri, bukan subdomain goo.gl atau page.link. Ikuti petunjuk ini guna menyiapkan domain kustom untuk project Anda.

Menggunakan Firebase Dynamic Links API

Membuat Dynamic Link panjang dari parameter

Untuk membuat Dynamic Link, buat objek DynamicLinkComponents, dengan cara menyetel salah satu anggota opsional untuk konfigurasi tambahan, lalu mengakses properti LongDynamicLink untuk mendapatkan URL link.

Contoh minimal berikut membuat Dynamic Link panjang ke https://example.com/, yang terbuka dengan aplikasi Android Anda, yaitu com.example.android.package_name pada Android dan aplikasi com.example.ios pada 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

Membuat Dynamic Link pendek

Untuk membuat Dynamic Link pendek, teruskan link panjang yang dihasilkan sebelumnya ke Firebase.DynamicLinks.GetShortLinkAsync atau buat DynamicLinkComponents dengan cara yang sama seperti di atas.

GetShortLinkAsync secara opsional menggunakan parameter konfigurasi DynamicLinkOptions tambahan dengan properti PathLength, sehingga Anda dapat mengontrol cara membuat link. Pembuatan link pendek memerlukan permintaan jaringan ke backend Firebase, sehingga metode GetShortLinkAsync dapat dijalankan secara asinkron. GetShortLinkAsync menampilkan Task<Firebase.DynamicLinks.ShortDynamicLink>.

Sebagai contoh:

var options = new Firebase.DynamicLinks.DynamicLinkOptions {
    PathLength = DynamicLinkPathLength.Unguessable
};
Firebase.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.ShortLink 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.
  }

Contoh di atas menggunakan ekspresi lambda yang dipicu saat tugas selesai.