Encoding callbacks

URL encoding is the practice of converting sensitive sections of complex URLs into code so that they can be read by a server. URL encoding is an essential practice. Failure to correctly encode a URL will result in an error on our server. This will lead to an inability to read and process parameters, which will result in the loss of valuable data.

What do you need to encode?

You need to encode the callback URL only.

Warning:
Do not encode the Adjust link URL and any campaign parameters in the Adjust link URL.

Make sure that you always encode the following. For a more comprehensive list, refer to the RFC 3986 specifications.

  • Unsafe special characters: @, &, +, ,, /, :, ;, =, ?, @, ", <, >, #, %, {, }, |, \, ^, ~, [, ], `, (, )
  • Spaces ( )
  • URLs as parameter values (Example: fallback URLs)
  • Parameters within parameters (Example: Android install referrer values)

We recommend that you avoid using spaces or special characters in the callback URL. Use an underscore instead.

Note:
Do not encode dynamic partner macros. Otherwise, the servers will not recognize these macros and will not populate any necessary values.

Example

Encoded URL
Unencoded URLDo not use
https://app.adjust.com/abc1234?campaign=new-campaign&adgroup={sub_id}&creative={crt_id}&idfa={network_idfa_macro}&gps_adid={network_gaid_macro}&install_callback=http%3A%2F%2Fmynetworkserver.com%2Fcallback%3Fcountry%3D%7Bcountry%7D