Menyiapkan domain kustom untuk Dynamic Link

Anda dapat memiliki kontrol yang lebih baik atas branding Dynamic Links dengan menggunakan domain Anda sendiri, bukan subdomain page.link. Dengan domain kustom, Anda dapat membuat Dynamic Links seperti contoh berikut:

https://example.com/link-suffix
https://example.com/links/promos/link-suffix
https://links.example.com/link-suffix
https://ex.amp.le/link-suffix

Bagian URL sebelum link-suffix disebut awalan URL, dan berisi domain Dynamic Link kustom serta awalan jalur. Anda harus menyediakan awalan URL saat membuat Dynamic Links.

Menyiapkan domain kustom membutuhkan izin Editor atau Pemilik di project Firebase Anda.

Menggunakan domain web Anda untuk Dynamic Links

Anda dapat menggunakan domain yang sama untuk Dynamic Links dan halaman web, Universal Links, dan App Links. Namun, jika melakukan tindakan ini, Anda harus memastikan bahwa URL Dynamic Link tidak bertentangan dengan URL web. Saat mengonfigurasi Dynamic Links untuk menggunakan awalan URL tertentu, semua URL yang diawali dengan awalan tersebut akan diperlakukan sebagai Dynamic Links. Jadi, Anda tidak dapat menggunakan URL dengan awalan tersebut untuk mengarah ke konten yang dihosting biasa.

Misalnya, jika Anda ingin membuat Dynamic Link ke resource https://example.com/my-resource (halaman web, Universal Link, atau App Link), Anda tidak dapat menggunakan https://example.com/ sebagai awalan URL Dynamic Links karena akan menyebabkan https://example.com/my-resource diperlakukan sebagai Dynamic Link. Sebagai gantinya, Anda harus menggunakan awalan URL dengan domain yang berbeda atau awalan lokasi yang berbeda.

Jadi, Dynamic Links bentuk panjang berikut (dan link pendeknya yang setara) tidak akan berfungsi seperti yang diinginkan karena URL yang ditentukan oleh parameter link diawali dengan awalan URL Dynamic Link, https://example.com/:

 https://example.com/?link=https://example.com/my-resource
 https://example.com/?link=https://example.com/resources/my-resource

Namun, Dynamic Links bentuk panjang berikut (dan link pendeknya yang setara) dapat berfungsi karena awalan URL-nya tidak bertentangan dengan URL link:

 https://link.example.com/?link=https://example.com/my-resource
 https://example.com/links/?link=https://example.com/my-resource
 https://ex.amp.le/?link=https://example.com/my-resource

Menyiapkan domain kustom di Firebase console

Anda biasanya dapat menyiapkan domain kustom sepenuhnya di Firebase console. Untuk melakukannya:

Jika Anda belum menyiapkan Firebase Hosting untuk project Anda, buka halaman Hosting di Firebase console, klik Mulai, lalu klik petunjuk penyiapan. Anda tidak harus menyelesaikan langkah-langkah yang ditunjukkan saat ini.
Buka halaman Dynamic Links di Firebase console.
Jika Anda belum pernah menggunakan Dynamic Links, klik Mulai. Jika sudah pernah, klik Tambahkan awalan URL dari menu drop-down.

Kemudian, selesaikan wizard penyiapan, dengan menentukan domain dan awalan jalur yang ingin Anda gunakan saat diminta.

Catatan: Anda tidak dapat menggunakan awalan URL yang sama untuk Dynamic Links dan hosting reguler. Jika Anda ingin menggunakan branding yang sama untuk keduanya, pertimbangkan untuk menggunakan awalan jalur (misalnya, example.com/links) atau subdomain (links.example.com/) di awalan URL Dynamic Links Anda.
Khusus iOS: Di file Info.plist project Xcode, buat kunci dengan nama FirebaseDynamicLinksCustomDomains, lalu tetapkan ke awalan URL Dynamic Links aplikasi Anda. Contoh:
```
<key>FirebaseDynamicLinksCustomDomains</key>
<array>
  <string>https://example.com/link</string>
  <string>https://example.com/promos</string>
</array>
```

Menyiapkan domain kustom secara manual

Di beberapa situasi, misalnya jika Anda sudah menyiapkan domain kustom untuk Dynamic Links dan ingin menambahkan domain lain, atau jika Anda menambahkan domain yang sudah terhubung ke situs Hosting, Anda harus menyiapkan domain kustom secara manual.

Untuk melakukannya:

Hubungkan domain Anda ke Firebase Hosting jika Anda belum melakukannya.

Penyiapan domain dengan Firebase Hosting meliputi pembuatan file konfigurasi firebase.json di direktori project lokal Anda.
Update ke FirebaseCLI versi terbaru (v6.5.0 atau yang lebih baru).
Konfigurasikan situs Hosting untuk Dynamic Links di file firebase.json project Anda. Jika project memiliki beberapa situs, pastikan Anda mengonfigurasi situs yang terhubung ke domain yang ingin digunakan.
- Tetapkan appAssociation ke AUTO. Dengan setelan ini, Hosting menghasilkan file assetlinks.json dan apple-app-site-association secara dinamis saat diminta.
- Tentukan awalan jalur yang ingin Anda gunakan untuk Dynamic Links dengan menetapkan aturan penulisan ulang menggunakan dynamicLinks yang ditetapkan ke true. Permintaan ke jalur ini akan yang di-proxy-kan ke Dynamic Links.
  
  Tidak seperti aturan yang menulis ulang jalur ke URL, aturan penulisan ulang Dynamic Link tidak dapat berisi ekspresi reguler.
  
  Jika Anda memiliki beberapa aturan penulisan ulang untuk situs Anda, perhatikan bahwa Hosting menjalankan aturan penulisan ulang pertama yang sesuai dengan permintaan.
Contoh:
```
"hosting": {
  // ...
  "appAssociation": "AUTO",
  "rewrites": [
    {
      "source": "/promos/**",
      "dynamicLinks": true
    },
    {
      "source": "/links/share/**",
      "dynamicLinks": true
    }
  ]
}
```
Dengan konfigurasi di atas, Anda dapat membuat Dynamic Links dengan awalan URL seperti contoh berikut:
```
https://your-domain/promos/link-suffix
https://your-domain/links/share/link-suffix
```
Catatan: Anda tidak dapat menggunakan awalan URL yang sama untuk Dynamic Links dan hosting reguler. Jika Anda ingin menggunakan branding yang sama untuk keduanya, pertimbangkan untuk menggunakan awalan jalur (misalnya, example.com/links) atau subdomain (links.example.com/) di awalan URL Dynamic Links Anda.

Jika Anda menggunakan domain ini hanya untuk Dynamic Links, Anda dapat menggunakan jalur sumber /** untuk membuat Dynamic Links tanpa awalan jalur:
```
{
  "source": "/**",
  "dynamicLinks": true
}
```
Dengan aturan di atas, Anda dapat membuat Dynamic Links seperti contoh berikut:
```
https://your-domain/link-suffix
```
Deploy perubahan konfigurasi Hosting Anda:
```
firebase deploy --only hosting
```
(opsional) Anda dapat memeriksa konten firebase.json yang di-deploy menggunakan Hosting REST API.
Khusus iOS: Di file Info.plist project Xcode, buat kunci dengan nama FirebaseDynamicLinksCustomDomains, lalu tetapkan ke awalan URL Dynamic Links aplikasi Anda. Contoh:
```
<key>FirebaseDynamicLinksCustomDomains</key>
<array>
  <string>https://example.com/promos</string>
  <string>https://example.com/links/share</string>
</array>
```

Urutan prioritas untuk Dynamic Links dan Hosting

Untuk Dynamic Links, perhatikan urutan prioritas hosting.

Pastikan awalan URL Dynamic Links Anda tidak bertentangan dengan konfigurasi hosting dengan prioritas yang lebih tinggi (misalnya, konten statis yang dihosting selalu memiliki prioritas yang lebih tinggi dibandingkan penulisan ulang).
Dalam atribut rewrites, respons Hosting akan mematuhi aturan yang ditentukan oleh glob source pertama yang menangkap jalur yang diminta.

Misalnya, jika Anda menyiapkan Dynamic Link untuk your-domain/source-path/link-suffix, tetapi Anda juga memiliki konten statis di your-domain/source-path/index.html, konten statis akan lebih diprioritaskan. Pengguna akhir akan melihat index.html, bukan Dynamic Link. Demikian pula, jika Anda memiliki konten statis di your-domain/source-path/link-suffix, pengguna akhir akan melihat konten statis tersebut, bukan Dynamic Link.

Jika Anda ingin menggunakan branding yang sama untuk Dynamic Links dan Hosting, pertimbangkan salah satu opsi berikut untuk awalan URL Dynamic Links Anda:

Tetapkan atribut source Anda agar cocok dengan awalan jalur. Misalnya, jika Anda memiliki domain kustom example.com, aturan penulisan ulang Anda adalah:

// Domain is example.com
"rewrites": [ {
  "source": "/links/**",  // Dynamic Links start with "https://example.com/links/"
  "dynamicLinks": true
} ]

Siapkan subdomain yang akan digunakan untuk Dynamic Links, lalu tetapkan atribut source agar cocok dengan subdomain tersebut. Misalnya, jika Anda memiliki subdomain links.example.com, aturan penulisan ulang Anda adalah:
```
// Domain is links.example.com
"rewrites": [ {
  "source": "/**",  // Dynamic Links start with "https://links.example.com/"
  "dynamicLinks": true
} ]
```