Dokümantasyonumuzu sürekli güncel tutuyoruz, ancak bazı güncellemeler henüz tüm dillerde yayınlanmamış olabilir. En güncel bilgiler için lütfen İngilizce versiyonuna göz atın.

Callback'leri encode etmek

URL'lerin encode edilmesi, karmaşık URL'lerin hassas bölümlerini bir sunucu tarafından okunabilmeleri için kod haline getirme yöntemidir. URL encoding gerekli bir yöntemdir. Bir URL doğru bir şekilde encode edilmediğinde sunucu hataları meydana gelebilir ve Adjust'ın parametreleri okumasını ve işlemesini engelleyebilir. Bu, değerli callback verilerinin kaybı ile birlikte yönlendirme ve fallback'lerin çalışmamasına neden olabilir.

Aynı encoding kuralları callback URL'leri ve link URL'leri için de geçerlidir.

Adjust URL encoding gereksinimleri

Sadece callback URL'ini encode etmeniz gerekir.

Dikkat:
Adjust link URL'ini ve Adjust link URL'indeki herhangi bir kampanya parametresini encode etmeyin.

Aşağıdakilerin her zaman encode edilmesi gerekir. Daha kapsamlı bir liste için RFC 3986 spesifikasyonlarına göz atın.

  • Kullanılmaması gereken özel karakterler: @, &, +, ,, /, :, ;, =, ?, @, ", <, >, #, %, {, }, |, ``, ^, ~, [, ], `````, (, )
  • Boşluklar ( )
  • Parametre değerleri olarak URL'ler (Örneğin fallback URL'leri)
  • Parametrelerin içinde parametreler (örneğin Android install referrer değerleri)

Callback URL'lerinizde boşluk veya özel karakter kullanmaktan kaçınmanızı öneririz. Bunun yerine bir alt çizgi kullanın.

Yönergelerimiz içinde bir URL'in önemli bir kısmının ne zaman encode edilmesi gerektiği belirtilse de, güvenli olmayan karakterler içeren tüm parametre değerlerinin encode edilmesi gerekir. Bir değerin güvenli olmayan karakterler içerip içermediğinden emin değilseniz, onu bir URL encoder'a girin. Bu, değerdeki hassas karakterleri dönüştürür. 

Not:
Süslü parantez ({ }) kullanan placeholder'ların encode edilmesigerekmediğini unutmayın.

Bir URL'in doğru şekilde encode edilmemesi, sunucumuzda hataya yol açabilir:  örneğin bozuk fallback'ler, yönlendirmeler ve parametrelerin okunamaması ve işlenememesi gibi.

Örnekler

Callback URL'indeki özel karakterler

Encoded URLURL'i her zaman encode edin
Unencoded URLOlduğu gibi kullanmayın
http://callbacks.myserver.com/registration?username=bob_uncle&email=bob.uncle%40mail.com

URL'in parametre olduğu bir link URL

Encoded URLURL'i her zaman encode edin
Unencoded URLOlduğu gibi kullanmayın
https://app.adjust.com/abc123?redirect=https%3A%2F%2Fwww.mywebsite.com%2Flanding_page

Parametrelerin diğer parametrelerin içinde olduğu bir link URL

Encoded URLURL'i her zaman encode edin
Unencoded URLOlduğu gibi kullanmayın
https://app.adjust.com/abc123?referrer=adjust_tracker%3Dabc123%26adjust_campaign%3DChristmasCamp59_ChristmasCampId330%26adjust_adgroup%3DAppId48399_SubID%26adjust_creative%3DCreative9383_SubId%26utm_source%3Dadjust_store&adjust_install_callback=www.3rdpartydomain.com%253Fsrc%253Dadjust%2526advertiserId%253D57638%2526password%253D4d13c4dc
Not:
Bu örnekte zaten encode edilmiş bir URL'in içinde bir callback parametresi bulunuyor, yani callback URL değeri iki kere encodeedilmelidir.