Deep Linking

​

Genel Bakış

• Deep link türleri ve her birinin ne zaman kullanılacağı
• Android ve iOS için platform kurulumu
• OneSignal SDK ile uygulamanızda deep link’lerin işlenmesi
• Push, e-posta ve uygulama içi mesajlar için kanala özgü davranış

​

Ön Koşullar

• Yapılandırılmış bir uygulamayla birlikte bir OneSignal hesabı
• Mobil uygulamanızda yüklü OneSignal SDK
• Universal Links veya App Links için HTTPS üzerinden barındırılan, kontrolünüzdeki bir alan adı
• Uygulamanızın kaynak koduna ve derleme yapılandırmasına erişim (iOS için Xcode, Android için Android Studio)

​

Deep link türleri

​

Android kurulumu (App Links)

​

Intent filtrelerini yapılandırma

<activity android:name=".DeepLinkActivity" android:exported="true">
  <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="yourdomain.com" />
  </intent-filter>
</activity>

​

Gelen intent’i işleme

Intent appLinkIntent = getIntent();
String appLinkAction = appLinkIntent.getAction();
Uri appLinkData = appLinkIntent.getData();

​

Digital Asset Links dosyasını barındırma

https://yourdomain.com/.well-known/assetlinks.json

​

iOS kurulumu (Universal Links)

​

Associated Domains’i etkinleştirme

1. Xcode’da hedefi seçin → Signing & Capabilities → Associated Domains ekleyin
2. Alan adınızı ekleyin: applinks:yourdomain.com

​

Uygulamanızda Universal Link’i işleme

func application(_ application: UIApplication,
                 continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
        let url = userActivity.webpageURL else {
    return false
  }
  // Route to the correct screen based on the URL path
  return true
}

​

Apple App Site Association dosyasını barındırma

https://yourdomain.com/.well-known/apple-app-site-association

{
  "applinks": {
    "apps": [],
    "details": [{
      "appID": "TEAMID.com.example.app",
      "paths": ["/path/*", "/another-path"]
    }]
  }
}

​

iOS Launch URL davranışı

1. API yükünde url yerine data kullanın ve deep link’i Push Bildirimi Tıklama Dinleyicisi’nde işleyin
2. Info.plist’e OneSignal_suppress_launch_urls’i Boolean olarak YES değeriyle ekleyerek Launch URL’leri bastırın, ardından tüm gezinmeyi tıklama dinleyicisinde işleyin

​

Deep link’leri OneSignal SDK ile işleme

​

Push bildirimi tıklama dinleyicisi

OneSignal.Notifications.addClickListener { event ->
  val url = event.notification.launchURL
  val data = event.notification.additionalData
  // Route to the correct screen based on url or data
}

​

Uygulama içi mesaj tıklama dinleyicisi

OneSignal.InAppMessages.addClickListener { event ->
  val actionId = event.result.actionId
  // Route based on the action ID (your deep link URI)
}

​

Push bildirimleri

​

Platform davranışı

• Android: App Links aracılığıyla eşleşen Activity’yi doğrudan açar
• iOS: Safari’yi açar, ardından uygulamayı açar (Launch URL’leri bastırıp tıklama dinleyicisinde gezinmeyi işlemediğiniz sürece)

​

E-postalar

​

E-postada deep link’leri etkinleştirme

• Dashboard: E-posta editöründe Track link clicks seçeneğinin işaretini kaldırın
• API: disable_email_click_tracking: true ayarlayın
• Bağlantı başına: Diğerleri için etkin tutarken tek tek bağlantılarda takibi devre dışı bırakmak için {{ 'https://yourdomain.com/path' | do_not_track_link }} Liquid filtresini kullanın

​

E-posta deep link davranışı

​

Uygulama içi mesajlar

​

Sürükle ve bırak editörü

1. Bir buton veya tıklanabilir öğe ekleyin
2. Tıklama eylemini Custom Action ID olarak ayarlayın
3. Deep link URI’nizi Action Name olarak girin (örneğin, https://yourdomain.com/promo veya myapp://promo)

​

HTML editörü

​

Tıklamayı işleme

​

Deep link’leri test etme

​

Android

adb shell am start -a android.intent.action.VIEW \
  -d "https://yourdomain.com/path" \
  com.your.package

curl -I https://yourdomain.com/.well-known/assetlinks.json

​

iOS

1. Bağlantıyı Notes uygulamasına yapıştırın
2. “Uygulamada Aç” seçeneğinin göründüğünü onaylamak için bağlantıya uzun basın
3. Uygulamanızın açıldığını doğrulamak için bağlantıya dokunun

​

OneSignal test mesajları

1. OneSignal dashboard’dan Launch URL olarak veya Ek Veri içinde bir deep link URL’si ile test push’u gönderin
2. Bildirimin uygulamanızdaki doğru ekranı açtığını doğrulayın
3. URL veya verinin alındığını onaylamak için tıklama dinleyici günlüklerinizi kontrol edin

​

Sorun Giderme

​

iOS deep link’i uygulama yerine Safari’yi açıyor

• AASA dosyası doğru barındırılmamış — https://yourdomain.com/.well-known/apple-app-site-association adresinde Content-Type: application/json ile ve yönlendirme olmadan erişilebilir olduğunu doğrulayın
• Associated Domains yapılandırılmamış — Xcode → Signing & Capabilities → Associated Domains’in applinks:yourdomain.com içerip içermediğini kontrol edin
• Launch URL davranışı — OneSignal’ın iOS SDK’sı url özelliği için openURL kullanır, bu da tarayıcı öncelikli davranışı tetikler. Bunun yerine data + tıklama dinleyicisi kullanın veya Launch URL’leri bastırın
• Safari’de test etme — Universal Links, Safari adres çubuğundan etkinleşmez. Notes, Mail veya başka bir uygulamadan test edin.

​

Android deep link’i tarayıcıyı açıyor

• autoVerify eksik — Intent filtrenizin android:autoVerify="true" içerdiğinden emin olun
• assetlinks.json bulunamıyor — Dosyanın https://yourdomain.com/.well-known/assetlinks.json adresinde olduğunu ve HTTP 200 döndürdüğünü doğrulayın
• SHA256 parmak izi uyuşmazlığı — assetlinks.json içindeki parmak izi, uygulamanızın imzalama sertifikasıyla eşleşmelidir. Hata ayıklama ve sürüm derlemeleri farklı sertifikalar kullanır.

​

Deep link push’ta çalışıyor ama e-postada çalışmıyor

​

Deep link alındı ama uygulama yönlendirmiyor

• Tıklama dinleyicinizin uygulama yaşam döngüsünün başında kayıtlı olduğunu doğrulayın (örneğin, Application.onCreate() veya AppDelegate.didFinishLaunchingWithOptions içinde)
• URL veya eylem kimliğinin yönlendirme mantığınızın beklediğiyle eşleştiğini kontrol edin
• iOS’ta, Launch URL’leri bastırmadan url’ye güvenmediğinizi onaylayın — tarayıcı, dinleyiciniz tetiklenmeden önce bağlantıyı tüketebilir

​

SSS

​

Uygulama yüklü değilse ne olur?

​

Deep linking için Launch URL mi yoksa Ek Veri mi kullanmalıyım?

​

Deep link’leri kullanıcı verileriyle kişiselleştirebilir miyim?

​

Özel URI şemalarıyla deep link kullanabilir miyim?

​

Deep link’ler OneSignal Journeys ile çalışır mı?