Mobile Engineering for Backend Engineers
Trang chủ / Module 6
🔗 Module 6 / 14 · 4-5 ngày

Deep Linking & Universal Links

Custom URL scheme, Universal Links (iOS) và App Links (Android), và deferred deep linking cho người dùng chưa cài app.

Universal LinksApp Links
📌 Vì sao module này quan trọng

Deep linking là cầu nối giữa web và mobile — email marketing, tin nhắn SMS, quảng cáo, hay đơn giản là chia sẻ 1 sản phẩm từ web đều cần "mở đúng màn hình trong app" thay vì chỉ mở trang chủ. Backend thường phải sinh ra các link này và xử lý trường hợp người dùng chưa cài app.

🎯 Mục tiêu học tập

  • Phân biệt Custom URL Scheme, Universal Links (iOS), và App Links (Android)
  • Cấu hình đúng file xác thực domain sở hữu app (apple-app-site-association, assetlinks.json)
  • Thiết kế deferred deep linking cho người dùng chưa cài app
  • Thiết kế backend sinh link động phục vụ chia sẻ/marketing/referral

Custom URL Scheme vs Universal Links/App Links

Cơ chếVí dụNhược điểm
Custom URL Schememyapp://product/123Nếu app chưa cài, hệ điều hành không biết xử lý thế nào (lỗi hoặc im lặng bỏ qua); bất kỳ app nào cũng có thể đăng ký cùng 1 scheme, tiềm ẩn rủi ro bảo mật (app giả mạo "cướp" scheme)
Universal Links (iOS) / App Links (Android)https://example.com/product/123Cần cấu hình xác thực domain (phần dưới), nhưng an toàn hơn nhiều và có fallback tự nhiên: nếu chưa cài app, mở thẳng trang web tương ứng

Universal Links/App Links là lựa chọn chuẩn hiện đại — dùng chính domain thật của bạn làm link, hệ điều hành tự quyết định mở app (nếu đã cài và xác thực domain thành công) hoặc mở trình duyệt (nếu chưa cài) — không cần logic riêng phân biệt 2 trường hợp ở tầng gửi link.

Cấu hình Xác thực Domain sở hữu App

// https://example.com/.well-known/apple-app-site-association (iOS)
{
  "applinks": {
    "details": [{
      "appID": "TEAM_ID.com.example.myapp",
      "paths": ["/product/*", "/order/*"]
    }]
  }
}
// https://example.com/.well-known/assetlinks.json (Android)
[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.myapp",
    "sha256_cert_fingerprints": ["AA:BB:CC:..."]
  }
}]

Đây là 2 file backend phải host ở đúng đường dẫn .well-known/ trên domain chính thức — cơ chế xác thực 2 chiều: mobile team cung cấp App ID/package name và chữ ký, bạn host file xác nhận domain thực sự thuộc về ứng dụng đó. Thiếu bước này (rất hay bị quên vì nó nằm ở phía backend trong khi cấu hình chính lại ở mobile team), Universal Links/App Links sẽ không hoạt động dù cấu hình phía app đã đúng.

Deferred Deep Linking — Người dùng chưa cài App

Bài toán: người dùng bấm vào link chia sẻ sản phẩm nhưng chưa cài app — được điều hướng ra App Store/Google Play để cài, nhưng sau khi cài xong và mở app lần đầu, làm sao app biết chính xác sản phẩm nào người dùng định xem ban đầu? Đây gọi là deferred deep link.

Kỹ thuật phổ biến: khi người dùng bấm link trước khi cài, backend ghi lại "dấu vân tay" thiết bị (kết hợp IP, user agent, thời điểm — không hoàn hảo nhưng đủ dùng) cùng với đích đến dự định; sau khi app cài xong và mở lần đầu, app gửi lên cùng thông tin thiết bị đó, backend so khớp và trả về đúng đích đến đã lưu. Các dịch vụ chuyên dụng (Branch.io, Firebase Dynamic Links — dù dịch vụ sau đã ngừng hỗ trợ) xử lý sẵn cơ chế này, thường là lựa chọn thực dụng hơn tự xây từ đầu.

Backend sinh Link động cho Chia sẻ/Marketing/Referral

POST /api/share-links
{ "product_id": 123, "campaign": "black-friday" }

# Response
{ "url": "https://example.com/s/aZ3kx9" }
# Backend lưu mapping "aZ3kx9" -> product_id=123, campaign="black-friday"
# Khi có người bấm vào, backend log lại click, redirect đến Universal Link thật sự

Link rút gọn động qua backend (thay vì Universal Link dài trực tiếp) cho phép theo dõi click/conversion theo từng chiến dịch marketing, referral program, hay chia sẻ cá nhân — dữ liệu quan trọng để đo hiệu quả kênh marketing mà Universal Link tĩnh thuần tuý không cung cấp được.

🏋️ Bài tập thực hành

Thiết lập Universal Link/App Link đầy đủ

Nếu có 1 domain thật (hoặc dùng ngrok/domain test), host file apple-app-site-association và assetlinks.json mẫu ở đúng đường dẫn .well-known/. Thiết kế API sinh link chia sẻ động cho 1 "sản phẩm" giả định, có lưu lại campaign/nguồn chia sẻ, và endpoint thống kê số lượt click theo từng link đã tạo.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Phân biệt Custom URL Scheme và Universal Links/App Links, chọn đúng cho tình huống
  • Cấu hình đúng file xác thực domain (apple-app-site-association, assetlinks.json)
  • Giải thích được cơ chế deferred deep linking hoạt động ra sao
  • Thiết kế được backend sinh link chia sẻ động có theo dõi được click/campaign