Các mục tài liệu
Lưu lượng
Kết nối với trang web
Để luồng bắt đầu hoạt động, hãy liên kết nó với trang web của bạn. Chỉ cần một cách. Quảng cáo dùng địa chỉ trang web của bạn, và các trang vẫn nằm ở chỗ bạn.
Trên trang này
Chọn cách nào
- Trang web trên Tilda, Webflow, Unbounce, Shopify hoặc WordPress → trình tạo trang.
- Traffic đã đi qua Keitaro hoặc Binom của bạn → bộ lọc Keitaro hoặc cổng Binom.
- Cần chế độ “Tracker” → chỉ có file PHP.
- Không sửa được code trang web, nhưng tên miền nằm trên Cloudflare → Cloudflare.
- Các trường hợp còn lại → thẻ JS, cách đầu tiên trong cửa sổ kết nối.
| Cách | Cần gì | Chế độ “Tracker” | Code của chúng tôi trong mã nguồn trang | Độ khó |
|---|---|---|---|---|
| Thẻ JS | quyền sửa <head> | không | nhìn thấy | dễ |
| File PHP | hosting có PHP | có | không thấy: quyết định trên máy chủ | trung bình |
| Keitaro / Binom | tracker riêng | không | không thấy: quyết định trên máy chủ | trung bình |
| Trình tạo trang, Cloudflare | tài khoản dịch vụ | không | nhìn thấy (vẫn là thẻ đó) | dễ |
Nếu site của luồng đặt ở chỗ chúng tôi (Đặt site ở đâu → Trên máy chủ của chúng tôi), bạn không cần kết nối gì: chúng tôi tự đặt file luồng lên máy chủ và tự cập nhật. Chi tiết trong mục Site.
Mở cửa sổ kết nối
Tìm luồng
Mục Luồng → ở dòng của luồng cần dùng, bấm ⋯ → Kết nối.

Hàng của luồng: 1 — menu thao tác của luồng, 2 — cửa sổ kết nối. Mở một cách
Các cách được thu gọn, mỗi lần chỉ mở được một cách. Cách đang hoạt động được đánh dấu màu xanh lá và nhãn “Đã cài đặt”.

Cửa sổ kết nối luồng: 1 thẻ JS, 2 file PHP — ở đây nó đã được cài trên trang web.
Luồng ở chế độ “Tracker” chỉ kết nối bằng file PHP — thẻ, Keitaro, Binom và trình tạo trang không hiện cho nó.
Thẻ JS
Sao chép code
Mở Thêm script vào landing page của bạn và bấm nút sao chép bên phải code 1.

Trong tài khoản demo code bị ẩn; trong tài khoản của bạn, ô 1 sẽ chứa code của luồng bạn. Dòng 2 — chỗ cần chèn: ngay sau <head>.Chèn nó thành dòng đầu tiên trong <head>
Trên mọi trang của landing — ngay sau
<head>, trên tất cả các script khác 2. Lưu lại và tải lại trang.index.html<head> <!-- code từ cửa sổ kết nối --> <meta charset="utf-8"> … </head>Đừng gắn code qua Google Tag Manager hay trình quản lý thẻ khác và đừng thêm
asynchoặcdefer: khi đó script chạy muộn hơn, và trang kịp hiện cho tất cả mọi người khi chưa có quyết định.Kiểm tra kết nối
Bấm Kiểm tra trang của tôi: tài khoản sẽ mở trang chính của thư mục chứa offer của luồng và tìm code ở đó. Không có địa chỉ offer thì không thể kiểm tra.

Nút kiểm tra — bước cuối của thẻ JS và file PHP. 
1 nút kiểm tra, 2 kết quả: đã tìm thấy code trên trang. Khối sẽ có dấu «Đã cài đặt».
Thẻ ẩn trang cho đến khi có quyết định. Nếu sau 5 giây vẫn chưa có quyết định, thẻ chuyển khách sang White Page. Còn nếu White Page không có địa chỉ riêng (chế độ “Mã trạng thái” hoặc trang dựng sẵn của chúng tôi), khách sẽ thấy trang trống.
File PHP
Dành cho trang web trên hosting có PHP. Là cách duy nhất cho chế độ “Tracker”. Chế độ shadow hoạt động với file PHP, bộ lọc Keitaro và cổng Binom.
Tải file về
Mở Tải file lên máy chủ của bạn và bấm Tải file 1.

Khối file PHP: 1 nút tải về và sơ đồ thư mục landing 2. Đặt nó vào thư mục gốc của landing với tên index.php
Còn landing của bạn thì đổi tên, ví dụ thành
offer.php:Thư mục landing/ ├── index.php ← file của chúng tôi └── offer.php ← landing của bạn (trước là index.php hoặc index.html)Nhập địa chỉ landing mới vào offer của luồng
Ví dụ,
https://trang-cua-ban.com/offer.php.Đặt file .htaccess bên cạnh
Các dòng này giống nhau cho mọi luồng; nếu trong thư mục đã có
.htaccess, hãy thêm chúng bên dưới dòngRewriteEngine Oncó sẵn..htaccessRewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^ index.php [L,QSA]Kiểm tra kết nối
Nút Kiểm tra trang của tôi — tài khoản sẽ kiểm tra xem file có phản hồi không.
Quy tắc chuyển vào file của chúng tôi mọi yêu cầu tới địa chỉ không có trên trang web. Việc này cần cho hai điều.
Trang tiền đích. Sau nút trên trang tiền đích, offer mở ở địa chỉ start trong cùng thư mục với link quảng cáo: trang-cua-ban.com/start?tham-so cho offer trang-cua-ban.com/offer.php, trang-cua-ban.com/thu-muc/start?tham-so cho trang-cua-ban.com/thu-muc/offer.php. Không có quy tắc này, khi tải lại trang đó sẽ gặp lỗi 404. Có quy tắc, nút {click_url} dẫn về tên miền của bạn — trang-cua-ban.com/start?tham-so, chứ không phải địa chỉ chuyển tiếp của chúng tôi: file tự báo lượt bấm cho chúng tôi, và tên miền của chúng tôi không có trong mã của trang tiền đích.
White Page từ tên miền khác. File phục vụ các trang, ảnh và style của nó qua địa chỉ thuộc tên miền của bạn: link menu white-site.com/kontakt.html trở thành trang-cua-ban.com/kontakt.html, và khách không rời sang tên miền của White Page. Không có quy tắc này, link vẫn dẫn về tên miền của White Page.
Trên nginx không có Apache, hãy thêm quy tắc bên dưới (thay /folder/ bằng thư mục của bạn) và vẫn đặt file .htaccess với các dòng như trên cạnh index.php: nginx không đọc nó, nhưng file của chúng tôi nhờ nó biết quy tắc đã được thiết lập. Nếu chỉ có try_files, trang vẫn tải lại bình thường, nhưng nút trang tiền đích và link của White Page sẽ dẫn tới địa chỉ của chúng tôi.
location /folder/ {
try_files $uri $uri/ /folder/index.php?$query_string;
}File trên máy chủ không tự cập nhật. Khi có phiên bản mới, cửa sổ sẽ hiện thông báo “Bạn đang chạy file cũ” và danh sách những gì phiên bản của bạn chưa làm được. Hãy tải file lại và thay thế.
Cách tải file lên hosting
Hãy đặt file PHP và .htaccess vào thư mục của trang web mà quảng cáo dẫn tới. Nếu quảng cáo dẫn tới my-landing.com/promo/, đó là thư mục public_html/promo/; nếu dẫn tới gốc my-landing.com/ — chính là public_html/.
Nếu trong thư mục đã có index.php hoặc index.html — đó là landing của bạn. Trước hết hãy đổi tên nó, ví dụ thành offer.php, và nhập địa chỉ mới vào offer của luồng; sau đó mới tải index.php của chúng tôi lên. Nếu không, nó sẽ ghi đè landing. Nếu có cả index.html lẫn index.php, nhiều hosting mở index.html trước — khi đó file của chúng tôi sẽ không chạy.
Qua trình quản lý file của bảng điều khiển hosting
Mở trình quản lý file
Trong bảng điều khiển hosting — mục “Files” hoặc “File Manager” 1.
Vào thư mục landing
Thường là
public_html(có khi làwwwhoặchtdocs), rồi đến thư mục mà quảng cáo trỏ tới 2.Bấm “Upload”
Nút 3 mở cửa sổ tải lên.

Giao diện ví dụ — nút ở hosting của bạn có thể có tên khác. 1 trình quản lý file, 2 thư mục landing, 3 tải lên. Chọn file
Kéo
index.phpvà.htaccessvào cửa sổ 4 và chờ đến khi có dấu “đã tải lên” 5. Tên phải đúng làindex.php: khi tải về lần nữa, trình duyệt đôi khi thêm “(1)” vào tên.
Giao diện ví dụ. 4 vùng tải lên, 5 file đã tải lên. Kiểm tra quyền và mở trang web
Quyền của file —
644, của thư mục —755. File.htaccessbị ẩn trong một số trình quản lý — hãy bật “hiện file ẩn”. Mở địa chỉ landing trong trình duyệt và bấm Kiểm tra trang của tôi trong tài khoản.
Qua FTP hoặc SFTP client
Kết nối
Host, tên người dùng và mật khẩu lấy trong bảng điều khiển hosting, mục FTP/SSH 1. Cổng: 21 cho FTP, 22 cho SFTP. Bấm “Connect” 2.
Mở thư mục landing trên máy chủ
Bên phải là máy chủ: vào
public_html/thu-muc3.Chuyển file
Bên trái là máy tính của bạn: chọn
index.phpvà.htaccess4 rồi kéo sang phải 5.
Giao diện ví dụ — nút ở client của bạn có thể có tên khác. 1 thông tin kết nối, 2 kết nối, 3 thư mục trên máy chủ, 4 file trên máy tính, 5 chuyển.
| Lỗi | Cách nhận ra | Cần làm gì |
|---|---|---|
| File nằm sai thư mục | Kết quả kiểm tra: “Trang của bạn đã mở, nhưng cài đặt này không phản hồi trên đó” | Đặt file vào thư mục mở ra theo địa chỉ trong quảng cáo |
| PHP cũ | Trang báo “PHP 7.2 or higher is required.” | Bật PHP 7.2 hoặc mới hơn trong bảng điều khiển hosting |
| Không có .htaccess hoặc nó bị ẩn | Sau nút trang tiền đích, trang start ra 404 | Tải .htaccess lên cạnh index.php |
| Proxy của hosting | Mọi lượt truy cập trong nhật ký có cùng một IP | Cho tên miền đi qua Cloudflare (đám mây màu cam) hoặc nhờ hosting chuyển IP thật của khách (xem Nếu có gì đó không hoạt động) |
| Cache của hosting hoặc CDN | Ai cũng thấy trang, quyết định không thay đổi ngay | Loại landing khỏi cache |
Bộ lọc cho Keitaro

Nếu traffic đã đi qua Keitaro của bạn, ArtisanClo trở thành bộ lọc trong stream của Keitaro: Keitaro hỏi chúng tôi có cho khách tới offer hay không, còn dẫn đi đâu cụ thể thì do các stream trong Keitaro của bạn quyết định.
Tải file bộ lọc của luồng này
Đặt nó lên máy chủ Keitaro
Vào thư mục
/var/www/keitaro/var/filters(ở phiên bản cũ —application/filters) và tải lại trang Keitaro.Thêm bộ lọc vào chiến dịch
Trong chiến dịch Keitaro, mở stream có offer và thêm bộ lọc có cùng tên với file, ở chế độ “Yes”. Bên dưới đặt stream có White Page của bạn — những ai không qua bộ lọc sẽ đi vào đó.
Keitaro hỏi bộ lọc trước khi trả lời khách, nên ở đây không có trang chờ: kiểm tra JavaScript, thời gian trên trang và tương tác thật không áp dụng với cách này, quyết định chỉ dựa trên mạng và dữ liệu của request. Địa chỉ offer và White Page trong luồng ArtisanClo không được dùng — chúng do các stream của Keitaro đặt. Nếu dịch vụ của chúng tôi không phản hồi trong 3 giây, lượt truy cập đi tới White Page. Kiểm tra JavaScript, thời gian và tương tác có thể bật riêng — xem Kiểm tra trình duyệt trên trang tiền đích.
Cổng cho Binom

Nếu traffic đi qua Binom của bạn, ArtisanClo kết nối với landing bằng cổng: phần kiểm tra của chúng tôi là dòng đầu tiên của landing và quyết định cho ai xem landing trước khi nó mở ra. Người thật thấy landing của bạn với link Binom tới offer như thường; bot và người kiểm duyệt thấy White Page.
Tải file cổng của luồng này
Và đặt nó cạnh file landing Binom trên máy chủ của bạn.
Gắn file ở dòng đầu tiên của landing
Trước mọi output:
Landing Binom<?php require __DIR__ . '/ac_binom_NNN.php'; ?>Kiểm tra kết nối
Người thật vào được landing, bot nhận White Page.
Cổng quyết định trước khi landing trả lời khách, nên không có trang chờ: kiểm tra JavaScript, thời gian trên trang và tương tác thật không áp dụng, quyết định chỉ dựa trên mạng và dữ liệu của request. Nếu dịch vụ của chúng tôi không phản hồi trong 3 giây, khách sẽ thấy White Page có địa chỉ được ghi vào file lúc tải về. Đổi White Page — hãy tải lại file. Nếu White Page không có địa chỉ riêng (chế độ “Mã trạng thái” hoặc trang dựng sẵn của chúng tôi), trong tình huống này cổng sẽ trả lỗi 503. Binom không có thư mục cho bộ lọc như Keitaro, nên chúng tôi kết nối bằng file nằm ngay trong landing. Kiểm tra JavaScript, thời gian và tương tác có thể bật riêng — xem Kiểm tra trình duyệt trên trang tiền đích.
Kiểm tra trình duyệt trên trang tiền đích
Bộ lọc của tracker chỉ thấy địa chỉ IP và header của request — bản thân trình duyệt thì nó không kiểm tra. Để kiểm tra cả trình duyệt, hãy đặt thẻ của chúng tôi lên trang tiền đích, nơi tracker gửi những ai đã qua bộ lọc. Thẻ sẽ xem JavaScript có chạy không, khách ở trên trang bao lâu, có di chuột hay cuộn trang không và có phải trình duyệt tự động không. Không qua kiểm tra — sẽ thấy White Page. Qua được — ở lại trang tiền đích và đi tiếp theo chiến dịch của bạn. Trong thống kê, lượt truy cập được tính một lần chứ không phải hai.
Bật trong cửa sổ kết nối luồng, ở khối bộ lọc Keitaro hoặc cổng Binom. Ở đó cũng hiện chính xác tham số cho địa chỉ trang tiền đích (bên dưới ký hiệu là NAME) và ba dòng cho biết mọi thứ đã kết nối đúng.

Keitaro
Thêm tham số vào địa chỉ trang tiền đích
Trong Keitaro, ở stream có offer, thêm tham số này vào địa chỉ trang tiền đích (hoặc landing) — qua
?nếu địa chỉ chưa có tham số, hoặc qua&nếu đã có. Nhờ nó, trên trang tiền đích chúng tôi nhận ra khách mà bộ lọc đã cho qua:Tham sốNAME={subid}Chèn thẻ của chúng tôi vào đầu <head> của trang tiền đích đó
Cập nhật file bộ lọc
Tải lại và thay file cũ — phiên bản mới gửi subid cho chúng tôi. Sau đó tự mở link chiến dịch: sau lượt truy cập đầu tiên, ba dòng kiểm tra sẽ chuyển sang màu xanh.
Binom
Thêm tham số vào địa chỉ landing
Trong Binom, thêm tham số này vào địa chỉ landing — qua
?hoặc&. Nhờ nó, trên landing chúng tôi nhận ra khách mà cổng đã cho qua:Tham sốNAME={clickid}Chèn thẻ của chúng tôi vào đầu <head> của chính landing đó
Cập nhật file cổng
Tải lại và thay file cũ — phiên bản mới đọc clickid. Sau đó tự mở link chiến dịch: sau lượt truy cập đầu tiên, ba dòng kiểm tra sẽ chuyển sang màu xanh.
Không có tham số, chúng tôi vẫn ghép lượt truy cập theo địa chỉ IP và trình duyệt, nhưng kém chính xác hơn: ở nhà mạng di động, một địa chỉ thường được nhiều người dùng chung. Lượt truy cập mà tracker cho qua sẽ xuất hiện trong nhật ký ngay khi thẻ phản hồi. Nếu khách không đến được trang tiền đích, lượt truy cập được ghi sau khoảng hai phút với quyết định mà bộ lọc trong tracker đã đưa ra. Ai mở trang tiền đích trực tiếp, bỏ qua tracker (ví dụ kiểm duyệt viên của mạng quảng cáo), sẽ đi qua toàn bộ kiểm tra của thẻ. Ở chế độ shadow và chế độ “Tracker”, kiểm tra này không hoạt động.
Trình tạo trang web

Ở gói Starter có thẻ JS, file PHP, bộ lọc Keitaro và cổng Binom. Plugin WordPress, worker Cloudflare và hướng dẫn từng bước cho trình tạo trang — từ Professional và trong thời gian dùng thử. Trang web trên Tilda, Webflow, Unbounce hoặc Shopify vẫn kết nối được ở Starter — bằng thẻ JS thông thường, chỉ là không có hướng dẫn.
- WordPress từ Professional — Tải plugin → trong WordPress “Plugins” → “Add New” → “Upload Plugin” → “Install Now” → “Activate” → “Settings” → Traffic Gate (tên plugin của chúng tôi) → dán API token từ mục “Tích hợp API” (menu dưới avatar) và chọn luồng. Nếu trang web có plugin cache, hãy xóa cache sau khi kết nối.
- Tilda, Webflow từ Professional — cần gói trả phí của chính trình tạo trang. Chèn code vào phần head và xuất bản trang web.
- Unbounce từ Professional — Script Manager, vị trí — Head. Không hoạt động trên tên miền phụ unbouncepages.com: cần tên miền riêng.
- Shopify từ Professional — chèn code vào template của theme ngay sau
<head>.
Mỗi trình tạo trang có khối riêng trong cửa sổ kết nối: 1 code để chèn — sao chép bằng nút bên phải, 2 các bước cho trình tạo trang đó.




Cloudflare từ Professional — thẻ được worker chèn ở phía Cloudflare, file của trang web không thay đổi. Từng bước — trong mục Kết nối qua Cloudflare.
Kiểm tra kết nối
- Kết quả kiểm tra: “Đã tìm thấy cài đặt trên trang của bạn.”, “Trang của bạn đã mở, nhưng cài đặt này không phản hồi trên đó.” hoặc thông báo không mở được trang — kèm lý do:
- trang không cho công cụ kiểm tra của chúng tôi vào — thường là lớp chống bot của hosting hoặc CDN (ví dụ bước kiểm tra của Cloudflare). Kết nối vẫn có thể đúng: lượt truy cập thật đầu tiên sẽ xác nhận điều đó;
- không có trang nào ở địa chỉ offer;
- máy chủ chứa trang của bạn trả về lỗi;
- trang không phản hồi kịp;
- trang chuyển hướng đi nơi khác.
- Nếu trên trang có thẻ của một luồng khác của bạn, kết quả kiểm tra sẽ nói rõ: «Trang đang gắn thẻ của một luồng khác của bạn — "…". Hãy thay bằng đoạn mã của luồng này» (đoạn mã — tức là code của thẻ).
- Có thể kiểm tra 20 giây một lần; nếu bấm sớm hơn, tài khoản sẽ trả lời “Vừa kiểm tra xong”. Mỗi lần kiểm tra sẽ gỡ các dấu “Đã cài đặt” và “Đã kết nối” ở mọi cách, kể cả Keitaro và Binom. “Đã cài đặt” quay lại ngay nếu kiểm tra tìm thấy kết nối, nếu không — với lượt truy cập đầu tiên. “Đã kết nối” luôn quay lại với lượt truy cập đầu tiên.
- Bên dưới mỗi cách sẽ hiện “Đang hoạt động” hoặc ngày hoạt động gần nhất.
Nếu script của thẻ không tải được (ví dụ bị mạng hoặc lớp bảo vệ trên máy chủ chặn), trang sẽ không bị ẩn và đội kiểm duyệt sẽ nhìn thấy nó. Hãy đặt code ở dòng đầu tiên và kiểm tra kết nối sau mỗi lần sửa trang web.
ArtisanClo · Tài liệu tài khoản. Câu hỏi — info@artisanclo.com hoặc @artisanclo_support trên Telegram.