Tài liệu redirect minh bạch

Link tracking của Postbackly hoạt động thế nào, từng request một. Để báo conversion, xem postback API.

Tóm tắt

Domain tracking: go.postbackly.click (HTTPS)
Tham số minh bạch: url: bước tiếp theo luôn là giá trị của nó
Tham số chúng tôi thêm: chỉ pbclid (mã click của chúng tôi)
Redirect: một lần 302 Found, thẳng tới đích, không qua domain trung gian
Đường dẫn: mọi đường dẫn trên domain tracking đều theo url, kể cả /
Tham số phụ: không có: url luôn được tôn trọng

Cấu trúc link

https://go.postbackly.click/l/<link_key>?sub1=fb_campaign_12&sub2=adset_7&url=https%3A%2F%2Fshop.example.com%2Fsale

Thành phần	Tác dụng
`/l/<link_key>`	Xác định một cặp offer và publisher để ghi click cho đúng người. Không bao giờ quyết định khách đi đâu.
`sub1` đến `sub5`	Nhãn tuỳ chọn do publisher tự đặt (chiến dịch, nhóm quảng cáo, vị trí…), tối đa 255 ký tự mỗi nhãn. Ghi lại để báo cáo, không bao giờ gửi sang đích.
tham số khác	Ví dụ `gclid` hay `campaignid` trên URL tracking. Ghi cùng click, không bao giờ gửi sang đích.
`url`	Địa chỉ đích, đã mã hoá URL. Bắt buộc: đây là thứ duy nhất quyết định redirect.

Bảng điều khiển dựng sẵn mỗi link với landing page của offer trong url. Publisher có thể đổi url sang một trang sâu hơn. Nếu offer bật Chỉ host đã đăng ký, đích trên host khác bị từ chối bằng 403; không bao giờ bị thay bằng landing page đã đăng ký.

Tham số url

Tracker luôn chuyển tới giá trị của url. Không có đích nào lưu trên máy chủ để dùng thay, và landing page lưu trong offer không bao giờ được thế vào chỗ của nó.
Tên phân biệt hoa thường (url, không phải URL). Nếu có nhiều url, lấy cái đầu tiên.
Giá trị phải được mã hoá URL, như {lpurl} của Google đã làm sẵn, và được giải mã đúng một lần. Dấu & chưa mã hoá trong đích sẽ cắt giá trị giữa chừng, phần còn lại thành tham số của tracker.
Sau khi giải mã, giá trị phải là URL http:// hoặc https:// đầy đủ, dài tối đa 4.096 ký tự, không chứa tên đăng nhập hay mật khẩu, không trỏ tới địa chỉ nội bộ hay mạng riêng.

Mọi đường dẫn đều minh bạch

Bất kỳ đường dẫn nào trên go.postbackly.click có tham số url đều chuyển tới giá trị đó: /l/<link_key>, /, /l/ với mã không tồn tại, hay đường dẫn bất kỳ. Request không có mã link hợp lệ vẫn được chuyển tiếp y hệt; chỉ là click không được ghi cho offer hay publisher nào.

GET, POST và HEAD nhận cùng một phản hồi 302. Tracker chạy trên HTTPS; request tới http:// nhận 301 sang cùng URL trên https:// trước. Phản hồi redirect không có header Referrer-Policy, nên chúng tôi không thay đổi referrer mà trình duyệt gửi tới đích.

Tham số pbclid

Tham số	Giá trị	Mục đích
`pbclid`	16 ký tự ngẫu nhiên trong `A–Z a–z 0–9 - _` (base64url), mới cho mỗi click	Mã click của chúng tôi. Landing page lưu nó cùng đơn hàng và gửi lại trong postback.

pbclid là tham số duy nhất Postbackly thêm vào, và chỉ dành riêng cho dịch vụ của chúng tôi. Nó được nối vào cuối chuỗi query của đích, trước #fragment nếu có, bằng ? hoặc & tuỳ trường hợp. Không có gì khác trong đích bị thay đổi: thứ tự tham số, cách mã hoá, tham số rỗng, {macro}, gclid, gad_source, UTM và URL tracker lồng bên trong giữ nguyên từng ký tự. Nếu đích đã có pbclid, tham số đó được giữ và tham số của chúng tôi thêm vào sau.

Chúng tôi không bao giờ thêm UTM, mã affiliate, sub-id hay bất kỳ tham số ngoại nào. Tham số trên chính URL tracking, gồm sub1 đến sub5 và gclid do Google Ads thêm, được ghi lại và không bao giờ bị chép sang đích. Thay đổi duy nhất khác: ký tự không được phép trong header HTTP, như khoảng trắng hay chữ có dấu, được mã hoá phần trăm.

Ví dụ

Link của publisher có sub-id; đích đã có sẵn tham số riêng

GET https://go.postbackly.click/l/Xk29fQ7aLm?sub1=fb_campaign_12&sub2=adset_7&url=https%3A%2F%2Fshop.example.com%2Fsale%3Futm_source%3Dpartner%26gclid%3DCj0KCQiA

HTTP/1.1 302 Found
Location: https://shop.example.com/sale?utm_source=partner&gclid=Cj0KCQiA&pbclid=Rk7pW2xQa9Lm_3Tc

sub1 và sub2 được ghi lại, không chuyển tiếp. utm_source và gclid nằm trong url nên tới landing page nguyên vẹn.

Đích có fragment và không có query

GET https://go.postbackly.click/l/Xk29fQ7aLm?sub1=tiktok_03&url=https%3A%2F%2Fshop.example.com%2Fkhoa-hoc%23dang-ky

HTTP/1.1 302 Found
Location: https://shop.example.com/khoa-hoc?pbclid=Rk7pW2xQa9Lm_3Tc#dang-ky

Đường dẫn gốc, không có mã link

GET https://go.postbackly.click/?url=https%3A%2F%2Fshop.example.com%2F

HTTP/1.1 302 Found
Location: https://shop.example.com/?pbclid=Rk7pW2xQa9Lm_3Tc

Macro và tham số rỗng được giữ nguyên văn

GET https://go.postbackly.click/l/Xk29fQ7aLm?url=https%3A%2F%2Fshop.example.com%2Fp%3Fref%3D%7Bclickid%7D%26empty%26a%3D1

HTTP/1.1 302 Found
Location: https://shop.example.com/p?ref={clickid}&empty&a=1&pbclid=Rk7pW2xQa9Lm_3Tc

Tracker lồng nhau

Đích có thể là một click tracker khác. Chúng tôi chuyển tới đúng nguyên văn (chỉ thêm pbclid vào cuối query của nó), sau đó tracker kia đi theo tham số minh bạch của chính nó. Theo hướng dẫn của Google Ads, mỗi tracker lồng bên trong cũng phải tự có chứng nhận; nhà cung cấp tracker đó chịu trách nhiệm nộp đơn của mình.

Hãy mã hoá toàn bộ URL lồng bên trong, kể cả tham số đã mã hoá của nó. Đúng:

GET https://go.postbackly.click/l/Xk29fQ7aLm?url=https%3A%2F%2Ftrack.partner.example%2Fclick%3Fdest%3Dhttps%253A%252F%252Fshop.example.com%252Fsale

HTTP/1.1 302 Found
Location: https://track.partner.example/click?dest=https%3A%2F%2Fshop.example.com%2Fsale&pbclid=Rk7pW2xQa9Lm_3Tc

Sai: không mã hoá thì đích bị cắt ở dấu & đầu tiên, x=1 thành tham số của tracker và tracker lồng bên trong nhận một dest bị hỏng:

https://go.postbackly.click/l/Xk29fQ7aLm?url=https://track.partner.example/click?dest=https://shop.example.com/sale&x=1

Lỗi và chặn

Request bị từ chối nhận trang báo lỗi và không bao giờ bị chuyển sang nơi khác.

Mã	Khi nào
302	`url` hợp lệ và không bị chặn. Location là giá trị `url` cộng `pbclid`.
400	`url` không phải URL `http`/`https` đầy đủ; có tên đăng nhập hoặc mật khẩu (`https://user:pass@…`); trỏ tới `localhost`, tên miền `.local`, `.internal` hay địa chỉ mạng nội bộ; dài quá 4.096 ký tự; hoặc bị mã hoá hai lần (`https%253A…`).
403	Host đích nằm trong danh sách chặn lạm dụng; link, offer của nó hoặc tài khoản đã bị tạm khoá; hoặc offer chỉ nhận host đã đăng ký mà `url` trỏ sang host khác.
404	Không có tham số `url`, ở mọi đường dẫn trừ `/`. Trang thông tin, không redirect.
200	https://go.postbackly.click/ không kèm `url`: trang cho biết ai vận hành tracker và cách báo cáo lạm dụng.

Chúng tôi chặn những host bị báo cáo hoặc bị phát hiện là trang lừa đảo, mã độc hay nội dung gây hại khác. Báo cáo link lạm dụng tracker của chúng tôi tới abuse@postbackly.click.

Bot và xem trước link

Request từ bot và công cụ tự động đã biết (AdsBot-Google và các crawler khác của Google, tính năng xem trước link của ứng dụng chat, dịch vụ giám sát uptime) cùng request HEAD, OPTIONS nhận đúng redirect như mọi người. Chúng chỉ được đánh dấu là bot để không tính vào số click, CR và EPC. Postbackly không bao giờ đổi đích theo người xem, thiết bị, quốc gia hay thời điểm, và không xoay vòng giữa nhiều đích.

Google Ads

Dùng tracking template, để URL cuối cùng của quảng cáo vẫn là landing page của bạn và Google tự điền nó vào {lpurl}, đã mã hoá sẵn:

https://go.postbackly.click/l/YOUR_LINK_KEY?sub1={campaignid}&sub2={adgroupid}&sub3={keyword}&gclid={gclid}&url={lpurl}

Sao chép mã link của cặp offer và publisher trong bảng điều khiển, thay vào YOUR_LINK_KEY.
Trong Google Ads, mở mục Theo dõi của tài khoản, chiến dịch hoặc nhóm quảng cáo, dán vào ô Mẫu theo dõi.
Bấm Kiểm tra: Google sẽ tải được landing page. Sau đó lưu.

Có thể bỏ bất kỳ tham số nào, trừ url={lpurl}. gclid={gclid} trên URL tracking được ghi cùng click để bạn tham chiếu; Google vẫn tự thêm gclid của họ vào landing page như bình thường.

Parallel trackingVới parallel tracking của Google Ads, mặc định ở hầu hết chiến dịch, khách đi thẳng tới URL cuối cùng còn Google gọi URL tracking ở chế độ nền. Click vẫn được ghi (kèm gclid từ gclid={gclid} trong template), nhưng landing page không nhận được pbclid. Khi đó hãy gửi postback bằng gclid mà landing page nhận được thay cho click_id: nó sẽ được ghép với click đã ghi. Xem tham số postback.

Dữ liệu ghi lại cho mỗi click

Thời điểm, địa chỉ IP, user agent, referrer, header accept-language, mã link, sub1 đến sub5, các tham số khác trên URL tracking, URL đích, pbclid chúng tôi tạo và dấu bot. Lưu 90 ngày. Tracker không đặt cookie, không chạy script và không lấy dấu vân tay trình duyệt. Chi tiết trong chính sách bảo mật.