Bỏ qua đến nội dung

Tài liệu kỹ thuật

Tích hợp LRS trong một buổi chiều.

LR Link — Tổng quan

LR Link mở khoá một thứ trong ứng dụng của bạn khi người dùng đã mở đủ các link bạn chọn, đúng thiết bị, trong thời hạn — kết quả ký Ed25519, cấp khoá tự động.

Bạn chọn vài link (trang sản phẩm, trang giới thiệu, bài viết…), người dùng mở đủ các link đó thì ứng dụng của bạn mở khoá một thứ: tính năng, phần thưởng, khoá LR License, mã quà tặng. Bật dịch vụ (miễn phí, đơn 0đ) và tạo chiến dịch ở /app/link.

Luồng

  1. Ứng dụng (hoặc máy chủ của bạn) tạo một lượt cho người dùng: POST /link/runs. Câu trả lời có các link bọc https://<tên miền link>/g/<token> (mỗi link của lượt một link bọc) và trang lượt hub_url (https://<tên miền link>/g/r/<token>).
  2. Người dùng mở từng link bọc. Trang trung gian kiểm tra thiết bị và chống gian lận, rồi mới chuyển tới link đích. Link đích không bao giờ lộ ra trước khi trang kiểm tra xong.
  3. Ứng dụng hỏi lại lượt (poll) mỗi vài giây. Khi đủ link, lượt thành completed và có result có chữ ký — chỉ tin kết quả này để mở khoá.

Cách đơn giản nhất: chỉ hiện một link hoặc mã QR là hub_url. Trang lượt liệt kê các link theo thứ tự kèm trạng thái (đã tính, chưa mở, mở sai thiết bị). Mỗi link mở trong một tab mới, nên người dùng làm lần lượt mà không phải quay lại ứng dụng. Trang lượt chỉ là danh sách: mỗi lần mở vẫn qua trang trung gian trên chính thiết bị đó. Nếu chiến dịch chỉ nhận điện thoại mà người dùng mở trên máy tính, trang hiện mã QR của trang lượt, quét một lần là làm hết trên điện thoại; trang trên máy tính tự cập nhật tiến độ.

SDK LinkGate (cùng gói SDK LR License: Node/TypeScript, C#, C++, Python) làm hết các bước trên: LinkGate (SDK).

Chiến dịch

Thiết lậpMặc địnhÝ nghĩa
Bể link—Không giới hạn theo gói (trần kỹ thuật 10 000 link). Mỗi link có nhãn, link https://, bật/tắt; nhập hàng loạt ở tab Bể link.
Số link mỗi lượtsố link khi tạo1–10 (hạn mức tổ chức). Mỗi lượt lấy ngẫu nhiên N link đang bật theo vòng, không trùng trong một lượt; hết vòng mới xáo lại.
Thiết bịmobileLoại thiết bị được tính: mobile, tablet, desktop (tối đa ba) hoặc any. Sai thiết bị thì trang hiện mã QR của trang lượt.
Thời hạn lượt1800 giây60–86 400 giây. Quá hạn thì lượt thành expired, link bọc ngừng chạy.
Khoảng cách giữa hai lần mở2 giây0–600 giây giữa hai link của cùng một lượt.
Hoàn thành mỗi người dùng mỗi ngàykhông giới hạn1–1000 theo external_user; vượt thì createRun nhận user_limit.
Khi hoàn thànhkết quả có chữ kýThêm cấp khoá LR License, webhook, phát mã.

Lượt hoàn thành khi người dùng mở đủ N link của lượt đó. Mọi link đang bật đều được phát đều nhau: trong một vòng, mỗi link được phát một lần. Link mới thêm vào vòng sau; link tắt bị bỏ qua ngay. Khi N bằng đúng số link đang bật, mọi lượt có đủ các link theo thứ tự trong bể.

Trạng thái chiến dịch: draft (chưa nhận lượt), active, paused, archived. LRS có thể tạm khoá chiến dịch vi phạm điều khoản (campaign_suspended).

Mã chiến dịch và khoá ký

Mỗi chiến dịch có mã lcmp_… và khoá ký Ed25519 riêng (lksk_…), xem ở tab Tổng quan của chiến dịch. Mã chiến dịch và khoá công khai không phải bí mật; nhúng cả hai vào ứng dụng. Xoay khoá và ngừng khoá cũ giống hệt LR License: trong thời gian xoay, mỗi câu trả lời có hai chữ ký.

Link bọc chạy trên tên miền link riêng của LRS, không bao giờ trên lrsvn.com. API luôn trả URL đầy đủ, nên ứng dụng không cần biết tên miền; LRS đổi tên miền khi cần mà bạn không phải cập nhật ứng dụng.

Trách nhiệm của bạn

Bạn chịu trách nhiệm về link đích và tuân thủ chính sách của nơi bạn dẫn người dùng tới (kể cả chính sách tiếp thị liên kết). LR Link chỉ đếm lượt mở hợp lệ; không cam kết người dùng mua hàng hay ở lại trang đích.