Deeplink SSS
Deeplink'inizin davranışını etkileyebilecek birçok faktör vardır. Test ya da üretim aşamasında deeplink'leriniz ile beklenmedik sonuçlar alıyorsanız, çözüm için bu makaleyi okuyun. Sorun hala devam ediyorsa lütfen support@adjust.com adresi ile 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.
Link'ler + deep_link parametresini içeren deeplink sorunlarını gidermek
Deeplink'im Facebook post'larından neden çalışmıyor?
Facebook paylaşımlarıyla yürütülen kampanyaların deeplink parametresi eklenmiş bir Adjust link URL'i kullanmaları gerekir. Ek olarak, deeplink parametresine bir path eklenmiş olması gerekir, yoksa uygulama install edilmiş olsa bile kullanıcı store'a yönlendirilir. Verilen path geçerli olmak zorunda değildir.
Path eklenmiş bir parametre örneği: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
Ertelenen deeplink'lerin sorunlarını gidermek
Ertelenen deeplink'im install'dan sonra uygulamamdaki doğru noktayı neden açmıyor?
Ertelenen deeplink sizi install'dan sonra uygulama içinde doğru noktaya götürmezse, önce bu path'in var olup olmadığını kontrol edin. (myapp://) şemasını bir web ortamında host edin ve sorunun kaynağının linkiniz mi yoksa uygulama yapılandırmanız mı olduğunu şemaya tıklayarak test edin. 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.
Ertelenen deeplink'im cihaz unutulduktan sonra neden çalışmıyor?
Ertelenen deeplink'ler bazen test sırasında tıklamadan bir süre sonra da etkin kalmaya devam eder, cihaz Test Konsolu ile unutulduktan sonra bile.
Bu olursa, testiniz şunun gibi görünebilir:
- Deeplink'e tıkladınız, uygulamayı kurdunuz ve açtınız.
- Uygulamayı kaldırdınız.
- Cihazı Test Konsolu ile unuttunuz.
- Bir test daha yaptınız (tıklama, install ve açma) ve ertelenen deeplink çalışmadı.
Bu durumda, uygulamayı tekrar kaldırın, cihazı Test Konsolu ile unutun ve testi yeniden yapın. Bunu yaptıktan sonra ertelenen deeplink, olması gerektiği gibi çalışmaya başlayacaktır.