Universal Linkler SSS
Universal linkinizin davranışını etkileyebilecek birçok faktör vardır. Test ya da üretim aşamasında universal linkleriniz ile beklenmedik sonuçlar alıyorsanız, çözüm için bu makaleyi okuyun. Sorun hala devam ediyorsa bizimle iletişime geçin.
Genel sorunlar
URL sentaksım ya da kodlamam doğru mu?
Deeplink'iniz sizi belirtilen hedefe yönlendirmiyorsa veya bir HTTP 404 hatası veriyorsa, ilk olarak URL sentaksınızı ve kodlamanızı kontrol edin.
URL'ler genellikle bu sentaksı kullanır: scheme://host:port/path?query-string#fragment-id
URL'in her bir parçası farklı bir fonksiyona sahiptir ve değerlerin ayrılması ve tanınması için spesifik karakterler kullanır. Şema ve host, büyük veya küçük harflere duyarlı değildir, ancak query-string duyarlıdır. URL'inizin yapısındaki bir hata, olması gerektiği gibi açılmasını engelleyecektir.
Deeplink'inizi ayarlarken aşağıdaki koşullara dikkat edin:
- Zaten query parametreleri içeren bir URL query string'ine Adjust parametreleri eklediğinizde,
&kullanın. İkinci soru işaretinden (?) sonraki bilgiler dikkate alınmaz.- Doğru örnek:
https://abcd.adj.st/my?path=location&client=name&adjust_t=klm012 - Yanlış örnek:
https://z9pm.adj.st/my?path=location&client=name?adjust_t=klm012
- Doğru örnek:
- Query string'i encode'lu ise,
/ile başlatın ya da bunun birdeeplinkparametresi olduğundan emin olun.
Uygulamanız install edilmediyse ve bu gereklilikler sağlanmadıysa, adjust_t parametresi tarayıcı tarafından dikkate alınmayacaktır. Tıklamanın kaynağını bulmak için Adjust'ın bu parametreye ihtiyacı vardır. Bu parametre olmazsa, HTTP 404 error URL not found ile yanıt veririz.
Örnekler
URL'inizin nasıl yapılandırıldığına bağlı olarak, deeplink'iniz aşağıdaki davranışları sergileyebilir:
| Deeplink kurulumu | Örnek link URL'i | Davranış |
|---|---|---|
Link URL + deep_link parametresi | https://app.adjust.com/r40ncx7?deep_link=adjust%3A%2F%2F%3Fpath | Uygulamayı belirtilen uygulama-içi sayfada açar. |
| Universal link | https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7 | Uygulamayı belirtilen uygulama-içi sayfada açar. |
| Universal link | https://abcd.adj.st/?path&adjust_t=r40ncx7 | Install edilmişse uygulamayı açar, ancak belirtilen uygulama-içi sayfaya ulaşamaz. |
| Universal link | https://abcd.adj.st%3Fpath?adjust_t=r40ncx7 | Geçersizdir ve hata verir |
Attribution verilerimi ve/veya kampanya seviyelerimi neden göremiyorum?
Deeplink URL'inizden attribution ya da kampanya seviyelerinizi almıyorsanız, bu büyük olasılıkla bir yapılandırma sorunudur. Cihaz ID'si ve kampanya parametrelerinin fallback ve callback'lerde kodlama hatası nedeniyle kesilmediğinden emin olun. Örneğin, URL'lerde boşluk ya da geçersiz karakterler olmamalıdır.
Uygulamam install edilmiş olsa bile neden store'a yönlendiriliyorum?
Bu davranış tipik olarak deeplink'inizin uygulamayı açamadığını ve bizim fallback olarak store'a yönlendirdiğimizi gösterir. Bunu test etmek için aşağıdaki adımları takip edin:
Mevcut bir kullanıcı olarak universal linkler ve deep_link parametresine sahip link'ler için test yönergelerimizi takip edin.
Test başarılı olursa ve uygulama açılırsa, deeplink''in hangi ortamda tıklanıp başarısız olduğunu kontrol edin. Sonrasında, bu durumda ek parametreler gerekip gerekmediğini kontrol edin.
- Örneğin, bir JSR link'i Slack'te tıklandığında,
adjust_deeplink_js=1flag'i mevcut olmalıdır. Bu, store'a yönlendirmeden önce şemanın yüklenmesine yardımcı olur. Linkadjust_deeplink_jsflag'i varken bile çalışmazsa, Uygulama şeması Campaign Lab'e yanlış girilmiş olabilir.
- Örneğin, bir JSR link'i Slack'te tıklandığında,
Link URL'indeki fallback ya da callback'lerde bunun çalışmasını önleyebilecek kodlama hataları olmadığından emin olun. Bunlar parametrelerin düşmesine neden olurlar. Düşen parametreler, tam link'in gerektiği gibi çalışmasına engel olurlar.
Deeplink'im install'dan sonra uygulamamdaki doğru noktayı neden açmıyor?
Linkiniz uygulamanızı açıyorsa ancak doğru noktaya gitmiyorsa, sorunun kaynağının linkiniz mi yoksa uygulamanız mı olduğunu kontrol edin.
- Universal link domain'ini (
https://abcd.adj.st/) ya da şemayı (myapp://) bir web ortamında host edin ve oradan tıklayın. - Geliştiriciniz ile iletişime geçerek uygulamanızdaki path'lerin doğru yapılandırıldığından emin olun.
Adjust, deeplink'ler için gelen tıklama verilerini bir Adjust link'i ya da Adjust parametreleri eklenmiş olarak alır. Yalnızca uygulamanıza özel domain içeren direkt bir deeplink Adjust'a herhangi bir veri döndürmez.
Tıklama verilerini gönderir:
myapp://welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
https://z9pm.adj.st/welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1Tıklama verilerini göndermez:
myapp://welcomeInstall edilmiş uygulamaların tıklama verilerini almak ve deeplink reattribution'ı için, Adjust SDK içinde SDK tıklamasını entegre ettiğinizden emin olun. (iOS; Android)
Bir SDK tıklamasını tetikleyen deeplink'ler, Datascape'te tıklama olarak raporlanır.Ayrıca click callback'ini kullanarak ham verilerinizde de görünürler. Hangi tıklamaların bir deeplink SDK tıklamasından kaynaklandığının ayrıntılı bir görünümü için {is_deeplink_click} parametresini ekleyin.
Universal linkler ile olası sorunlar
Universal link'im kurulu uygulamaları neden açmıyor?
Universal linklerinizin kurulumunu doğru bir şekilde yaptığınızı kontrol edin.
Apple'ın linki hangi ortamdan açtığını kontrol edin. Apple, universal linklere yönlendirmelere Safari dışında izin vermiyor, bu nedenle ham universal link'i veya şemayı web ortamında host etmeniz gerekiyor. Örneğin,
https://abcd.adj.st/ya damyapp://. Uygulama test cihazınızda install edildiğinde, ham universal link'i ya da şemayı host ettiğiniz sayfayı ziyaret edin ve link'i seçin.
Uygulamanız açılmazsa :
- HTML test sayfanızı Safari'de açın ve Share ikonunu seçin. Uygulamanızın seçeneklerden biri olarak listelendiği "Open in…" menüsünü göreceksiniz. Bu görüntülenirse, Associated Domains yapılandırması doğru demektir ve Apple App Site Association (AASA) dosyası doğru olarak indirilmiş demektir. Bu seçeneği göremiyorsanız, uygulamanızı uninstall edip tekrar install etmeniz gerekebilir.
- Test ve üretimdeki Bundle ID'nizin aynı olduğunu doğrulayın.
- Uygulamanızın AppView'daki iOS Bundle ID App Prefix'inin doğru olduğunu kontrol edin. Ayarlar doğru yapıldığında uygulamanız hala açılmıyorsa, geliştiriciniz ile iletişime geçip universal link ve şemanın uygulama ile bağlantısını inceleyin.
target=“_blank”attribute'unun linkinizin bir parçası olup olmadığını kontrol edin:
Bu, test aşamasında uygulamanın açılmasına, ancak üretimde açılmamasına neden olabilir.
Örneğin, target=“_blank” attribute'u ile, HTML kodunuz buna benzer olabilir:
<a href="[https://abcd.adj.st](https://abcd.adj.st/)" target="_blank">Universal Link to App</a>
Bu sorunu çözmek için attribute'u aşağıdaki örnekte olduğu gibi kaldırın:
<a href="[https://abcd.adj.st](https://abcd.adj.st/)">Universal Link to App</a>
Uygulamam install edilmiş olsa bile neden store'a yönlendiriliyorum?
- Universal linkler için test yönergelerimize göz atın. Ayrıca, "Universal link'im kurulu uygulamaları neden açmıyor?" sorusunun altındaki adımları takip edin.
- Universal link çalışmadığında hangi ortamda tıklandığını kontrol edin. Bu durumda ek parametreler gerekip gerekmediğini kontrol edin.
- Örneğin, bir JSR universal link'i Slack'te tıklandığında,
adjust_deeplink_js=1flag'i mevcut olmalıdır. Bu, store'a yönlendirmeden önce şemanın yüklenmesine yardımcı olur. Linkadjust_deeplink_jsflag'i varken bile çalışmazsa, uygulama şeması AppView'daki uygulama ayarlarınıza yanlış girilmiş olabilir.
- Örneğin, bir JSR universal link'i Slack'te tıklandığında,
Deeplink'im ya da ertelenen deeplink'im install'dan sonra uygulamamdaki doğru noktayı neden açmıyor?
Linkiniz uygulamanızı açıyorsa ancak doğru noktaya gitmiyorsa, sorunun kaynağının linkiniz mi yoksa uygulamanız mı olduğunu kontrol edin.
- Universal link domain'ini (
https://abcd.adj.st/) ya da şemayı (myapp://) bir web ortamında host edin ve oradan tıklayın. - Geliştiriciniz ile iletişime geçerek uygulamanızdaki path'lerin doğru yapılandırıldığından emin olun.
Mevcut bir kullanıcı olarak doğru noktaya yönlendirildiyseniz ancak yeni bir kullanıcı olarak yanlış yere gittiyseniz, Test Konsolunu kullanarak cihazınızı inceleyin ve tıklama için attribute edilip edilmediğinizi kontrol edin. Attribute edilmediyseniz, Test Konsolunu kullanarak cihazı "unutun" ve tekrar deneyin.
Tıklama için attribute edildiyseniz, cihazı inceleyin ve bir deeplink parametresi olup olmadığını kontrol edin. Parametre yoksa, encoding hataları ya da özel karakterlerin URL'i deeplink parametresinden önce kesmediğinden emin olun.
Son olarak, bir deeplink parametresi eklenmişse, path'in olup olmadığını kontrol edin. Path yoksa, bir nedenden dolayı kesilmiş demektir. Destek için support@adjust.com adresiyle iletişime geçin.
Universal link'im Facebook ya da Instagram post'larından neden çalışmıyor?
Universal linkinize bir path eklendiğinden emin olun. Yoksa, uygulama cihazda olsa bile kullanıcı store'a götürülür. Verilen path geçerli olmak zorunda değildir.
Path eklenmiş bir parametre örneği: https://abcd.adj.st/path?adjust_t=abc123
E-posta kampanyalarımda universal linkler kulanabilir miyim?
iOS, Safari dışındaki universal linkler ile yeniden yönlendirmeye çoğu zaman izin vermez. Bu, SFSafariViewController kullanan ortamların etkilendiği anlamına gelir.
Universal linklerin bulunduğu e-postanın açılabileceği,desteklemeyen tarayıcılar ya da farklı e-posta uygulamaları gibi birçok farklı ortam vardır. Bu yüzden, JSR linklerini veya ideal olarak Adjust'ın ESP entegrasyonlarından birini kullanmak en iyi yöntemdir.
Attribution verilerimi ve/veya kampanya seviyelerimi neden göremiyorum?
Adjust parametrelerinin adj_ ya da adjust_ prefix'lerine sahip olup olmadığını kontrol edin. adj_ ya da adjust_ prefix'lerine sahip olmayan tüm Adjust parametreleri düşer, ve bu parametrelerden gelen veriler görüntülenmeyebilir.
Install'lar doğru bir şekilde attribute edilmesine rağmen partnerim neden attributed callback'leri almıyor?
- Universal link'e tıklama ID'si parametresini eklediğinizi kontrol edin.
- Link URL'indeki fallback ya da callback'lerde bunun çalışmasını önleyebilecek kodlama hataları olmadığından emin olun.
- Tıklama ID'si parametresinin
adj_ya daadjust_prefix'lerine sahip olduğundan emin olun.
Neden Safari for iOS 12.2 and 12.3'de JSR universal linkleri ile sorun yaşıyorum?
iOS 12.2 and 12.3'de JSR universal linkleri, Safari ortamında tıklandığında her zaman doğru açılmayabiliyor. Bu, özellikle referrer HTTP header'ın okunamadığı durumları etkiler: örneğin incognito modu kullanıldığında.
Safari kampanyaları için ham universal linklerin kullanılmasını öneriyoruz. Ancak bu, wrapped URL'ler içeren e-posta kampanyalarında çalışmayacaktır.
iOS 13 ve üstünde, şemaya bir fallback uygulayabildiğimiz için bu sorun yoktur. Ancak bu ek bir pop-up'a neden olur.