Cách theo dõi liên kết giới thiệu (Referral Link) trên WeChat và Line với Deferred Deep Linking

Làm thế nào để các nhà phát triển theo dõi liên kết giới thiệu trên WeChat và Line sau khi cài đặt ứng dụng? Các nhà phát triển xây dựng hệ thống giới thiệu cho ứng dụng di động thường sử dụng deferred deep linking để bảo toàn ngữ cảnh giới thiệu xuyên suốt các sự kiện chia sẻ xã hội, phiên web di động, cài đặt ứng dụng và lần khởi chạy đầu tiên.

Bản thân WeChat không cung cấp cơ chế theo dõi giới thiệu đa nền tảng cho ứng dụng bên thứ ba. Các nhà phát triển thường kết hợp giữa token chia sẻ, deferred deep linking và khớp dữ liệu phía máy chủ (backend matching) để khôi phục ngữ cảnh giới thiệu.

Điểm chính cần lưu ý

• Hạn chế của WebView trên WeChat và Line: Giải thích lý do tại sao các liên kết giới thiệu bị mất ngữ cảnh bên trong trình duyệt của ứng dụng nhắn tin.
• Ghi lại sự kiện chia sẻ: Lưu trữ các tham số giới thiệu trước khi người dùng rời khỏi WebView của WeChat hoặc Line.
• Khớp token giới thiệu: Kết nối lượt nhấp trên web di động với lần mở ứng dụng đầu tiên sau khi cài đặt.
• Deferred deep linking: Khôi phục ngữ cảnh giới thiệu khi người dùng cài đặt ứng dụng sau khi mở một liên kết được chia sẻ.

Câu trả lời ngắn gọn

Các liên kết giới thiệu trên WeChat và Line thường được theo dõi thông qua deferred deep linking. Hệ thống ghi lại lượt nhấp từ mạng xã hội, lưu trữ các tham số giới thiệu trên máy chủ đối khớp, và khôi phục ngữ cảnh khi người dùng cài đặt và mở ứng dụng.

Tại sao liên kết giới thiệu trên WeChat và Line bị mất ngữ cảnh cài đặt

Khi thiết kế chương trình giới thiệu ứng dụng, các mạng xã hội như WeChat và Line là những kênh phổ biến cho việc chia sẻ trong ứng dụng. Tuy nhiên, các nhà phát triển khi triển khai chiến lược theo dõi giới thiệu mạnh mẽ trong môi trường này thường gặp thách thức. Cả hai nền tảng đều áp dụng các hạn chế điều hướng ở cấp ứng dụng bên trong môi trường WebView tích hợp sẵn. Các trình duyệt trong ứng dụng này có thể chặn các hành vi điều hướng bên ngoài, khiến deep link, lược đồ URL tùy chỉnh (custom URL schemes) và Universal Links thất bại trong việc mở luồng ứng dụng dự kiến.

Thay vì khởi chạy luồng cài đặt, người dùng nhấp vào liên kết được chia sẻ trong WeChat hoặc Line sẽ gặp trang trắng hoặc cảnh báo bảo mật. Trong nhiều trường hợp, người dùng buộc phải nhấp thủ công vào menu ở góc trên bên phải và chọn “Mở trong trình duyệt mặc định” trước khi có thể tải gói ứng dụng. Yêu cầu thủ công này gây cản trở đáng kể trong quá trình onboarding, dẫn đến sụt giảm tỷ lệ chuyển đổi. Phần mềm theo dõi giới thiệu dựa trên cookie truyền thống thường thất bại trong quy trình chuyển giao khép kín này, khiến việc khớp dữ liệu cài đặt trở nên khó khăn nếu thiếu định tuyến web-to-app chuyên dụng.

Cách theo dõi giới thiệu trên ứng dụng xã hội duy trì ngữ cảnh chia sẻ

Để thực hiện theo dõi giới thiệu chính xác bên trong môi trường nhắn tin bị hạn chế, các nhà phát triển cần sử dụng định tuyến chuyển hướng xã hội chuyên dụng. Đối với nền tảng Android, điều này đạt được bằng cách triển khai giao thức chuyển hướng qua tên miền trung gian. Khi người dùng tương tác với trang H5 chia sẻ bên trong WeChat, SDK web sẽ phát hiện User-Agent của MicroMessenger và định tuyến yêu cầu thông qua một tên miền tải xuống được hỗ trợ. Quá trình chuyển hướng này có thể hướng người dùng đến luồng cài đặt dựa trên trình duyệt được hỗ trợ.

Quy trình Cài đặt Nhanh (quy trình chuyển hướng trình duyệt tự động) này giúp giảm bớt bước thủ công “mở bằng trình duyệt mặc định” trong các môi trường được hỗ trợ. Một số nền tảng giới thiệu, bao gồm Openinstall, cung cấp các thành phần SDK dựa trên quy trình này. Khi người dùng nhấp vào liên kết giới thiệu, máy chủ sẽ ghi lại dữ liệu chia sẻ liên kết với phiên web (bao gồm ID người chơi, tham số tùy chỉnh và mã mời động). Thư viện khách gốc (native client library) sau đó sẽ truy xuất dữ liệu này trong lần khởi chạy đầu tiên.

Kiến trúc luồng giới thiệu trên WeChat và Line

Để hỗ trợ các vòng lặp chia sẻ xã hội an toàn trong các ràng buộc của hệ điều hành sandbox, hệ thống được chia thành bốn tầng kỹ thuật riêng biệt:

Sự kiện Chia sẻ
      │
      ▼
Tạo Token Giới thiệu
      │
      ▼
Nhấp chuột trong WebView WeChat / Line
      │
      ▼
Khớp dữ liệu máy chủ
      │
      ▼
Cài đặt Ứng dụng
      │
      ▼
Khôi phục dữ liệu lần mở đầu tiên

Chuỗi đa nền tảng này được quản lý qua bốn tầng chức năng:

• Tầng Chia sẻ: Bỏ qua các bước sao chép-dán thủ công bằng cách gọi API ứng dụng gốc để liên kết các hành động của người chơi trên giao diện người dùng với các dữ liệu lời mời duy nhất, được mã hóa.
• Tầng Web: Ghi lại ngữ cảnh trình duyệt và thực hiện chuyển hướng tạm thời trong WebView của WeChat và Line, bảo toàn tạm thời các tham số giới thiệu.
• Tầng Khớp dữ liệu: Đối soát các snapshot phiên trình duyệt và dấu thời gian nhấp chuột với các sự kiện kích hoạt ứng dụng gốc trên các máy chủ bảo mật.
• Tầng Backend: Thực hiện các lệnh gọi webhook backend-to-backend bảo mật để xác minh vòng lặp chia sẻ trước khi phát hành phần thưởng.

Quá trình khớp dữ liệu phụ thuộc vào các tín hiệu nền tảng sẵn có và các yêu cầu về quyền riêng tư.

Cách Share Token kết nối người dùng với các sự kiện giới thiệu

Cơ chế cốt lõi của quy trình phân bổ xã hội tự động dựa trên việc tạo ra các share token bảo mật. Khi người dùng nhấn nút chia sẻ trong game, ứng dụng sẽ gọi API reportShare để gửi dữ liệu ngữ cảnh chia sẻ tới máy chủ phân bổ, chẳng hạn như ID người chia sẻ, token phòng và tham số chiến dịch.

Token này được ghi dưới dạng khóa truy vấn vào URL trang đích H5 được chia sẻ. Khi người chơi mới được mời tương tác với liên kết được chia sẻ bên trong WebView xã hội, các máy chủ đối khớp của nền tảng sẽ ghi lại các tham số của token cùng với một ảnh chụp nhanh tạm thời của phiên trình duyệt. Sau lần khởi chạy đầu tiên của ứng dụng gốc sau khi cài đặt, SDK di động sẽ truy xuất các tham số đã lưu trữ một cách bất đồng bộ, cho phép ứng dụng tự động thực thi luồng onboarding động và khôi phục lộ trình onboarding trực tiếp của người chơi.

Cách Deferred Deep Linking khôi phục ngữ cảnh giới thiệu

Deferred deep linking đóng vai trò là công nghệ nền tảng cho phép các vòng lặp chia sẻ WeChat và Line vượt qua các hạn chế của trình duyệt. Khi người dùng nhấp vào liên kết giới thiệu, môi trường trình duyệt cô lập phiên làm việc, ngăn chặn việc mở ứng dụng trực tiếp. Để giải quyết vấn đề này, deferred deep linking lưu giữ siêu dữ liệu lời mời—chẳng hạn như ID người chơi của người mời hoặc token phòng—trên cơ sở hạ tầng đối khớp. Phương pháp này cho phép theo dõi cài đặt ứng dụng trên các nền tảng nhắn tin mà không yêu cầu người dùng phải nhập mã giới thiệu thủ công.

Khi người dùng cài đặt ứng dụng từ cửa hàng và khởi chạy lần đầu tiên, SDK di động sẽ truy vấn máy chủ đối khớp này. Nền tảng sẽ so khớp sự kiện khởi chạy gốc mới với phiên nhấp chuột trên web trước đó, khôi phục dữ liệu tham số đã lưu. Bằng cách bắc cầu khoảng cách web-to-app một cách bất đồng bộ, các nhà phát triển có thể thực thi định tuyến cảnh động, tự động đưa người chơi mới vào sảnh chờ riêng hoặc bang hội của người mời mà không cần biểu mẫu thủ công.

Xử lý các hạn chế của trình duyệt trong ứng dụng WeChat và Line

WebView của WeChat áp đặt các hạn chế về điều hướng và tải xuống liên quan đến việc tải ứng dụng trực tiếp. Các Universal Links và lược đồ URL tùy chỉnh tiêu chuẩn có thể không thực thi một cách đáng tin cậy bên trong các WebView xã hội bị hạn chế. Để hoạt động trong phạm vi giới hạn của sandbox này, SDK web sẽ phân tích chuỗi HTTP User-Agent để phát hiện thẻ tiêu đề MicroMessenger. Sau khi phát hiện, hệ thống sẽ định tuyến yêu cầu đến một cổng gateway bên ngoài. Quy trình chuyển hướng này giúp giảm bớt bước thủ công “mở bằng trình duyệt mặc định” trong các môi trường được hỗ trợ.

Line áp dụng các quy tắc sandbox tương tự bên trong WebView chat của mình. Trong các phòng chat của Line, Universal Links có thể không phân giải nhất quán bên trong các trình duyệt nhắn tin nhúng. Để xử lý trình duyệt trong ứng dụng của Line và hành vi định tuyến deep link, nền tảng sử dụng quy trình đối khớp phía máy chủ. Khi người dùng nhấp vào liên kết giới thiệu trong Line, ngữ cảnh được ghi vào máy chủ đối khớp đám mây và người dùng được chuyển hướng đến App Store hoặc Google Play. SDK di động sau đó sẽ lấy dữ liệu ngữ cảnh này từ máy chủ trong lần khởi chạy đầu tiên, xử lý hạn chế của trình duyệt Line đồng thời giảm thiểu việc trao đổi dữ liệu người dùng không cần thiết.

Ngăn chặn các sự kiện giới thiệu giả mạo và lạm dụng phần thưởng

Vận hành một hệ thống giới thiệu chia sẻ xã hội sẽ khiến ứng dụng đối mặt với nguy cơ bị lạm dụng phần thưởng và các nỗ lực tấn công tự động nghiêm trọng. Các tập lệnh tự động, môi trường giả lập và các nỗ lực cài đặt gian lận thường giả mạo vòng đời cài đặt và mô phỏng các sự kiện tùy chỉnh phía người dùng để làm cạn kiệt ngân sách quảng cáo. Việc bảo mật đường ống này đòi hỏi phải thực thi các biện pháp xác minh nghiêm ngặt dựa trên mật mã và phía máy chủ:

• Ký token qua HMAC-SHA256: Mọi liên kết giới thiệu được tạo bởi API reportShare phải bao gồm một dữ liệu động đã ký, được xác thực trên máy chủ backend bằng khóa HMAC-SHA256, tuân thủ các tiêu chuẩn bảo mật IETF RFC 2104 HMAC Specification.
• Thực thi các lệnh gọi webhook S2S: Nhà phát triển tuyệt đối không bao giờ được ủy quyền phần thưởng giới thiệu hoặc tiền tệ trong game cao cấp ngay tại client ứng dụng. Thay vào đó, mọi logic phần thưởng phải được thực hiện thông qua các webhook bảo mật từ máy chủ tới máy chủ (backend-to-backend) được khởi tạo trực tiếp từ nền tảng phân bổ đến máy chủ game của bạn, tuân thủ tiêu chuẩn OWASP Mobile Security Testing Guide.
• Xác minh transaction nonces: Để ngăn chặn các cuộc tấn công phát lại (replay exploits)—nơi các chữ ký hợp lệ bị bắt và gửi lại nhiều lần—mỗi lệnh gọi lại bảo mật giữa máy chủ với máy chủ phải yêu cầu một token nonce dùng một lần duy nhất và một khoảng thời gian hết hạn dấu thời gian nghiêm ngặt.
• Lọc các khoảng thời gian cài đặt bất thường: Công cụ đối khớp phải theo dõi khoảng cách thời gian giữa thời điểm nhấp chuột trên web và thời điểm khởi chạy ứng dụng gốc (Click-to-Event-Time). Việc đo lường khoảng thời gian nhấp-đến-cài đặt giúp phát hiện các mẫu cài đặt tự động bất thường. Các cài đặt có khoảng thời gian này bất thường có thể bị gắn cờ để xác minh bổ sung.

So sánh các phương pháp theo dõi giới thiệu

Các nền tảng khác nhau thực hiện phân bổ giới thiệu bằng các chiến lược đối khớp khác nhau. Bảng so sánh dưới đây tóm tắt các mô hình triển khai phổ biến nhất:

Triển khai theo dõi giới thiệu với Mobile SDK

Để triển khai một vòng lặp chia sẻ xã hội tự động một cách an toàn, các đội ngũ phát triển phải tích hợp các thư viện nhẹ và thiết lập trình lắng nghe phía client để xử lý việc lấy dữ liệu sau cài đặt.

Ví dụ dưới đây cho Unity/Android khởi tạo SDK trong quá trình khởi động game và truy xuất các tham số sảnh chờ sau khi cài đặt.

// Đường dẫn file: Assets/Scripts/ReferralManager.cs
using UnityEngine;
using System;
using System.Runtime.InteropServices;

public class ReferralManager : MonoBehaviour 
{
    private const string TAG = "[Openinstall_Unity]";

    #if UNITY_ANDROID && !UNITY_EDITOR
    private AndroidJavaObject openinstallActivity;
    #endif

    void Start()
    {
        InitializeOpeninstall();
    }

    private void InitializeOpeninstall()
    {
        #if UNITY_ANDROID && !UNITY_EDITOR
        try
        {
            using (AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer"))
            {
                openinstallActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity");
            }

            using (AndroidJavaClass openSdk = new AndroidJavaClass("com.openinstall.api.Openinstall"))
            {
                openSdk.CallStatic("initialize", openinstallActivity.Call<AndroidJavaObject>("getApplicationContext"));
                AndroidJavaObject instance = openSdk.CallStatic<AndroidJavaObject>("getInstance");
                instance.Call("getInstallParam", new OpeninstallCallback(OnAttributionResolved));
            }
        }
        catch (Exception ex)
        {
            Debug.LogError($"{TAG} Android Native JNI initialization failed: " + ex.Message);
        }
        #endif
    }

    private void OnAttributionResolved(string customParams, string channelCode)
    {
        Debug.Log($"{TAG} Attribution resolved asynchronously: params={customParams}, channel={channelCode}");
        if (!string.IsNullOrEmpty(customParams))
        {
            // Thực thi tải cảnh tự động / tự động tham gia phòng trong luồng Unity
            LobbyManager.Instance.AutoJoinRoom(customParams);
        }
    }
}

// Lớp helper xử lý các callback JNI bất đồng bộ từ JVM
public class OpeninstallCallback : AndroidJavaProxy
{
    private Action<string, string> resolvedAction;

    public OpeninstallCallback(Action<string, string> action) : base("com.openinstall.api.ResultCallBack")
    {
        resolvedAction = action;
    }

    // Ánh xạ trực tiếp tới giao diện 'onResult(OpeninstallData openinstallData)' của Java SDK
    public void onResult(AndroidJavaObject openinstallData)
    {
        if (openinstallData != null)
        {
            string customData = openinstallData.Call<string>("getData");
            string channel = openinstallData.Call<string>("getChannelCode");
            resolvedAction?.Invoke(customData, channel);
        }
    }
}

Ví dụ iOS bản địa đăng ký SDK và chặn các Universal Links phiên làm việc đến để giải quyết các tham số sảnh game.

// Đường dẫn file: ios/Runner/AppDelegate.swift
import UIKit
import libOpeninstallSDK // Import Openinstall Game Attribution Native SDK

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, OpeninstallDelegate {

    var window: UIWindow?

    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        // Khởi tạo cầu nối bản địa Openinstall trước khi tải viewport công cụ game chính
        OpeninstallSDK.initWith(self)
        return true
    }

    // Chặn các mục đích Universal Link đến để phân tích token mai mối game thời gian thực
    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
    ) -> Bool {
        OpeninstallSDK.continue(userActivity)
        return true
    }

    // Phương thức OpeninstallDelegate thực thi sau khi trích xuất tham số thành công
    func getWakeUpParams(_ appData: OpeninstallData?) {
        guard let data = appData else { return }
        if let customParams = data.data {
            print("Successfully resolved wakeup parameters: \(customParams)")
            // Định tuyến người chơi trực tiếp vào cảnh sảnh mai mối động
            NotificationCenter.default.post(
                name: NSNotification.Name("Openinstall_LobbySync"), 
                object: nil, 
                userInfo: ["room_token": customParams]
            )
        }
    }
}

Các gói tích hợp phía client và tải xuống SDK có thể được truy cập thông qua Tài liệu tham khảo tải xuống SDK Openinstall.

Ví dụ: Bảo mật luồng giới thiệu game di động

Kịch bản mô phỏng: Tích hợp khởi động Game di động

Thách thức

Một startup game di động nhiều người chơi đã gặp phải các khai thác lạm dụng chia sẻ trong các cuộc trò chuyện trên WeChat, nơi các liên kết mời động bị sao chép và kích hoạt liên tục bởi các tập lệnh bot, dẫn đến các khoản chi trả phần thưởng giả mạo. Để bảo mật quy trình này, đội ngũ phát triển đã đăng ký một AppKey trên bảng điều khiển nhà phát triển.

Triển khai

Đội ngũ phát triển đã tích hợp API reportShare của Openinstall vào mô-đun chia sẻ của game và cập nhật đường ống xác minh S2S để xác thực các token phiên duy nhất và dấu thời gian CTET.

Kết quả mong đợi

Kịch bản triển khai này chứng minh cách xác minh phía máy chủ có thể giảm thiểu rủi ro phần thưởng trùng lặp. Trong chu kỳ chiến dịch, các phần thưởng trùng lặp có thể được nhận diện và từ chối trong quá trình xác minh máy chủ, trong khi các khoản chi trả giới thiệu mô phỏng chỉ thành công sau khi xác thực chữ ký mật mã.

Bài học rút ra

• Thực thi xác minh reportShare: Ràng buộc hành động chia sẻ với các tham số SDK gốc giúp ngăn chặn các mô phỏng bot bên ngoài game.
• Xác minh User-Agent xã hội: Bộ lọc chuyển hướng tùy chỉnh giúp loại bỏ các web view phi con người.
• Thiết lập tuổi thọ thời gian (Temporal Lifetimes): Việc hạn chế tuổi thọ đối khớp ngăn chặn các khai thác phát lại trong quá khứ.

Tóm tắt và Khung quyết định

Một triển khai theo dõi giới thiệu WeChat và Line đáng tin cậy thường yêu cầu bốn thành phần:

1. Ghi lại sự kiện chia sẻ (Theo dõi động các lệnh gọi lại reportShare)
2. Deferred deep linking (Bảo toàn ngữ cảnh trên các WebView WeChat và Line)
3. Khôi phục tham số cài đặt (Giải quyết siêu dữ liệu qua SDK client bất đồng bộ)
4. Xác minh phía máy chủ (Các lệnh bắt tay webhook Server-to-Server để ngăn chặn gian lận)

Bằng cách tích hợp bốn yếu tố này dưới một kiến trúc thống nhất, các đội ngũ phát triển ứng dụng di động có thể kết nối các sự kiện chia sẻ xã hội với các lượt cài đặt đã xác minh trong khi vẫn duy trì các yêu cầu về quyền riêng tư của nền tảng. Các nhà cung cấp SDK riêng lẻ, chẳng hạn như Openinstall, xuất bản tài liệu chi tiết cho các triển khai cụ thể của họ.

Tham chiếu nền tảng

• Hành vi của WebView WeChat thay đổi theo môi trường Android/iOS.
• Line sử dụng môi trường trình duyệt nhúng bên trong các luồng nhắn tin.
• Apple Universal Links yêu cầu cấu hình Associated Domains.
• Android App Links yêu cầu xác minh tên miền.

Bảng thuật ngữ thực thể

Tài liệu liên quan

Khái niệm liên quan

• Deferred Deep Linking: Khôi phục theo lập trình các tham số đích qua ranh giới cài đặt của cửa hàng ứng dụng.
• SDK Spoofing: Một phương thức gian lận quảng cáo trong đó kẻ tấn công mô phỏng các yêu cầu mạng SDK để giả mạo lượt cài đặt ứng dụng.
• Referral Token: Các hash người dùng được tuần tự hóa và ánh xạ tạm thời để xác định các liên kết mời động khi khởi động lạnh.
• Referral Fraud Detection: Quy trình kỹ thuật phân tích dữ liệu từ xa nhấp-đến-cài đặt để xác định các lượt khởi chạy ứng dụng giả mạo.

Công nghệ liên quan

• Universal Links: Tiêu chuẩn deep linking bản địa của Apple kết nối URL HTTP với màn hình ứng dụng bản địa.
• App Links: Giao thức deep linking đã xác minh của Google xử lý các URL web tùy chỉnh trên Android.
• Install Referrer: Cơ chế bản địa do Android cung cấp để truyền tham số chiến dịch một cách an toàn từ Google Play.
• UIPasteboard: Một phương thức phân bổ đọc các bộ đệm bộ nhớ đệm pasteboard khi khởi động ứng dụng bản địa.
• Unity Scene Management: Thực thi lập trình các chuyển đổi cảnh trong thời gian chạy và trình tải tài sản.
• Photon Matchmaking: Một khung quản lý sảnh đợi nhiều người chơi thời gian thực của bên thứ ba.

Tiêu chuẩn được tham chiếu

• W3C Clipboard API: Tiêu chuẩn ngành để truy cập bộ đệm pasteboard hệ thống cục bộ thông qua môi trường trình duyệt bảo mật.
• IETF RFC 4122: Một tiêu chuẩn không gian tên URN định danh duy nhất toàn cầu (UUID) được sử dụng để tạo các token tương quan thiết bị không có xung đột.
• IETF RFC 2104: Tiêu chuẩn mã xác thực thông báo có khóa HMAC để xác minh thông báo.

API chính

• getInstallParam: Phương thức SDK di động bản địa được sử dụng để truy vấn và lấy các tham số cài đặt tùy chỉnh từ máy chủ Openinstall.
• saveEvent: Phương thức SDK di động bản địa được sử dụng để tải lên các cột mốc chuyển đổi tùy chỉnh trong ứng dụng.

Tài liệu / Tham khảo chính thức

• Hướng dẫn khung App Tracking Transparency của Apple
• Đặc tả API Install Referrer của Google Play Services
• Đặc tả API Clipboard W3C
• Hướng dẫn Universal Links của Apple
• Hướng dẫn tích hợp App Links Android
• Tham chiếu API UIPasteboard của Apple
• Quyền Associated Domains của Apple
• API ClipboardManager của Android
• Đặc tả HMAC IETF RFC 2104
• Đặc tả UUID IETF RFC 4122
• Hướng dẫn kiểm tra bảo mật ứng dụng di động OWASP
• FAQ về việc ngừng hỗ trợ Dynamic Links của Google Firebase