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áchCần gìChế độ “Tracker”Code của chúng tôi trong mã nguồn trangĐộ khó
Thẻ JSquyền sửa <head>khôngnhìn thấydễ
File PHPhosting có PHPcókhông thấy: quyết định trên máy chủtrung bình
Keitaro / Binomtracker riêngkhôngkhông thấy: quyết định trên máy chủtrung bình
Trình tạo trang, Cloudflaretài khoản dịch vụkhôngnhì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

  1. 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 trong danh sách: nút «⋯» và menu đang mở với các mục «Kết nối», «Nhân bản», «Xóa»
    Hàng của luồng: 1 — menu thao tác của luồng, 2 — cửa sổ kết nối.
  2. 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”: danh sách các cách — script JS, file PHP (đánh dấu “Đã cài đặt”), Keitaro, Binom, WordPress, Cloudflare, Tilda
    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

  1. 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.

    Khối “Thêm script vào landing page của bạn”: ô chứa code và nút sao chép, sơ đồ chèn vào head, cảnh báo về trình quản lý thẻ
    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>.
  2. 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 async hoặc defer: 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.

  3. 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.

    Bước “Kiểm tra kết nối” với nút “Kiểm tra trang của tôi”
    Nút kiểm tra — bước cuối của thẻ JS và file PHP.
    Bước “Kiểm tra kết nối” sau khi kiểm tra: nút “Kiểm tra trang của tôi” và dòng “Đã tìm thấy trên trang của bạn”
     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.

  1. 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 “Tải file lên máy chủ của bạn”: nút “Tải file”, sơ đồ thư mục với index.php và offer.php, bước nhập địa chỉ landing mới
    Khối file PHP: 1 nút tải về và sơ đồ thư mục landing 2.
  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)
  3. Nhập địa chỉ landing mới vào offer của luồng

    Ví dụ, https://trang-cua-ban.com/offer.php.

  4. Đặ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òng RewriteEngine On có sẵn.

    .htaccess
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.php [L,QSA]
  5. 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 .htaccess để làm gì

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.

nginx
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

  1. Mở trình quản lý file

    Trong bảng điều khiển hosting — mục “Files” hoặc “File Manager” 1.

  2. Vào thư mục landing

    Thường là public_html (có khi là www hoặc htdocs), rồi đến thư mục mà quảng cáo trỏ tới 2.

  3. Bấm “Upload”

    Nút 3 mở cửa sổ tải lên.

    Ví dụ bảng điều khiển hosting: trình quản lý file, đường dẫn /public_html/promo/ và nút 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.
  4. Chọn file

    Kéo index.php và .htaccess và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.

    Ví dụ cửa sổ tải lên: vùng thả file và hai file đã tải lên index.php và .htaccess
    Giao diện ví dụ. 4 vùng tải lên, 5 file đã tải lên.
  5. Kiểm tra quyền và mở trang web

    Quyền của file — 644, của thư mục — 755. File .htaccess bị ẩ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

  1. 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.

  2. Mở thư mục landing trên máy chủ

    Bên phải là máy chủ: vào public_html/thu-muc 3.

  3. Chuyển file

    Bên trái là máy tính của bạn: chọn index.php và .htaccess 4 rồi kéo sang phải 5.

    Ví dụ FTP client: các trường kết nối, bên trái là file trên máy tính, bên phải là thư mục /public_html/promo/ trên máy chủ
    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ỗiCách nhận raCần làm gì
File nằm sai thư mụcKế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ị ẩnSau nút trang tiền đích, trang start ra 404Tải .htaccess lên cạnh index.php
Proxy của hostingMọi lượt truy cập trong nhật ký có cùng một IPCho 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 CDNAi cũng thấy trang, quyết định không thay đổi ngayLoại landing khỏi cache

Bộ lọc cho Keitaro

Khối “Bộ lọc cho Keitaro” trong cửa sổ kết nối: ba bước và nút “Tải bộ lọc”
 1 tải bộ lọc, 2 đặt file ở đâu trên máy chủ Keitaro, 3 cách thêm bộ lọc vào stream của 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.

  1. Tải file bộ lọc của luồng này

  2. Đặ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.

  3. 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

Khối “Cổng cho Binom” trong cửa sổ kết nối: ba bước, dòng gắn file và nút “Tải cổng”
 1 tải cổng, 2 dòng đặt làm dòng đầu tiên của landing, 3 kiểm tra: người thật ở landing, bot ở White Page.

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.

  1. 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.

  2. 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'; ?>
  3. 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.

Khối «Kiểm tra trình duyệt trên trang tiền đích» trong bộ lọc Keitaro: tham số cho địa chỉ trang tiền đích, thẻ và ba dòng kiểm tra màu xanh
 1 tham số cho địa chỉ trang tiền đích, 2 thẻ cho <head> của trang đó, 3 ba dòng kiểm tra — mọi thứ đã kết nối.

Keitaro

  1. 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}
  2. Chèn thẻ của chúng tôi vào đầu <head> của trang tiền đích đó

  3. 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

  1. 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}
  2. Chèn thẻ của chúng tôi vào đầu <head> của chính landing đó

  3. 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

Khối WordPress trong cửa sổ kết nối: các bước cài plugin và nút “Tải plugin”
 1 tải plugin, 2 cài vào WordPress, 3 dán API token, 4 chọn luồng.

Ở 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 đó.

Khối Tilda: code để chèn và ba bước
Tilda. 1 «Mã để dán», 2 các bước cài đặt.
Khối Webflow: code để chèn và ba bước
Webflow. 1 «Mã để dán», 2 các bước cài đặt.
Khối Unbounce: code để chèn và bốn bước
Unbounce. 1 «Mã để dán», 2 các bước cài đặt.
Khối Shopify: code để chèn và bốn bước
Shopify. 1 «Mã để dán», 2 các bước cài đặt.

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.
    Mã phản hồi ghi trong ngoặc — có thể gửi nó cho bộ phận hỗ trợ.
  • 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.
Code phải được tải đầu tiên

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.