Bài viết liên tục được cập nhật, và những phần được cập nhật rất có thể chưa được dịch sang ngôn ngữ của bạn. Để xem thông tin mới nhất, vui lòng chọn ngôn ngữ Tiếng Anh.

Mã hóa callback

Mã hóa URL là thao tác chuyển đổi các phần quan trọng của URL sang code để máy chủ có thể đọc được. Mã hóa URL là một bước quan trọng. Nếu URL không được mã hóa đúng, thì sẽ gây ra lỗi trên máy chủ, khiến cho Adjust không thể đọc và xử lý tham số. Việc này có thể khiến bạn mất đi dữ liệu callback quan trọng, đồng thời khiến lệnh redirect và fallback hoạt động sai.

Quy tắc mã hóa được áp dụng như nhau cho callback URL và link URL.

Yêu cầu liên quan đến mã hóa URL

Bạn chỉ cần mã hóa callback URL.

Cảnh báo:
Vui lòng không mã hóa link URL hay bất kỳ tham số chiến dịch nào có trong link URL.

Các thành tố sau phải luôn được mã hóa. Để xem đầy đủ danh sách, vui lòng tham khảo thông số RFC 3986.

  • Ký tự đặc biệt, không an toàn: @, &, +, ,, /, :, ;, =, ?, @, ", <, >, #, %, {, }, |, ``, ^, ~, [, ], `````, (, )
  • Khoảng trắng ( )
  • URL dưới dạng giá trị tham số (ví dụ, fallback URL)
  • Tham số lồng tham số (ví dụ, Android install referrer value)

Bạn không nên sử dụng khoảng trắng hay ký tự đặc biệt khi tạo callback URL. Vui lòng sử dụng dấu gạch ngang.

Mặc dù hướng dẫn nêu cụ thể bạn cần mã hóa phần nào của URL, nhưng bạn cũng cần mã hóa mọi giá trị tham số chứa ký tự không an toàn. Nếu không chắc liệu giá trị có chứa ký tự không an toàn hay không, thì bạn có thể nhập giá trị vào URL encoder. URL encoder sẽ chuyển đổi mọi ký tự nhạy cảm có trong giá trị. 

Lưu ý:
Trường dữ liệu sử dụng dấu ngoặc nhọn ({ }) do đó, bạnkhông cần mã hóa trường dữ liệu.

Nếu URL không được mã hóa đúng, thì bạn sẽ nhận được một thông báo lỗi từ máy chủ của chúng tôi. Việc này có thể khiến fallback và redirect hoạt động sai, đồng thời khiến máy chủ không thể đọc hay xử lý tham số.

Ví dụ

Ký tự đặc biệt trong callback URL

URL đã mã hóaLuôn mã hóa URL
URL chưa mã hóaKhông sử dụng khi chưa mã hóa
http://callbacks.myserver.com/registration?username=bob_uncle&email=bob.uncle%40mail.com

Link URL chứa URL dưới dạng tham số

URL đã mã hóaLuôn mã hóa URL
URL chưa mã hóaKhông sử dụng khi chưa mã hóa
https://app.adjust.com/abc123?redirect=https%3A%2F%2Fwww.mywebsite.com%2Flanding_page

Link URL chứa tham số lồng tham số

URL đã mã hóaLuôn mã hóa URL
URL chưa mã hóaKhông sử dụng khi chưa mã hóa
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
Lưu ý:
Trong ví dụ này, có một tham số callback trong URL đã được mã hóa, nghĩa là giá trị callback URL đã đượcmã hóa kép.