Dasar-dasar

Smart link dan pengalihan

Smart link Anda, mapps.one/habitly, memeriksa perangkat setiap pengunjung dan menentukan ke mana harus mengarahkannya dalam hitungan milidetik. Halaman ini menjelaskan aturan default, cara mengubahnya, apa yang dilihat bot pratinjau link, dan bagaimana tag kampanye diteruskan ke store.

Perutean default

Pengunjung	Diarahkan ke	Jika link tersebut tidak ada
iPhone, iPad, iPod	App Store	Landing page
Android	Google Play	Landing page
Perangkat Huawei dan Honor, HarmonyOS	AppGallery	Google Play, lalu landing page
Windows	Microsoft Store	Landing page
macOS	App Store	Landing page
Perangkat tidak dikenal ("Lainnya")	Landing page	—
Linux dan ChromeOS	Landing page	—

Perangkat dideteksi dari user agent browser. Tablet mengikuti aturan yang sama dengan ponsel yang menggunakan sistem yang sama. iPad yang meminta situs desktop mengidentifikasi dirinya sebagai Mac, dan tetap diarahkan ke App Store karena macOS diarahkan ke sana secara default.

Aturan pengalihan

Buka tab Link aplikasi untuk memilih tujuan bagi setiap platform berikut: iOS, Android, Huawei, Windows, macOS, dan Lainnya. Pilihannya adalah:

App Store, Google Play, AppGallery, atau Microsoft Store: mengalihkan ke listing store tersebut,
URL Web: mengalihkan ke alamat web yang disimpan pada aplikasi, misalnya versi web atau daftar tunggu,
Landing page: menampilkan landing page di alamat smart link.

Jika tujuan yang Anda pilih tidak memiliki link tersimpan, pengunjung dialihkan ke fallback: pengunjung Huawei mencoba Google Play lalu landing page, sedangkan semua pengunjung lainnya melihat landing page. Pratinjau aturan di dashboard menampilkan ke mana setiap platform diarahkan saat ini dan menandai baris yang menggunakan fallback.

Contoh: Habitly tidak memiliki aplikasi Mac. Atur macOS ke Landing page agar pengunjung Mac melihat tangkapan layar dan kedua badge store, bukan listing iPhone di Mac App Store.

Pengalihan menggunakan HTTP 302 dengan Cache-Control: no-store, sehingga browser dan proxy tidak menyimpannya di cache dan perubahan aturan berlaku pada kunjungan berikutnya.

Pratinjau link dan bot

Saat seseorang menempelkan link Anda ke chat atau postingan, aplikasi tersebut mengambil halaman untuk membuat pratinjau. Crawler ini selalu menerima landing page, tidak pernah pengalihan, sehingga pratinjau menampilkan nama aplikasi, tagline, dan gambar dari tag Open Graph halaman. Ini mencakup Facebook, Instagram, WhatsApp, X, LinkedIn, Slack, Discord, Telegram, iMessage, Pinterest, Reddit, Mastodon, Bluesky, Snapchat, Skype, Zoom, dan Microsoft Teams, serta lainnya.

Crawler mesin pencari, alat SEO, pemantau uptime, crawler AI, dan klien command-line seperti curl, wget, atau python-requests juga diperlakukan sebagai bot. Bot mendapat landing page dan tidak pernah dihitung dalam analitik.

Browser dalam aplikasi

Link yang dibuka di dalam Instagram, Facebook, TikTok, X, LinkedIn, Snapchat, Pinterest, LINE, Telegram, WeChat, Reddit, dan Threads dikenali. Pengunjung diarahkan berdasarkan perangkat seperti kunjungan lainnya. Di analitik, aplikasi asal mereka dicatat sebagai sumber traffic, meskipun browser ini biasanya tidak mengirim referrer.

Tag kampanye

Tambahkan tag UTM standar ke smart link Anda untuk membandingkan saluran:

https://mapps.one/habitly?utm_source=instagram&utm_medium=social&utm_campaign=launch

mapps.one selalu mencatat utm_source, utm_medium, dan utm_campaign di analitik Anda. Saat Teruskan parameter kampanye ke store diaktifkan (default), tag juga diteruskan ke tujuan dalam format yang dipahaminya:

Tujuan	Yang kami tambahkan
Google Play	Parameter `referrer` yang berisi tag UTM yang di-URL-encode, yang dapat dibaca aplikasi Anda dengan Play Install Referrer API. `https://play.google.com/store/apps/details?id=com.habitly.app&referrer=utm_source%3Dinstagram%26utm_medium%3Dsocial%26utm_campaign%3Dlaunch`
App Store	Token kampanye `ct`: nilai `utm_campaign`, atau `utm_source` jika tidak ada kampanye, hingga 40 karakter. `https://apps.apple.com/app/id1612345678?ct=launch`
URL Web	Tag UTM itu sendiri. `https://habitly.app/?utm_source=instagram&utm_medium=social&utm_campaign=launch`
AppGallery, Microsoft Store	Tidak ada. Listing dibuka tanpa parameter tambahan.

Kelima tag diteruskan: utm_source, utm_medium, utm_campaign, utm_term, dan utm_content. Setiap nilai dipotong menjadi 100 karakter.

Tentang kampanye App Store: App Store Connect hanya mengaitkan token ct dengan kampanye jika link juga membawa provider token Anda (pt). Link store disimpan dalam bentuk kanonis, sehingga pt yang ditempelkan ke link App Store Anda tidak dipertahankan. Gunakan rincian kampanye di analitik mapps.one untuk membandingkan saluran.

Link badge store

Badge store di landing page mengarah ke pengalihan terlacak, mapps.one/habitly/go/{store}. Klik dihitung sebagai klik store, lalu pengunjung dikirim ke listing. Jika aplikasi tidak memiliki link untuk store tersebut, pengunjung dikembalikan ke landing page.

Anda dapat menggunakan URL ini sendiri jika menginginkan store tertentu tanpa memandang perangkat, misalnya dalam kampanye khusus Android. Tag UTM yang ditambahkan ke URL /go/ diteruskan dengan cara yang sama seperti pada smart link.

Kunci store	URL
`app_store`	`mapps.one/habitly/go/app_store`
`google_play`	`mapps.one/habitly/go/google_play`
`app_gallery`	`mapps.one/habitly/go/app_gallery`
`microsoft_store`	`mapps.one/habitly/go/microsoft_store`
`web`	`mapps.one/habitly/go/web`

Referensi URL

URL	Fungsi
`/habitly`	Smart link: pengalihan berdasarkan perangkat, atau landing page
`/habitly/page`	Landing page di setiap perangkat
`/habitly/go/{store}`	Pengalihan terlacak ke satu store
`/habitly/open/{path}`	Deep link ke aplikasi yang terpasang
`/habitly/privacy`, `/habitly/privacy/{language}`	Kebijakan privasi
`/habitly/terms`, `/habitly/terms/{language}`	Ketentuan layanan
`/habitly/press`, `/habitly/press.zip`	Halaman dan unduhan press kit
`/habitly/qr.svg`, `/habitly/qr.png`	Kode QR untuk smart link

Saat link tidak berfungsi

404 Not Found: tidak ada aplikasi yang menggunakan slug ini. Periksa ejaannya, atau apakah slug telah diubah.
410 Gone, "dijeda": aplikasi dijeda di dashboard. Aktifkan kembali.
410 Gone, "tidak lagi tersedia": aplikasi ditangguhkan oleh tim trust and safety. Hubungi dukungan.
Selalu landing page: tujuan untuk platform tersebut tidak memiliki link tersimpan, aturannya diatur ke Landing page, atau Anda menguji dengan klien yang menyerupai bot.