Firebase App Indexing — bản chất của lập chỉ mục nội dung ứng dụng và nguyên lý hoạt động

Firebase App Indexing là gì

Firebase App Indexing là công nghệ của Google giúp nội dung ứng dụng di động có thể truy cập được bởi trình thu thập dữ liệu tìm kiếm Google, cho phép lập chỉ mục các màn hình ứng dụng giống như cách Google lập chỉ mục các trang web. Khi nội dung ứng dụng được lập chỉ mục, người dùng có thể tìm thấy nó trong Google Search, Google Assistant hoặc Google Lens và điều hướng trực tiếp đến màn hình ứng dụng mong muốn chỉ bằng một cú nhấp, mà không cần qua trang web.

Nguyên lý lập chỉ mục nội dung di động

Google lập chỉ mục ứng dụng thông qua hai cơ chế: lập chỉ mục tự động và Firebase App Indexing API. Lập chỉ mục tự động hoạt động trên Android qua Google Play Services: nếu ứng dụng được cài đặt, Google tự động lập chỉ mục nội dung có liên kết sâu. Lập chỉ mục qua API cho phép nhà phát triển kiểm soát theo cách lập trình nội dung nào hiển thị trong tìm kiếm, sử dụng Firebase App Indexing API để cập nhật hoặc xóa các trang đã lập chỉ mục.

Tại sao cần lập chỉ mục ứng dụng

Lập chỉ mục ứng dụng giải quyết một số nhiệm vụ: thu hút người dùng mới từ tìm kiếm Google (kết quả tìm kiếm hiển thị nội dung ứng dụng trong thẻ). Tăng mức độ tương tác — người dùng hiện tại tìm thấy nội dung mong muốn nhanh hơn qua tìm kiếm trên thiết bị. Tăng lượt cài đặt — tìm kiếm Google hiển thị liên kết sâu đến nội dung, và nếu ứng dụng chưa được cài đặt, Google hiển thị liên kết cài đặt. App Indexing cũng cải thiện khả năng hiển thị của ứng dụng trong Google Assistant, có thể đề xuất mở ứng dụng trong quá trình tìm kiếm bằng giọng nói.

Cách lập chỉ mục nội dung ứng dụng hoạt động

Quá trình lập chỉ mục bắt đầu khi Google phát hiện lược đồ URI của ứng dụng bạn. Đối với Android, Google sử dụng thông tin từ Google Play Store (cấp độ API, intent-filter, lược đồ URI) để xây dựng bản đồ ứng dụng. Đối với iOS, việc lập chỉ mục được thực hiện qua Spotlight Integration và CSSearchableIndex. Khi Google lập chỉ mục nội dung ứng dụng, nó liên kết URI (ví dụ: myapp://product/123) với URL web, nếu có, và lưu trữ cặp này trong chỉ mục tìm kiếm.

Liên kết ứng dụng và trang web

Để lập chỉ mục chính xác, Google phải hiểu mối quan hệ giữa ứng dụng và trang web của bạn. Digital Asset Links là tệp JSON được tải lên trang web của bạn và xác nhận rằng ứng dụng di động thuộc về chủ sở hữu trang web. Tệp assetlinks.json được đặt trong thư mục gốc của tên miền và chứa dấu vân tay SHA256 của chứng chỉ ký ứng dụng. Google xác minh liên kết này trước khi hiển thị nút mở ứng dụng trong kết quả tìm kiếm.

// https://yourapp.com/.well-known/assetlinks.json
[
    {
        "relation": ["delegate_permission/common.handle_all_urls"],
        "target": {
            "namespace": "android_app",
            "package_name": "com.example.myapp",
            "sha256_cert_fingerprints": [
                "14:6D:E9:92:..."
            ]
        }
    }
]

Nguồn lập chỉ mục

Google nhận nội dung để lập chỉ mục từ nhiều nguồn: Google Play Store (danh sách ứng dụng đã xuất bản với lược đồ URI của chúng), Android App Links (lược đồ HTTP được xác minh trong Android 6.0+), Firebase App Indexing API (cập nhật chỉ mục theo cách lập trình) và lập chỉ mục tự động qua Google Play Services trên các thiết bị có cài đặt ứng dụng. Mỗi nguồn bổ sung cho chỉ mục tổng thể, làm cho nội dung ứng dụng có thể truy cập tối đa cho tìm kiếm.

Lập chỉ mục tự động qua Google Play Services

Google Play Services tự động lập chỉ mục nội dung của các ứng dụng đã cài đặt trên Android nếu ứng dụng sử dụng lược đồ URI và intent-filter chính xác. Cơ chế này quét ứng dụng để tìm intent-filter với hành động VIEW và thu thập các URI được sử dụng trong ứng dụng. Quá trình này hoàn toàn tự động và không yêu cầu mã bổ sung từ nhà phát triển — chỉ cần cấu hình chính xác các liên kết sâu trong tập tin kê khai.

URI nào được lập chỉ mục tự động

Google tự động lập chỉ mục các URI đáp ứng các tiêu chí nhất định: URI phải có thể truy cập qua intent-filter với hành động VIEW, lược đồ phải là HTTP/HTTPS cho Android App Links. Các URI có lược đồ tùy chỉnh (myapp://) cũng được lập chỉ mục, nhưng chỉ khi ứng dụng được cài đặt. Lập chỉ mục tự động không áp dụng cho các URI dẫn đến trang xác thực hoặc dữ liệu cá nhân của người dùng.

Hạn chế của lập chỉ mục tự động

Lập chỉ mục tự động có một số hạn chế: chỉ mục không được cập nhật ngay lập tức mà có độ trễ từ vài giờ đến vài ngày. Cấp độ API của ứng dụng — lập chỉ mục tự động yêu cầu minSdkVersion 23 trở lên. Các URI không có lược đồ HTTP/HTTPS chỉ được lập chỉ mục trên các thiết bị có cài đặt ứng dụng. Để tăng tốc lập chỉ mục và thêm nội dung không có phiên bản web, bạn nên sử dụng Firebase App Indexing API.

Firebase App Indexing API

Firebase App Indexing API là API HTTP của Google cho phép nhà phát triển quản lý theo cách lập trình nội dung đã lập chỉ mục của ứng dụng. API chấp nhận các yêu cầu thêm, cập nhật và xóa các trang URI khỏi chỉ mục Google. Không giống như lập chỉ mục tự động, API hoạt động ngay lập tức: sau khi gọi, Google bắt đầu xem xét các URI mới trong kết quả tìm kiếm trong vòng vài phút.

Định dạng yêu cầu Firebase App Indexing API

Một yêu cầu đến Firebase App Indexing API chứa một đối tượng trang với URI, tiêu đề, mô tả và các hình ảnh tùy chọn. Mỗi URI được xử lý như một trang riêng biệt có thể được tìm thấy qua tìm kiếm Google. API sử dụng xác thực OAuth 2.0 qua Tài khoản Dịch vụ Firebase. Để thêm hàng loạt URI, hỗ trợ xử lý hàng loạt lên đến 1000 trang trong một yêu cầu duy nhất.

import com.google.firebase.appindexing.FirebaseAppIndex;
import com.google.firebase.appindexing.Indexable;
import com.google.firebase.appindexing.builders.Indexables;

public class AppIndexingHelper {
    public static void indexProduct(String productId,
            String name, String price) {
        Indexable product = Indexables.newSimpleBuilder(name)
            .setUrl("myapp://product/" + productId)
            .setDescription("Giá: " + price)
            .build();

        FirebaseAppIndex.getInstance()
            .update(product)
            .addOnSuccessListener(aVoid ->
                Log.d("Chỉ mục", "OK"))
            .addOnFailureListener(e ->
                Log.e("Chỉ mục", "Lỗi", e));
    }

    public static void removeProduct(String productId) {
        FirebaseAppIndex.getInstance()
            .remove("myapp://product/" + productId);
    }
}

Cập nhật và xóa nội dung

Khi nội dung ứng dụng thay đổi, cần cập nhật chỉ mục Google qua Firebase App Indexing API. Việc xóa nội dung lỗi thời cũng rất quan trọng: nếu một URI không còn tồn tại hoặc dẫn đến 404, nó cần được xóa khỏi chỉ mục. Firebase App Indexing không tự động xóa nội dung khi nó thay đổi trong ứng dụng — nhà phát triển chịu trách nhiệm đồng bộ hóa chỉ mục với trạng thái nội dung hiện tại. Nên gọi API mỗi khi dữ liệu thay đổi: thêm, chỉnh sửa hoặc xóa sản phẩm, bài viết, hồ sơ.

Thiết lập App Indexing trong Android

Thiết lập Firebase App Indexing trong Android bao gồm một số bước: thêm Firebase SDK, thêm các phụ thuộc app-indexing trong build.gradle, cấu hình Android App Links và tạo dịch vụ xử lý URI. Phiên bản API tối thiểu cho Firebase App Indexing là 23. Sau khi cấu hình SDK, ứng dụng tự động bắt đầu gửi dữ liệu để lập chỉ mục đến Google qua Google Play Services.

Thêm phụ thuộc và cấu hình

Đối với Firebase App Indexing, bạn cần thêm phụ thuộc com.google.firebase:firebase-appindexing và plugin google-services vào build.gradle của mô-đun ứng dụng. Firebase tự động xử lý dữ liệu lập chỉ mục qua Google Play Services nếu ứng dụng đáp ứng các yêu cầu: minSdkVersion 23+, có intent-filter với lược đồ HTTP/HTTPS và sử dụng Android App Links để xác minh. Đối với URI có lược đồ tùy chỉnh, cần cấu hình bổ sung.

// build.gradle (Mô-đun: app)
plugins {
    id 'com.android.application'
    id 'com.google.gms.google-services'
}

android {
    defaultConfig { minSdkVersion 24 }
}

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.0.0')
    implementation 'com.google.firebase:firebase-appindexing'
}

Android App Links và xác minh

Android App Links là các liên kết HTTP/HTTPS mà Google xác minh là thuộc về ứng dụng của bạn. Việc xác minh được thực hiện qua Digital Asset Links: tệp assetlinks.json được tải lên trang web của bạn. Sau khi xác minh, Android tự động xử lý tất cả các liên kết từ tên miền của bạn dưới dạng App Links, mà không hỏi người dùng muốn mở liên kết trong ứng dụng nào. Đây là điều kiện cần thiết để lập chỉ mục nội dung ứng dụng chính xác.

Kiểm tra lập chỉ mục

Sau khi cấu hình, bạn cần kiểm tra xem nội dung ứng dụng có thực sự được lập chỉ mục hay không. Firebase Console trong phần App Indexing hiển thị thống kê: số lượng URI đã lập chỉ mục, số lượt hiển thị trong tìm kiếm và lượt nhấp. Để kiểm tra chi tiết, hãy sử dụng Google Search Console, nơi hiển thị các lỗi lập chỉ mục và đề xuất. Bạn cũng có thể tìm kiếm site:https://your-app.page.link trên Google để xem các trang đã lập chỉ mục của ứng dụng.

Các phương pháp hay nhất về lập chỉ mục

Lập chỉ mục ứng dụng hiệu quả đòi hỏi phải tuân thủ một số phương pháp chính. Tất cả các URI bạn muốn lập chỉ mục phải dẫn đến nội dung thực — không có chỗ chứa, màn hình trống hoặc trang lỗi. Nên chỉ lập chỉ mục nội dung công khai và không lập chỉ mục các trang yêu cầu xác thực. Mỗi URI phải có tên và mô tả có thể đọc được bằng ngôn ngữ của người dùng.

Nên lập chỉ mục gì

Lập chỉ mục nội dung mà người dùng tìm kiếm trên Google: thẻ sản phẩm, bài viết, hồ sơ, danh mục menu, công thức nấu ăn, sự kiện. Không lập chỉ mục các trang có dữ liệu cá nhân, cài đặt, giỏ hàng, lịch sử đơn hàng hoặc bất kỳ dữ liệu riêng tư nào khác. Đối với nội dung động (nguồn cấp tin tức, lựa chọn cá nhân hóa), hãy sử dụng Firebase App Indexing API để thêm URI mới khi chúng được tạo và xóa chúng khi bị xóa.

Tối ưu hóa tìm kiếm

Mỗi URI đã lập chỉ mục phải có tiêu đề, mô tả và hình ảnh xem trước có ý nghĩa cho kết quả tìm kiếm. Sử dụng từ khóa trong tiêu đề và mô tả phù hợp với các truy vấn tìm kiếm thực tế của người dùng. Đối với hình ảnh, hãy sử dụng định dạng hình vuông 1200x1200 px và đảm bảo chúng có thể truy cập qua URL công khai. Thường xuyên cập nhật nội dung: Google hiển thị các trang mới thường xuyên hơn trong tìm kiếm.