Gán chuyển đổi và doanh số

Chuyển đổi là một lần bán hàng hoặc thanh toán từ người ủng hộ mà LinkHarbor có thể gán cho một lượt nhấp trên trang của bạn. Nhờ vậy, bạn không chỉ thấy một liên kết được nhấp bao nhiêu lần mà còn thấy kết quả mang lại. Bài này dành cho nhà sáng tạo có cửa hàng riêng và cho nhà phát triển kết nối cửa hàng. Bạn có thể phân tích chuyển đổi và tạo mã bí mật callback từ gói Creator Pro.

#Chuyển đổi đến từ đâu

• Doanh số mà cửa hàng hoặc máy chủ của bạn báo về qua sale callback
• Thanh toán từ người ủng hộ qua Stripe; khi hoàn tiền, chuyển đổi bị xóa lại, xem Thanh toán từ người ủng hộ với Stripe

Mỗi chuyển đổi kế thừa dữ liệu của lượt nhấp tương ứng: trang, liên kết, quốc gia, thiết bị, nguồn giới thiệu và tham số UTM. Vì thế nó xuất hiện trong thống kê đúng ở nơi lượt nhấp bắt nguồn.

#Cách gán chuyển đổi hoạt động

1. Một khách truy cập nhấp vào liên kết trên trang của bạn
2. LinkHarbor đếm lượt nhấp và, khi chuyển hướng, gắn tham số lt_click_id với một click ID duy nhất vào URL đích
3. Trang đích của bạn (ví dụ cửa hàng) đọc lt_click_id từ địa chỉ và giữ lại cho đến khi mua hàng
4. Sau khi mua, máy chủ của bạn gửi một sale callback kèm click ID này đến LinkHarbor
5. Chuyển đổi xuất hiện trên bảng điều khiển và trong thống kê của trang

Click ID chỉ được gắn vào các đích bắt đầu bằng http:// hoặc https://. Liên kết mailto: hoặc tel: không có click ID, vì tham số sẽ làm hỏng tiêu đề thư hoặc số điện thoại. Lượt nhấp từ bot cũng không có click ID.

#Tạo mã bí mật callback

Một sale callback phải tự xác thực bằng mã bí mật callback. Từ gói Creator Pro, chủ sở hữu và quản trị viên quản lý mã bí mật ở mục “Callback & API” trong phần tài khoản của menu.

1. Mở “Callback & API”
2. Trong thẻ “Mã bí mật callback”, nhấp “+ Tạo mã bí mật mới”
3. Nếu muốn, nhập tên, ví dụ “Callback cửa hàng”
4. Nhấp “Tạo mã bí mật”
5. Sao chép mã bí mật ngay: mã chỉ hiển thị một lần

“Chỉnh sửa”

Đổi tên và trạng thái (Hoạt động hoặc Không hoạt động). Mã bí mật không hoạt động sẽ bị từ chối.

“↺ Xoay vòng”

Tạo mã bí mật mới. Mã cũ ngừng hoạt động ngay lập tức – vì vậy hãy nhập mã mới vào cửa hàng ngay.

“Xóa”

Xóa mã bí mật sau khi bạn xác nhận.

“Callback gần nhất:”

Cho biết lần cuối mã bí mật được dùng, nếu chưa thì hiện “Chưa từng dùng”.

Bạn có thể tạo tối đa 5 mã bí mật callback cho mỗi không gian làm việc.

#Gửi sale callback

Máy chủ của bạn gửi một yêu cầu POST đến API của LinkHarbor. Mã bí mật nằm trong header X-Callback-Secret.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Bắt buộc. Click ID từ lt_click_id (10–36 ký tự).

order_id

Bắt buộc. Mã đơn hàng của bạn (1–128 ký tự). Mỗi mã đơn hàng chỉ được tính một chuyển đổi, nên callback gửi lặp lại không tạo chuyển đổi thứ hai.

amount

Bắt buộc. Số tiền dưới dạng số thập phân.

currency

Bắt buộc. Mã tiền tệ 3 chữ cái, ví dụ EUR.

occurred_at, meta

Không bắt buộc. Thời điểm mua hàng và tối đa 50 khóa tùy chỉnh (mỗi khóa 1–64 ký tự) chứa thông tin bổ sung. Mỗi giá trị là văn bản tối đa 500 ký tự, một số, true/false hoặc null; API từ chối object lồng nhau.

Phản hồi

Mọi trường và mã lỗi dành cho nhà phát triển có trong Gửi doanh số và dữ liệu tùy chỉnh.

#Phân tích chuyển đổi

• Bảng điều khiển: các ô “Chuyển đổi” và “CVR” cùng thẻ “Chuyển đổi” theo nguồn và phương tiện UTM
• Thống kê trang: thẻ “Chuyển đổi” với “CVR tổng”, “CVR duy nhất” và “Chi tiết”
• CVR tổng = chuyển đổi chia cho lượt nhấp; CVR duy nhất = chuyển đổi chia cho lượt nhấp duy nhất