Tim Kencang.in
Số liệu thống kê trong bảng điều khiển trả lời câu hỏi "bao nhiêu". Thông báo theo thời gian thực trả lời “bây giờ chuyện gì sẽ xảy ra”. Khi một chiến dịch mới đi vào hoạt động, nhóm muốn biết lượt nhấp đầu tiên đến, nó đến từ đâu và liệu quảng cáo có thực sự chạy hay không. Kencang.in hỗ trợ ba kênh thông báo: Slack, Zapier và webhook tùy chỉnh tới máy chủ của riêng bạn.
Kích hoạt kênh thông báo
Mở bảng điều khiển, menu Kênh hoặc Tích hợp, sau đó chọn kênh bạn muốn kết nối. Mỗi liên kết có thể được chuyển hướng đến một hoặc nhiều kênh. Thông báo có sẵn trên các gói Pro và Business; nhìn trang định giá.
Slack
- Nhấp chuột Kết nối Slack và cho phép ứng dụng Kencang.in truy cập vào không gian làm việc của bạn.
- Chọn kênh đích, ví dụ:
#kampanye. - Trong cài đặt liên kết, bật thông báo và chọn kênh Slack.
Mỗi lần nhấp chuột sẽ gửi một thông báo ngắn gọn: bí danh, vị trí, thiết bị và nguồn giới thiệu. Đối với các liên kết có số lượng lớn, hãy sử dụng bản tóm tắt hàng giờ để tránh lấp đầy kênh. Ngoài thông báo nhấp chuột, bạn cũng có thể tạo liên kết trực tiếp từ Slack bằng lệnh /kencang https://... sau khi ứng dụng được cài đặt. Tài liệu API của Slack có tại api.slack.com.
Zapier
Kết nối Zapier trong menu Tích hợp, sau đó trong Zapier tạo Zap với trình kích hoạt "Kencang.in: New Click" (hoặc Webhooks của Zapier "Catch Hook" với URL chúng tôi cung cấp). Từ đây, dữ liệu về lượt nhấp có thể được truyền trực tuyến ở mọi nơi: hàng mới trong Google Sheets, thẻ trong Trello, tin nhắn trong API WhatsApp Business hoặc email. Cách kết nối Zapier theo hướng ngược lại, cụ thể là tạo liên kết tự động, sẽ được thảo luận trong bài viết Zapier và Google Sheets.
Webhook tùy chỉnh
Để tích hợp trực tiếp vào hệ thống của bạn, hãy nhập URL điểm cuối HTTPS. Mỗi lần nhấp sẽ gửi một yêu cầu POST có nội dung JSON.
Điểm cuối của bạn sẽ phản hồi trạng thái 2xx trong vòng vài giây. Nếu thất bại, chúng tôi thử lại nhiều lần với độ trễ tăng dần. Các phương pháp hay nhất ở đầu nhận:
- Trả lời nhanh, xử lý sau. Nhận tải trọng, xếp hàng, trả lời 200, sau đó xử lý nó trong trình chạy. Đừng làm công việc nặng nhọc khi được yêu cầu.
- Xác minh nguồn. Chúng tôi bao gồm tiêu đề chữ ký HMAC dựa trên bí mật được hiển thị trong bảng điều khiển. Tính toán lại HMAC của nguyên liệu thô và so sánh trước khi xử lý. Sử dụng so sánh liên tục theo thời gian như
hash_equals()trong PHP. - Bình thường. Vì có cơ chế thử lại nên cùng một sự kiện có thể xảy ra hai lần. Lưu kết hợp ID sự kiện hoặc bí danh + thời gian để phát hiện sự trùng lặp.
- Sử dụng HTTPS với chứng chỉ hợp lệ. Webhook thành HTTP thông thường bị từ chối.
Các nguyên tắc chung về thiết kế bộ thu webhook đáng tin cậy được tóm tắt rõ ràng trong Hướng dẫn thực hành tốt nhất về webhook GitHubvà hầu hết chúng đều áp dụng cho bất kỳ dịch vụ nào.
Ví dụ điểm nhận tối giản (PHP)
<?php
$raw = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_KENCANG_SIGNATURE'] ?? '';
$secret = getenv('KENCANG_WEBHOOK_SECRET');
if (!hash_equals(hash_hmac('sha256', $raw, $secret), $sig)) {
http_response_code(401);
exit;
}
$event = json_decode($raw, true);
// masukkan ke antrean, mis. Redis/database
http_response_code(200);
Ý tưởng sử dụng
- Phát hiện bất thường: số lần nhấp tăng đột biến từ một quốc gia trong một phút có thể có nghĩa là bot; gửi cảnh báo.
- Phân bổ doanh số: khớp thời gian nhấp chuột với các đơn đặt hàng đến để ước tính số chuyển đổi trên mỗi kênh.
- Ghi điểm dẫn đầu: bấm từ link cá nhân (
/budi,/sari) cập nhật CRM ngay lập tức. - Bảng thông tin nội bộ: hiển thị các nhấp chuột theo thời gian thực trên màn hình văn phòng khi khởi chạy.
Dữ liệu tương tự cũng có thể được lấy định kỳ thông qua API thống kê; chọn webhooks khi bạn cần tốc độ và API khi bạn cần báo cáo đầy đủ. Nhìn kìa tài liệu dành cho nhà phát triển để biết chi tiết về cả hai phương pháp.
Câu hỏi thường gặp
Mỗi lần nhấp có gửi một tin nhắn Slack không?
Theo mặc định là có. Đối với các liên kết có số lượng lớn, hãy chọn chế độ tóm tắt hàng giờ để kênh không bị ngập hoặc gửi thông báo trực tiếp đến webhook tùy chỉnh và tạo tập hợp của riêng bạn trước khi gửi tới Slack.
Làm thế nào để đảm bảo webhook thực sự đến từ Kencang.in?
Mỗi yêu cầu bao gồm chữ ký HMAC dựa trên bí mật xuất hiện trong bảng điều khiển. Tính toán lại HMAC của phần thân thô và so sánh nó với tiêu đề bằng cách sử dụng so sánh thời gian không đổi trước khi xử lý dữ liệu.
Điều gì xảy ra nếu máy chủ của tôi ngừng hoạt động?
Chúng tôi đã thử lại nhiều lần với độ trễ tăng lên. Nếu tất cả các lần thử đều không thành công, sự kiện sẽ bị bỏ qua và được ghi là không thành công trong bảng điều khiển. Thống kê lần nhấp vẫn được lưu trữ tại Kencang.in và có thể được truy xuất thông qua API.
Một link có thể gửi tới nhiều kênh được không?
Có. Một liên kết duy nhất có thể được kết nối với Slack, Zapier và nhiều webhook tùy chỉnh cùng một lúc. Mỗi kênh nhận được cùng một tải trọng, vì vậy các nhóm tiếp thị và hệ thống nội bộ sẽ nhận được dữ liệu giống hệt nhau.
