Deeplink SSS
Test veya üretim aşamasındaki deeplinklerin davranışını birçok faktör etkiler. Adjust deeplinkleri, evrensel linkler ve ertelenen deeplinkler ile ilgili genel sorunları gidermek için bu makaleden yararlanın. Sorun hala devam ediyorsa lütfen support@adjust.com adresi ile iletişime geçin.
Genel deeplink sorunları
Deeplinkiniz beklenen hedefi açmazsa ya da "HTTP 404 URL not found" hatası verirse, önce URL sentaks ve encoding kontrolü yapın.
URL'ler genellikle bu yapıyı kullanır: scheme://host:port/path?query-string#fragment-id
URL'in her parçasının spesifik bir fonksiyonu vardır. Şema ve host, büyük veya küçük harflere duyarlı, path ve query-string duyarlı değildir. URL yapısındaki herhangi bir hata linkin beklendiği gibi açılmasını engelleyebilir.
Deeplinkinizi yapılandırırken:
- Zaten query parametreleri içeren bir URL'e Adjust parametreleri eklediğinizde,
&kullanın. İkinci bir?eklemeyin, çünkü ikinci?sonrası gelen bilgiler silinebilir. - Query string'i encode'lu ise,
/ile başlatın ya da bunun birdeeplinkparametresi olduğundan emin olun. - Fallbacklerde, callbacklerde, cihaz ID'sinde ya da kampanya parametrelerinde boşluk ya da geçersiz karakterler olmadığından emin olun. Encoding sorunları parametrelerin kesilmesine neden olabilir.
Doğru örnek:
https://example.go.link/my?path=location&client=name&adjust_t=klm012
Yanlış örnek:
https://example.go.link/my?path=location&client=name?adjust_t=klm012
Uygulama kurulumu yapılmamışsa ve URL yanlış yapılandırılmışsa, tarayıcı adjust_t parametresini düşürebilir. Adjust'ın tıklama kaynağını tanımlaması için bu parametreye ihtiyacı vardır. Bu olmadan Adjust, 404 URL not found döndürür.
Bu genellikle deeplinkin uygulamayı açamadığı ve bu nedenle kullanıcının fallback olarak store'a yönlendirildiği anlamına gelir.
Sorunu gidermek için:
- Mevcut bir kullanıcı olarak linki test edin.
- Uygulama test sırasında açılırsa, linkin başarısız olduğu ortamı kontrol edin.
- Universal linklerinizin/Android Uygulama linklerinizin/Özel uygulama şemanızın yapılandırmasının doğru olup olmadığını kontrol edin, çünkü uygulamayı açmak için gereken link standartları bunlardır.
- Fallback ve callbacklerde encoding hataları olmadığından emin olun, çünkü bunlar parametrelerin düşmesine ve linkin bozulmasına neden olabilir.
Link uygulamayı açıyor ancak doğru uygulama içi ekranı açmıyorsa, sorunun link yapılandırmasından mı yoksa uygulama yapılandırmasından mı kaynaklandığını kontrol edin.
Deeplinkinizi bir web ortamında host edin ve test cihazında açın. Markalı domain kullanıyorsanız, doğrudan markalı linki test edin. Eski Adjust adj.st linkini kullanıyorsanız, https://abcd.adj.st/ gibi universal link domainini ya da myapp:// gibi uygulama şemasını test edebilirsiniz.
Uygulama açılırsa ancak path yanlışsa, geliştiricinizden uygulama içi path'lerin doğru yapılandırıldığını onaylamasını isteyin.
Not: adj.st universal linkleri eski versiyondur. Yeni uygulamalar için markalı domainlerin kullanılmasını öneririz.
Attribution ve raporlama
Hayır. Adjust, tıklama verilerini Adjust linki kullanan ya da Adjust parametreleri eklenmiş deeplinklerden alır. Sadece uygulamanıza özgü domaininizi veya şemanızı kullanan direkt bir deeplink, tıklama verilerini Adjust'a göndermez.
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://welcomeKurulumu yapılmış uygulamaların tıklama verilerini almak ve deeplink reattribution'ı için, iOS veya Android Adjust SDK içinde SDK tıklamasını entegre ettiğinizden emin olun. Bir SDK tıklamasını tetikleyen deeplinkler, Datascape'te tıklama olarak raporlanır ve ham verilerde tık callbackleri aracılığıyla görünür.
Bir deeplink SDK tıklamasından gelen tıklamaları belirlemek için {is_deeplink_click} placeholderını ekleyin.
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 callbacklerde kodlama hatası nedeniyle kesilmediğinden emin olun. Örneğin, URL'lerde boşluk ya da geçersiz karakterler olmamalıdır.
Universal link sorunları
Kurulumlar doğru bir şekilde attribute edilmesine rağmen partnerim neden attribute edilmiş callbackleri almıyor?
Kurulumlar doğru attribute edildiyse ancak partneriniz attribute edilen callback'leri almıyorsa, universal link yapılandırmasını kontrol edin.
Şunlardan emin olun:
Tıklama ID'si parametresi, universal linke eklenmiş durumda. Fallback ve callbacklerde encoding hatası yok. Tıklama ID'si parametresi adj_ ya da adjust_ prefixlerine sahip.
Tıklama ID'si eksikse, yanlış formata sahipse ya da bir kodlama sorunu ile kesintiye uğramışsa Adjust, kurulumu attribute edebilir, ancak beklenen partner callback verilerini iletemez.
İlk olarak, universal linklerin doğru yapılandırıldığından emin olun.
Sonra Apple'ın linki nereden açtığını kontrol edin. Apple, Safari dışındaki universal linklere yönlendirmelere izin vermez, bu nedenle ham evrensel link veya şemayı bir web ortamında host etmeniz ve buradan tıklamanız gerekir.
Uygulamanız hala açılmıyorsa:
- HTML test sayfanızı Safari'de açın ve Share ikonunu seçin. Uygulamanızı "Open in..." seçeneğinin yanında görüyorsanız, Associated Domains yapılandırmanız doğrudur ve Apple App Site Association dosyası indirilmiştir.
- Uygulamayı listede göremiyorsanız uygulamayı kaldırın ve yeniden kurun.
- Bundle ID'nin testlerde ve prodüksiyonda aynı olduğunu doğrulayın.
- iOS Bundle ID ve App Prefix'in AppView'da doğru olduğundan emin olun.
- Uygulama yine de açılmıyorsa, geliştiricinizden universal link ya da şema uygulama ilişkilendirmesini araştırmasını isteyin.
Ayrıca linkinizin target="_blank" içerdiğini de kontrol edin. Bu, testlerde çalışabilir ancak prodüksiyon aşamasında başarısız olabilir. Attribute'ı linkten kaldırın.
Universal linkin bir path içerdiğinden emin olun. Path eklenmemişse, uygulama kurulmuş olsa bile kullanıcı store'a yönlendirilebilir. Path'in geçerli olması gerekmez.
iOS, Safari dışındaki universal linklere yapılan yeniden yönlendirmelere izin vermez. Bu, SFSafariViewController kullanan ortamların etkilenebileceği anlamına gelir.
E-posta linkleri, universal linkleri desteklemeyen tarayıcılar ve e-posta uygulamaları da dahil olmak üzere birçok ortamda açılabildiğinden Adjust, JSR linklerinin kullanılmasını ya da Adjust ESP entegrasyonunu önerir.
Deeplink parametreli deeplinkler
Facebook paylaşımlarıyla yürütülen kampanyaların deeplink parametresi eklenmiş bir Adjust link URL'i kullanmaları gerekir. Deeplink parametresi ayrıca bir path içermelidir. Path yoksa, uygulama cihazda olsa bile kullanıcı store'a götürülür. Path'in geçerli olması gerekmez.
Örnek: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
Ertelenen deeplinkler
Ertelenen deeplinkler, bir kullanıcı deeplinke uygulamanızı kurmadan önce tıkladığında kullanılır. Kurulumun ardından uygulama, amaçlandığı uygulama içi konumda açılmalıdır.
Ertelenen deeplink doğru konumda açmazsa:
- Path'in uygulamada olup olmadığını kontrol edin.
- Uygulama şemasını bir web ortamında host edin, örneğin
myapp://ve şemaya tıklayın. - Bu path mevcut bir kullanıcı için çalışmazsa, geliştiricinizden uygulama içi path'lerin doğru yapılandırıldığını onaylamasını isteyin.
- Path mevcut bir kullanıcı için çalışıyor ancak yeni bir kullanıcı için çalışmıyorsa, cihazı Test Konsolu'nda inceleyin ve tıklamaya attribute edilip edilmediğini kontrol edin.
- Cihaz attribute edilmemişse, cihazı Test Konsolunda unutun ve tekrar test edin.
- Cihaz attribute edilmişse, cihazın bir
deeplinkparametresi olup olmadığını kontrol edin. deeplinkparametresi yoksa, encoding sorunları ya da URL'i kesebilecek özel karakterler olup olmadığını kontrol edin.deeplinkparametresi mevcutsa ancak path eksikse, Adjust Destek Ekibi ile iletişime geçin.
Test sırasında ertelenen deeplinkler, cihazı Test Konsolunda unuttuktan sonra bile bazen tıklamadan sonra kısa bir süre için devam edebilir.
Bu, aşağıdaki durumlarda meydana gelir:
- Deeplinke tıkladınız, uygulamayı kurdunuz ve açtınız.
- Uygulamayı kaldırdınız.
- Cihazı Test Konsolunda unuttunuz.
- Bir test daha yaptınız ve ertelenen deeplink çalışmadı.
Bu sorunu çözmek için uygulamayı tekrar kaldırın, cihazı Test Konsolunda tekrar unutun ve testi tekrarlayın.