Deep link

Deep link membuka layar tertentu di dalam aplikasi Anda yang sudah terpasang, seperti tantangan, undangan referral, atau halaman produk. Jika aplikasi belum terpasang, pengunjung diarahkan ke store, sama seperti smart link Anda. Deep link tersedia di Pro, Studio, dan Seumur Hidup. Universal Links dan Android App Links juga memerlukan domain kustom, yang merupakan bagian dari Studio.

Cara kerja deep link

Tambahkan /open/ dan path di dalam aplikasi ke smart link Anda. Query string juga ikut diteruskan:

https://mapps.one/habitly/open/challenges/30-days?ref=newsletter

Fallback adalah tujuan yang akan dituju smart link Anda untuk perangkat tersebut, sesuai aturan pengalihan Anda, dengan tag UTM diteruskan. Jika platform tersebut tidak memiliki link store, fallback-nya adalah landing page. Jika deep link sama sekali belum disiapkan, atau paket tidak menyertakannya, setiap pengunjung dialihkan ke smart link.

Path dapat berisi huruf, angka, dan karakter / _ - . ~ %. Karakter lain dihapus, jadi lakukan percent-encoding untuk karakter lainnya, seperti spasi (%20).

Penyiapan

Buka tab Deep link aplikasi dan isi kolom untuk platform yang Anda dukung:

Daftarkan skema di aplikasi Anda

iOS, di Info.plist:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>habitly</string>
    </array>
  </dict>
</array>

Android, di AndroidManifest.xml:

<activity android:name=".MainActivity" android:exported="true">
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="habitly" />
  </intent-filter>
</activity>

Di aplikasi Anda, baca URL yang masuk, arahkan ke layar yang sesuai, dan baca parameter query yang Anda perlukan. Arahkan path yang tidak dikenal ke layar beranda, karena orang sering mengedit URL.

Universal Links dan Android App Links

Link berbasis skema menampilkan halaman pengalihan singkat terlebih dahulu, dan iOS mungkin meminta pengunjung untuk mengonfirmasi. Link terverifikasi melewati langkah tersebut: saat aplikasi sudah terpasang, sistem langsung membukanya. Verifikasi memerlukan domain yang hanya dimiliki aplikasi Anda, jadi fitur ini berfungsi di domain kustom Anda. Setelah get.habitly.app terhubung, mapps.one menyajikan file asosiasi untuk Anda:

File Apple mencakup setiap path di bawah /open/:

{
  "applinks": {
    "details": [
      {
        "appIDs": ["A1B2C3D4E5.com.habitly.app"],
        "components": [
          { "/": "/open/*", "comment": "Deep links created with mapps.one" }
        ]
      }
    ]
  },
  "webcredentials": { "apps": ["A1B2C3D4E5.com.habitly.app"] }
}

File Android:

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.habitly.app",
      "sha256_cert_fingerprints": [
        "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"
      ]
    }
  }
]

Setiap file mengembalikan "404 Not Found" sampai kolomnya valid: Team ID 10 karakter dan bundle ID untuk Apple, serta nama paket dengan setidaknya satu fingerprint dalam format AA:BB:... (32 pasang) untuk Android. Gunakan fingerprint kunci Play App Signing dari Play Console → App integrity, dan tambahkan juga kunci upload Anda jika Anda menguji build yang ditandatangani secara lokal. File disimpan di cache selama satu jam. Apple juga menyimpannya di cache pada servernya sendiri, jadi instal ulang aplikasi untuk menguji perubahan.

Konfigurasikan aplikasi Anda

iOS: tambahkan capability Associated Domains dengan applinks:get.habitly.app.

Android: tambahkan intent filter terverifikasi untuk domain Anda:

<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="https" android:host="get.habitly.app" android:pathPrefix="/open/" />
</intent-filter>

Lalu gunakan link seperti https://get.habitly.app/open/challenges/30-days dalam kampanye Anda. Saat aplikasi belum terpasang, browser memuat halaman dan alur fallback yang sama berjalan.

Analitik

Pembukaan dihitung dalam Pembukaan deep link saat ponsel atau tablet memuat URL /open/ dan mapps.one mencoba membuka aplikasi. Fallback ke store tidak dihitung untuk kedua kalinya. Link terverifikasi yang langsung membuka aplikasi tidak pernah sampai ke mapps.one, sehingga tidak dihitung. Gunakan analitik aplikasi Anda sendiri untuk link tersebut.