--- title: "Cài đặt Adapty web pixel" description: "Cài đặt Adapty web pixel trên web funnel của bạn để các giao dịch mua qua Stripe hoặc Paddle được attribution về đúng quảng cáo đã dẫn dắt chúng." --- > **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skill. Claude Code (self-updating via plugin): `claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill && claude plugin install adapty-sdk-integration@adapty` — other tools: `npx skills add adaptyteam/adapty-sdk-integration-skill --all` Nếu bạn thu hút người dùng qua web funnel, Adapty web pixel sẽ kết nối từng lượt truy cập vào funnel 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 có sẵn cho các chiến dịch Meta Ads và TikTok for Business. :::tip Pixel chỉ khớp các lượt truy cập từ quảng cáo. Để đưa chính các giao dịch mua vào Adapty Attribution, hãy kết nối [Stripe](ua-stripe) hoặc [Paddle](ua-paddle). ::: ## Cách hoạt động \{#how-it-works\} Khi trang tải, pixel sẽ: - Gán cho khách truy cập một `click_id` và lưu trữ trong trình duyệt trong 7 ngày. - Thu thập các tín hiệu quảng cáo từ URL trang: click ID của Meta (`fbclid`) và TikTok (`ttclid`), định danh và tên của chiến dịch, nhóm quảng cáo và quảng cáo, cùng các tham số `utm_*`. - Gửi `click_id` và các tín hiệu đã thu thập tới Adapty trong nền. Khi 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. ## Trước khi bắt đầu \{#before-you-start\} Kết nối [Meta Ads](ua-facebook) hoặc [TikTok for Business](ua-tiktok) 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ã đó. ## Cài đặt pixel \{#install-the-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**. 3. Dán đoạn snippet vào thẻ `` của mọi trang trong funnel của bạn: ```html ``` 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. ## Gắn thẻ URL quảng cáo của bạn \{#tag-your-ad-urls\} Pixel đọc dữ liệu quảng cáo từ URL trang đích của bạn. Các mạng quảng cáo tự động thêm click ID của riêng họ (`fbclid` hoặc `ttclid`) để xác định mạng, nhưng không xác định được chiến dịch, nhóm quảng cáo hay quảng cáo cụ thể. Để attribution mua hàng xuống đúng quảng cáo, hãy thêm các tham số theo dõi vào quảng cáo của bạn: 1. Trong phần **Web funnel** của cấu hình chiến dịch, sao chép giá trị trong trường **Ad URL parameters**. 2. Trong mạng quảng cáo, dán giá trị ở cấp độ **ad**: - **Meta**: Vào trường **URL parameters** của quảng cáo. - **TikTok**: Bên dưới URL đích của quảng cáo, vào **Build URL parameters**. Giá trị này chứa các macro của mạng quảng cáo. Mạng sẽ thay thế chúng bằng giá trị thực của chiến dịch, nhóm quảng cáo và quảng cáo tại thời điểm click. Các tham số không bao gồm giá trị `utm_*`, vì vậy bạn có thể giữ nguyên cấu trúc UTM của mình cho analytics riêng — Adapty không yêu cầu điều đó. ## Quản lý đồng ý \{#manage-consent\} 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: ```js 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ẻ `