API Phân tích của Linkly

Xuất dữ liệu nhấp chuột và báo cáo lưu lượng từ Linkly theo cách lập trình bằng API Phân tích của chúng tôi.

Liên quan: API Rút gọn Liên kết | Webhook

Trước khi bạn bắt đầu

Linkly tạo các yêu cầu API trong giao diện để bạn sao chép và dán vào ứng dụng của mình.

Tiết kiệm thời gian và để chúng tôi làm công việc khó khăn. API của chúng tôi hoàn toàn có thể tiêu thụ bằng máy.

Xác thực

Bạn sẽ cần Khóa API và ID Không gian làm việc của mình. Bạn có thể lấy các chi tiết này từ bên trong Linkly.

API báo cáo lưu lượng

Linkly tự động tạo các yêu cầu API cho bạn bên trong các báo cáo lưu lượng của bạn.

Các báo cáo lưu lượng của Linkly tự động xây dựng các yêu cầu API cho bạn, dựa trên dữ liệu được hiển thị trên màn hình.

Những liên kết này bao gồm khóa API của bạn, và dễ dàng tùy chỉnh và sử dụng trong ứng dụng của riêng bạn.

Định dạng đầu ra

API Phân tích hỗ trợ ba định dạng đầu ra:

Chế độ Pivot (định dạng ma trận)

Theo mặc định, API trả về dữ liệu chuỗi thời gian với một hàng cho mỗi ngày. Với chế độ pivot, bạn có thể lấy lưu lượng truy cập của tất cả các liên kết trong một yêu cầu duy nhất dưới dạng ma trận.

Sử dụng menu thả xuống Xuất dữ liệu trong bất kỳ báo cáo lưu lượng nào để nhanh chóng xuất dữ liệu theo liên kết, hoặc thêm pivot=link_id vào yêu cầu API của bạn.

Thêm pivot=link_id vào yêu cầu của bạn để nhận dữ liệu với:

• Ngày làm hàng (một hàng cho mỗi ngày)
• Liên kết làm cột (một cột cho mỗi liên kết)

Ví dụ đầu ra pivot CSV/TSV

Ví dụ đầu ra pivot JSON

{
  "links": [
    {"id": 123, "name": "My Link", "full_url": "https://linkly.link/abc"},
    {"id": 456, "name": "Other Link", "full_url": "https://linkly.link/xyz"}
  ],
  "data": [
    {"date": "2025-12-30", "clicks": {"123": 45, "456": 12}},
    {"date": "2025-12-31", "clicks": {"123": 52, "456": 8}}
  ]
}

Chế độ Pivot rất hữu ích cho:

• So sánh lưu lượng truy cập trên nhiều liên kết
• Nhập vào bảng tính để phân tích
• Xây dựng các bảng điều khiển với dữ liệu của tất cả các liên kết trong một cuộc gọi

Dữ liệu nhấp chuột thô

Dữ liệu nhấp chuột thô mà chúng tôi ghi lại, bao gồm các tham số đầy đủ, dấu thời gian và thông tin địa vị, có sẵn.

Để truy cập dữ liệu này, nhấp vào Xuất từ các tab ở dưới cùng và chọn định dạng của bạn. Đây là các yêu cầu API được hình thành hoàn chỉnh mà bạn có thể sử dụng trực tiếp trong ứng dụng của mình.

Ghi chú về xuất dữ liệu

• Hãy cân nhắc lọc dữ liệu trong chế độ xem trước để giảm lượng dữ liệu được xuất. Hàm này xuất dữ liệu cơ bản được sử dụng để tạo báo cáo hiện tại trên màn hình.
• Dữ liệu này được lưu vào bộ nhớ cache trong tối đa 3 giờ. Các yêu cầu lặp đi lặp lại đến điểm cuối này sẽ không tạo ra dữ liệu thời gian thực.

Đếm được nhóm

Điểm cuối /counters/{dimension} trả về tổng số lần nhấp được nhóm theo một thứ nguyên duy nhất — chẳng hạn như country, platform, destination, referer, isp hoặc link_id. Kết quả được trả về theo thứ tự là số lần nhấp, cao nhất trước.

Tối đa 10.000 giá trị được trả về. Các thứ nguyên khi lập bản đồ dữ liệu — destination, referer, remote_ip và isp — có thể có nhiều giá trị riêng biệt hơn nhiều so với số lần nhấp trên không gian làm việc bận rộn. Khi họ làm điều đó, bạn sẽ nhận được 10.000 hàng đầu theo số lần nhấp và phần còn lại không được trả về.

Trường total luôn là tổng số nhấp chuột trên mỗi nhóm, bao gồm bất kỳ nhóm nào không được trả về. Vì vậy, trên kết quả bị cắt ngắn, các giá trị count sẽ cộng lại thành ít hơn total — điều này có nghĩa là tỷ lệ phần trăm được tính toán là count / total vẫn chính xác.

Nếu bạn cần bộ giá trị hoàn chỉnh thay vì 10.000 hàng đầu, hãy xuất dữ liệu nhấp chuột thô và tự tổng hợp dữ liệu đó, hoặc sử dụng tích hợp BigQuery.

Thông báo nhấp chuột thời gian thực

Để nhận thông báo nhấp chuột thời gian thực, hãy xem Webhook. Webhook gửi yêu cầu POST đến URL được chỉ định của bạn ngay khi một nhấp chuột xảy ra, với thông tin chi tiết về nhấp chuột đó.

Bạn cũng có thể quản lý webhook qua API - xem thông số kỹ thuật OpenAPI để biết thêm chi tiết.

Chính sách sử dụng hợp lý

Giới hạn tỷ lệ

API Phân tích bị giới hạn ở 50 yêu cầu mỗi giờ cho mỗi không gian làm việc.

Giới hạn sử dụng

Ngoài giới hạn tỷ lệ, API Phân tích có các giới hạn sử dụng được đặt lại mỗi kỳ thanh toán:

Điều gì được tính là sử dụng

• Yêu cầu API: Mỗi lệnh gọi đến các điểm cuối API Phân tích (/clicks, /counters, /export) được tính là một yêu cầu.
• Dữ liệu quét: Lượng dữ liệu được xử lý bởi cơ sở dữ liệu phân tích của chúng tôi để thực hiện yêu cầu của bạn. Các phạm vi ngày lớn hơn và các truy vấn phức tạp hơn sẽ quét nhiều dữ liệu hơn.

Điều gì xảy ra khi bạn vượt quá giới hạn

Nếu bạn vượt quá giới hạn sử dụng của mình:

1. 1
   Các yêu cầu API sẽ trả về lỗi 429 Too Many Requests
2. 2
   Các giới hạn của bạn sẽ tự động được đặt lại vào đầu kỳ thanh toán tiếp theo của bạn
3. 3
   Các liên kết của bạn sẽ tiếp tục hoạt động và theo dõi nhấp chuột bình thường

Mẹo để giảm sử dụng

Hầu hết người dùng có thể nhận tất cả dữ liệu của họ trong một yêu cầu API duy nhất bằng cách sử dụng chế độ pivot (pivot=link_id), chế độ này trả về lưu lượng truy cập của tất cả các liên kết dưới dạng ma trận trong một cuộc gọi.

• Sử dụng chế độ pivot: Thêm pivot=link_id để nhận lưu lượng truy cập cho tất cả các liên kết trong một yêu cầu duy nhất thay vì truy vấn từng liên kết riêng biệt
• Phản ứng bộ nhớ cache: Lưu trữ các phản ứng API cục bộ thay vì tìm nạp cùng một dữ liệu nhiều lần
• Sử dụng phạm vi ngày nhỏ hơn: Truy vấn chỉ các ngày bạn cần
• Yêu cầu hàng loạt: Kết hợp nhiều truy vấn liên kết thành một yêu cầu duy nhất bằng cách sử dụng tham số link_ids

Cần thêm?

Nếu bạn cần những giới hạn cao hơn, vui lòng liên hệ với chúng tôi bằng widget hỗ trợ.

Tích hợp BigQuery

Để đáp ứng các nhu cầu phân tích khối lượng lớn, Linkly cung cấp tích hợp BigQuery cung cấp quyền truy cập SQL trực tiếp vào dữ liệu nhấp chuột của bạn.

• Truy cập dữ liệu trực tiếp - Truy vấn dữ liệu nhấp chuột của bạn trực tiếp trong BigQuery với các bản cập nhật thời gian thực
• Truy vấn không giới hạn - Không có giới hạn tỷ lệ API; bạn chỉ trả tiền cho tính toán BigQuery
• Báo cáo tùy chỉnh - Xây dựng bảng điều khiển bằng Looker, Data Studio hoặc Tableau
• Hợp nhất dữ liệu - Kết nối dữ liệu nhấp chuột với các chỉ số kinh doanh khác

Tích hợp BigQuery được bao gồm trong gói Enterprise. Liên hệ với chúng tôi để biết thêm chi tiết.

Tìm hiểu thêm về Tích hợp BigQuery →

Liên quan

• API Rút gọn Liên kết - Tạo và cập nhật liên kết theo cách lập trình
• Webhook - Thông báo nhấp chuột thời gian thực
• Tích hợp BigQuery - Truy cập SQL trực tiếp vào dữ liệu nhấp chuột
• Tích hợp Zapier - Tích hợp không mã