Temel bilgiler

Akıllı bağlantılar ve yönlendirmeler

Akıllı bağlantın mapps.one/habitly, her ziyaretçinin cihazına bakar ve onu nereye göndereceğine birkaç milisaniyede karar verir. Bu sayfada varsayılan kuralları, bunları nasıl değiştireceğini, bağlantı önizleme botlarının ne gördüğünü ve kampanya etiketlerinin mağazalara nasıl aktarıldığını anlatıyoruz.

Varsayılan yönlendirme

Ziyaretçi	Gideceği yer	O bağlantı yoksa
iPhone, iPad, iPod	App Store	Açılış sayfası
Android	Google Play	Açılış sayfası
Huawei ve Honor cihazlar, HarmonyOS	AppGallery	Önce Google Play, sonra açılış sayfası
Windows	Microsoft Store	Açılış sayfası
macOS	App Store	Açılış sayfası
Tanınmayan cihazlar ("Diğer")	Açılış sayfası	—
Linux ve ChromeOS	Açılış sayfası	—

Cihaz, tarayıcının kullanıcı aracısından (user agent) anlaşılır. Tabletler aynı işletim sistemini kullanan telefonlarla aynı kurallara uyar. Masaüstü sitesi isteyen iPad'ler kendini Mac olarak tanıtır; macOS varsayılan olarak App Store'a gittiği için bu ziyaretçiler yine App Store'a ulaşır.

Yönlendirme kuralları

Uygulamanın Bağlantılar sekmesinde şu platformların her biri için bir hedef seçebilirsin: iOS, Android, Huawei, Windows, macOS ve Diğer. Seçenekler:

App Store, Google Play, AppGallery ya da Microsoft Store: o mağaza sayfasına yönlendirir,
Web adresi: uygulamada kayıtlı web adresine yönlendirir; örneğin web sürümüne ya da bekleme listesine,
Açılış sayfası: akıllı bağlantı adresinde açılış sayfasını gösterir.

Seçtiğin hedef için kayıtlı bir bağlantı yoksa yedek hedef kullanılır: Huawei ziyaretçileri önce Google Play'i, sonra açılış sayfasını dener; diğer herkes açılış sayfasını görür. Paneldeki kural önizlemesi her platformun şu anda nereye gittiğini gösterir ve yedek hedef kullanan satırları işaretler.

Örnek: Habitly'nin Mac uygulaması yok. macOS'u Açılış sayfası olarak ayarlarsan Mac ziyaretçileri, Mac App Store'daki iPhone sayfası yerine ekran görüntülerini ve iki mağaza rozetini görür.

Yönlendirmeler Cache-Control: no-store başlığıyla HTTP 302 olarak yapılır. Tarayıcılar ve proxy'ler bunları önbelleğe almaz, bu yüzden kural değişiklikleri bir sonraki ziyarette geçerli olur.

Bağlantı önizlemeleri ve botlar

Biri bağlantını bir sohbete ya da paylaşıma yapıştırdığında, uygulama önizleme oluşturmak için sayfayı çeker. Bu tarayıcı botları hiçbir zaman yönlendirilmez, her zaman açılış sayfasını alır. Böylece önizlemede sayfanın Open Graph etiketlerinden gelen uygulama adın, sloganın ve görselin görünür. Facebook, Instagram, WhatsApp, X, LinkedIn, Slack, Discord, Telegram, iMessage, Pinterest, Reddit, Mastodon, Bluesky, Snapchat, Skype, Zoom ve Microsoft Teams bunlardan bazıları.

Arama motoru botları, SEO araçları, çalışma süresi izleyicileri, yapay zeka botları ve curl, wget, python-requests gibi komut satırı istemcileri de bot sayılır. Botlar açılış sayfasını alır ve analitikte hiçbir zaman sayılmaz.

Uygulama içi tarayıcılar

Instagram, Facebook, TikTok, X, LinkedIn, Snapchat, Pinterest, LINE, Telegram, WeChat, Reddit ve Threads içinde açılan bağlantılar tanınır. Ziyaretçi, diğer ziyaretler gibi cihazına göre yönlendirilir. Bu tarayıcılar genellikle yönlendiren adres (referrer) göndermese de analitikte ziyaretçinin geldiği uygulama trafik kaynağı olarak kaydedilir.

Kampanya etiketleri

Kanalları karşılaştırmak için akıllı bağlantına standart UTM etiketleri ekle:

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

mapps.one, utm_source, utm_medium ve utm_campaign değerlerini her zaman analitiğine kaydeder. Kampanya parametrelerini mağazalara aktar seçeneği açıksa (varsayılan olarak açık) etiketler hedefe, o hedefin anladığı biçimde de iletilir:

Hedef	Eklediğimiz
Google Play	URL kodlu UTM etiketlerini içeren bir `referrer` parametresi. Uygulaman bunu Play Install Referrer API ile okuyabilir. `https://play.google.com/store/apps/details?id=com.habitly.app&referrer=utm_source%3Dinstagram%26utm_medium%3Dsocial%26utm_campaign%3Dlaunch`
App Store	Bir `ct` kampanya belirteci: `utm_campaign` değeri, kampanya yoksa `utm_source` değeri; en fazla 40 karakter. `https://apps.apple.com/app/id1612345678?ct=launch`
Web adresi	UTM etiketlerinin kendisi. `https://habitly.app/?utm_source=instagram&utm_medium=social&utm_campaign=launch`
AppGallery, Microsoft Store	Hiçbir şey. Mağaza sayfası ek parametre olmadan açılır.

Beş etiketin hepsi aktarılır: utm_source, utm_medium, utm_campaign, utm_term ve utm_content. Her değer 100 karakterde kesilir.

App Store kampanyaları hakkında: App Store Connect bir ct belirtecini yalnızca bağlantıda sağlayıcı belirtecin (pt) de varsa kampanyaya bağlar. Mağaza bağlantıları standart biçimde kaydedildiği için App Store bağlantına yapıştırdığın pt korunmaz. Kanalları karşılaştırmak için mapps.one analitiğindeki kampanya kırılımını kullan.

Mağaza rozeti bağlantıları

Açılış sayfasındaki mağaza rozetleri takip edilen bir yönlendirmeye gider: mapps.one/habitly/go/{mağaza}. Tıklama mağaza tıklaması olarak sayılır, ardından ziyaretçi mağaza sayfasına gönderilir. Uygulamanın o mağaza için bir bağlantısı yoksa ziyaretçi açılış sayfasına geri döner.

Cihazdan bağımsız olarak belirli bir mağazayı açmak istediğinde, örneğin yalnızca Android'e yönelik bir kampanyada, bu adresleri kendin de kullanabilirsin. /go/ adresine eklediğin UTM etiketleri akıllı bağlantıdakiyle aynı şekilde aktarılır.

Mağaza anahtarı	Adres
`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`

Adres başvurusu

Adres	Amaç
`/habitly`	Akıllı bağlantı: cihaza göre yönlendirme ya da açılış sayfası
`/habitly/page`	Her cihazda açılış sayfası
`/habitly/go/{mağaza}`	Tek bir mağazaya takip edilen yönlendirme
`/habitly/open/{yol}`	Yüklü uygulamaya derin bağlantı
`/habitly/privacy`, `/habitly/privacy/{dil}`	Gizlilik politikası
`/habitly/terms`, `/habitly/terms/{dil}`	Kullanım koşulları
`/habitly/press`, `/habitly/press.zip`	Basın kiti sayfası ve indirme dosyası
`/habitly/qr.svg`, `/habitly/qr.png`	Akıllı bağlantının QR kodu

Bağlantı çalışmıyorsa

404 Bulunamadı: bu bağlantı adını kullanan bir uygulama yok. Yazımı ya da bağlantı adının değiştirilip değiştirilmediğini kontrol et.
410, "duraklatıldı": uygulama panelden duraklatılmış. Yeniden aç.
410, "artık kullanılamıyor": uygulama güven ve güvenlik ekibi tarafından askıya alınmış. Destekle iletişime geç.
Hep açılış sayfası geliyor: platformun hedefi için kayıtlı bağlantı yok, kural Açılış sayfası olarak ayarlı ya da bot gibi görünen bir istemciyle deniyorsun.