English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

Cài đặt web pixel của Adapty

Nếu bạn thu hút người dùng qua web funnel hoặc landing page, web pixel của Adapty sẽ liên kết mỗi lượt truy cập với quảng cáo đã đưa họ đến. Pixel gán cho mỗi khách truy cập một click ID. Khi khách truy cập thanh toán, bạn truyền click ID đó cùng với giao dịch, và Adapty Attribution sẽ khớp giao dịch mua đó với đúng chiến dịch, nhóm quảng cáo và mẫu quảng cáo.

Pixel này có sẵn cho các chiến dịch Meta Ads và TikTok for Business.

Note

Nếu funnel của bạn chạy trên FunnelFox, bạn không cần pixel. Xem Tích hợp FunnelFox với Adapty Attribution.

Cách hoạt động

Khi trang tải, pixel sẽ:

  • Gán cho khách truy cập một click_id và lưu nó trong trình duyệt trong 7 ngày.
  • Ghi lại các tín hiệu quảng cáo từ URL trang: click ID của Meta (fbclid) và TikTok (ttclid), mã định danh và tên của chiến dịch, nhóm quảng cáo, quảng cáo, cùng các tham số utm_*.
  • Gửi click_id và các tín hiệu đã ghi lại đến Adapty trong nền.

Tại bước thanh toán, bạn chỉ cần đính kèm click_id vào giao dịch. Adapty sẽ khớp nó với các tín hiệu mà pixel đã gửi trước đó và tự động xác định kênh quảng cáo.

Tip

Pixel chỉ ghi nhận lượt truy cập từ quảng cáo. Để đưa các giao dịch mua vào Adapty Attribution, hãy kết nối Stripe hoặc Paddle.

Trước khi bắt đầu

Kết nối Meta Ads hoặc TikTok for Business với Adapty Attribution và thêm cấu hình chiến dịch. Adapty tạo đoạn mã pixel theo từng cấu hình chiến dịch, vì vậy bạn cần có một cấu hình để sao chép đoạn mã từ đó.

Pixel đọc dữ liệu quảng cáo từ URL trang đích của bạn, vì vậy các quảng cáo phải mang theo tham số theo dõi của Adapty. Nếu không có, Adapty chỉ gán purchase cho mạng quảng cáo chứ không gán được cho chiến dịch, nhóm quảng cáo hay quảng cáo cụ thể. Xem Gắn thẻ URL quảng cáo cho web funnel.

Cài đặt pixel

  1. Trong Adapty Attribution, mở cấu hình chiến dịch Meta Ads hoặc TikTok của bạn.
  2. Trong tab General, mở rộng phần Web funnel và sao chép giá trị trường Pixel snippet.
Pixel snippet field in the Web funnel section of a campaign configuration in Adapty Attribution
  1. Dán đoạn snippet vào thẻ <head> của mọi trang trong funnel của bạn:
<script async src="https://api-ua.adapty.io/pixel/loader.js" data-code="YOUR_CODE"></script>

Giá trị data-code xác định ứng dụng và chiến dịch của bạn. Đây là mã định danh công khai, không phải bí mật.

Pixel ghi một cookie bên thứ nhất và một mục localStorage, đồng thời đọc các ID click quảng cáo khi tải trang. Bạn là người kiểm soát dữ liệu cho funnel của mình và chịu trách nhiệm về cơ sở pháp lý cho việc này.

Theo mặc định, pixel chạy khi tải trang. Để kiểm soát nó theo sự đồng ý, thêm data-consent="denied" vào đoạn mã — pixel sẽ không lưu trữ hay gửi bất kỳ dữ liệu nào cho đến khi bạn cấp quyền từ banner cookie của mình:

window.adaptyPixel.grantConsent();  // start capture
window.adaptyPixel.revokeConsent(); // clear stored state and stop
window.adaptyPixel.getConsent();    // 'granted' | 'denied'
Warning

Hãy chặn pixel bằng consent cho traffic EU/EEA. Các quy tắc ePrivacy yêu cầu phải có consent trước khi lưu trữ trên trình duyệt, và pixel attribution first-party không được miễn trừ.

Đoạn snippet tải bất đồng bộ, vì vậy window.adaptyPixel sẽ không tồn tại ngay trên dòng sau thẻ <script>. Hãy gọi API consent từ callback của banner consent, hoặc bảo vệ lần gọi sớm bằng if (window.adaptyPixel) { ... }.

Ghi chú sử dụng

  • Funnel một trang: Điều hướng phía client giữ nguyên click_id, nên funnel được xây dựng dạng single-page app hoạt động mà không cần cấu hình thêm.
  • Tính ổn định của Click ID: Đọc click_id khi tải trang hoặc khi thanh toán đều trả về cùng một giá trị. Nếu người dùng vào lại funnel từ một quảng cáo mới, lần click quảng cáo mới nhất sẽ được ưu tiên.
  • Gia hạn: Chỉ gắn click_id vào giao dịch đầu tiên. Adapty gán attribution cho các lần chuyển đổi dùng thử và gia hạn gói đăng ký thông qua chính gói đăng ký đó.