Deep link

Deep link mở một màn hình cụ thể bên trong ứng dụng đã cài đặt, chẳng hạn một thử thách, một lời mời giới thiệu hoặc một trang sản phẩm. Nếu ứng dụng chưa được cài đặt, khách truy cập sẽ được đưa đến cửa hàng, giống như với liên kết thông minh. Deep link có trong Pro, Studio và Trọn đời. Universal Links và Android App Links còn cần tên miền tùy chỉnh, là một phần của Studio.

Cách deep link hoạt động

Thêm /open/ và đường dẫn trong ứng dụng vào liên kết thông minh. Query string cũng được chuyển tiếp:

https://mapps.one/habitly/open/challenges/30-days?ref=newsletter

Đích dự phòng là nơi mà liên kết thông minh sẽ đưa thiết bị đó đến, theo quy tắc chuyển hướng của bạn, kèm các thẻ UTM được chuyển tiếp. Nếu nền tảng đó không có liên kết cửa hàng, đích dự phòng là landing page. Nếu deep link hoàn toàn chưa được thiết lập, hoặc gói không bao gồm tính năng này, mọi khách truy cập đều được chuyển hướng đến liên kết thông minh.

Đường dẫn có thể chứa chữ cái, chữ số và các ký tự / _ - . ~ %. Các ký tự khác sẽ bị xóa, vì vậy hãy mã hóa phần trăm mọi ký tự khác, chẳng hạn dấu cách (%20).

Thiết lập

Mở tab Deep link của ứng dụng và điền các trường cho những nền tảng bạn hỗ trợ:

Đăng ký scheme trong ứng dụng

iOS, trong Info.plist:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>habitly</string>
    </array>
  </dict>
</array>

Android, trong AndroidManifest.xml:

<activity android:name=".MainActivity" android:exported="true">
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="habitly" />
  </intent-filter>
</activity>

Trong ứng dụng, hãy đọc URL nhận được, điều hướng đến màn hình tương ứng và đọc các tham số truy vấn bạn cần. Hãy đưa các đường dẫn không xác định về màn hình chính, vì người dùng có thể tự sửa URL.

Universal Links và Android App Links

Liên kết dùng scheme hiển thị một trang chuyển hướng ngắn trước, và iOS có thể yêu cầu khách truy cập xác nhận. Liên kết đã xác minh bỏ qua bước đó: khi ứng dụng đã được cài đặt, hệ thống mở ứng dụng trực tiếp. Việc xác minh cần một tên miền chỉ thuộc về ứng dụng của bạn, nên tính năng này hoạt động trên tên miền tùy chỉnh. Khi get.habitly.app đã được kết nối, mapps.one sẽ phục vụ các tệp liên kết miền cho bạn:

Tệp của Apple bao gồm mọi đường dẫn trong /open/:

{
  "applinks": {
    "details": [
      {
        "appIDs": ["A1B2C3D4E5.com.habitly.app"],
        "components": [
          { "/": "/open/*", "comment": "Deep links created with mapps.one" }
        ]
      }
    ]
  },
  "webcredentials": { "apps": ["A1B2C3D4E5.com.habitly.app"] }
}

Tệp của Android:

[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.habitly.app",
      "sha256_cert_fingerprints": [
        "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"
      ]
    }
  }
]

Mỗi tệp trả về "404 Not Found" cho đến khi các trường của tệp đó hợp lệ: Team ID gồm 10 ký tự và bundle ID với Apple, và tên gói cùng ít nhất một dấu vân tay theo định dạng AA:BB:... (32 cặp) với Android. Hãy dùng dấu vân tay của khóa Play App Signing trong Play Console → App integrity, và thêm cả khóa tải lên (upload key) nếu bạn kiểm thử các bản build được ký cục bộ. Các tệp được lưu trong bộ nhớ đệm một giờ. Apple cũng lưu đệm các tệp này trên máy chủ riêng, vì vậy hãy cài đặt lại ứng dụng để kiểm tra thay đổi.

Cấu hình ứng dụng

iOS: thêm capability Associated Domains với applinks:get.habitly.app.

Android: thêm intent filter đã xác minh cho tên miền của bạn:

<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="https" android:host="get.habitly.app" android:pathPrefix="/open/" />
</intent-filter>

Sau đó dùng các liên kết như https://get.habitly.app/open/challenges/30-days trong chiến dịch của bạn. Khi ứng dụng chưa được cài đặt, trình duyệt sẽ tải trang và luồng dự phòng tương tự sẽ chạy.

Phân tích

Một lượt mở được tính vào Lượt mở deep link khi điện thoại hoặc máy tính bảng tải một URL /open/ và mapps.one thử mở ứng dụng. Việc chuyển tiếp đến cửa hàng dự phòng không được tính thêm lần nữa. Liên kết đã xác minh mở ứng dụng trực tiếp không bao giờ đến mapps.one, nên không được tính. Hãy dùng công cụ phân tích trong ứng dụng của riêng bạn cho các lượt đó.