Cài đặt qua Google Tag Manager ​

Google Tag Manager (GTM) cho phép cài AdsShield mà không cần chỉnh sửa code trực tiếp trên website — phù hợp với team marketing tự quản lý.

Cài đặt tự động — Tải file cấu hình (Khuyến nghị) ​

AdsShield có thể tự động tạo sẵn file cấu hình GTM đã điền đầy đủ thông tin website của bạn.

Các bước:

1. Vào Dashboard → Websites
2. Tìm website cần cài, nhấn nút GTM (màu xanh lá)
3. File AdsShield_GTM_Setup.json được tải về máy
4. Vào tagmanager.google.com → chọn Container → Quản trị (Admin)
5. Nhấn Nhập vùng chứa (Import Container)
6. Chọn file vừa tải → chọn Không gian làm việc hiện tại → Hợp nhất (Merge)
7. Nhấn Xác nhận

Sau khi import, GTM tự động tạo:

• Biến URL - gclid — đọc click ID từ URL quảng cáo
• Thẻ AdsShield - Conversion Webhook — gửi dữ liệu về AdsShield khi có chuyển đổi

Trước khi bắt đầu (Cài thủ công) ​

Bạn cần:

• Tài khoản GTM đã được cài trên website
• Tracking Key của website trong AdsShield (Websites → tên website → copy key)

Bước 1 — Tạo Tag mới ​

1. Vào tagmanager.google.com → chọn Container của website
2. Menu trái → Tags → New
3. Đặt tên tag: AdsShield Tracking

Bước 2 — Cấu hình Tag ​

1. Nhấn vào Tag Configuration
2. Chọn loại tag: Custom HTML
3. Dán đoạn script sau vào ô HTML:

<script>
  (function(){
    var s = document.createElement('script');
    s.src = 'https://fraud.digizone.vn/static/js/tracking.js';
    s.setAttribute('data-key', 'YOUR_TRACKING_KEY');
    s.async = true;
    document.head.appendChild(s);
  })();
</script>

4. Bật tùy chọn Support document.write → Tắt (không cần)

Bước 3 — Cấu hình Trigger ​

1. Nhấn vào Triggering
2. Chọn trigger All Pages nếu muốn theo dõi toàn bộ trang

Hoặc chỉ kích hoạt trên landing page quảng cáo:

1. Tạo trigger mới → loại Page View
2. Chọn Some Page Views
3. Điều kiện: Page URL → contains → /landing (hoặc path cụ thể của bạn)

Bước 4 — Test trước khi Publish ​

1. Nhấn Preview (góc trên phải GTM)
2. Nhập URL website → Connect
3. GTM mở tab mới và bắt đầu debug mode
4. Kiểm tra tag AdsShield Tracking trong danh sách Tags Fired

Nếu tag xuất hiện trong Tags Fired → cài đặt đúng.

Bước 5 — Publish ​

1. Đóng Preview
2. Nhấn Submit → Publish
3. Điền tên version, ví dụ: Thêm AdsShield tracking
4. Nhấn Publish

Xác nhận hoạt động ​

Sau khi publish, mô phỏng một click từ quảng cáo Google Ads:

1. Vào AdsShield Dashboard → Click Logs
2. Click mới nhất xuất hiện trong vài giây
3. Cột Score hiển thị điểm (0–100)

Nếu không thấy click sau 30 giây → kiểm tra lại Tracking Key và trigger.

Dùng GTM Variable cho Tracking Key ​

Nếu quản lý nhiều website trong cùng 1 GTM container, dùng Constant Variable:

1. GTM → Variables → New (User-Defined Variables)
2. Loại: Constant
3. Tên: AdsShield Key | Giá trị: your-tracking-key-here
4. Trong tag HTML, thay YOUR_TRACKING_KEY bằng {{AdsShield Key}}

<script>
  (function(){
    var s = document.createElement('script');
    s.src = 'https://fraud.digizone.vn/static/js/tracking.js';
    s.setAttribute('data-key', '{{AdsShield Key}}');
    s.async = true;
    document.head.appendChild(s);
  })();
</script>

Chọn trigger cho Conversion Webhook ​

Sau khi import file tự động, thẻ AdsShield - Conversion Webhook cần được gắn trigger phù hợp:

Xử lý sự cố ​

Lưu ý ​

• Script được obfuscate — không chỉnh sửa nội dung file tracking.js
• Không thu thập PII (thông tin cá nhân)
• Dữ liệu truyền qua TLS
• Cache 5 phút trên Nginx, không ảnh hưởng tốc độ trang