Tích hợp
Google Tag Manager (server-side)
Gửi lượt nhấp và chuyển đổi tới server-side GTM container của bạn dưới dạng hit GA4 Measurement Protocol.
Tích hợp Google Tag Manager gửi mọi lượt nhấp Letlink được ghi nhận và mọi chuyển đổi đã duyệt tới server-side GTM container của riêng bạn dưới dạng hit GA4 Measurement Protocol. Khi sự kiện đã vào tagging server, mọi tag trong container đều có thể xử lý nó — GA4, Google Ads, Meta, kho dữ liệu — nên bạn chỉ cấu hình đích một lần trong GTM thay vì cho từng công cụ. Có trong gói Growth và Ultimate.
Bạn cần gì
- Một server-side container đang chạy với địa chỉ HTTPS riêng, ví dụ
https://gtm.example.com. - Một client Measurement Protocol trong container đó. GTM không thêm sẵn client này.
- Measurement ID (
G-…) của luồng web GA4 mà container chuyển tiếp tới.
Chuẩn bị container
- Trong server container của bạn, mở Clients → New và chọn loại client Measurement Protocol.
- Đặt Activation Path thành
/mp/collect(hoặc đường dẫn bất kỳ bạn muốn — bạn sẽ nhập cùng đường dẫn đó trong Letlink) và lưu. - Thêm hoặc dùng lại một tag Google Analytics: GA4 được kích hoạt bởi client đó, cùng các tag khác mà bạn muốn sự kiện đến được, rồi Submit container.
Kết nối với Letlink
- Mở Tích hợp → Google Tag Manager (phía máy chủ). Chỉ dành cho chủ sở hữu và quản trị viên.
- Nhập URL tagging server (không kèm đường dẫn), Measurement ID và, nếu bạn đã thay đổi, đường dẫn client.
- API secret là tùy chọn. Dán GA4 Measurement Protocol secret nếu tag GA4 của bạn dùng nó để chuyển tiếp hit tới Google.
- Lưu và nhấn Gửi sự kiện thử, rồi xem yêu cầu đến trong chế độ Xem trước của container.
Những gì chúng tôi gửi
Một yêu cầu POST tới <tagging server><path>?measurement_id=G-… với nội dung GA4 Measurement Protocol tiêu chuẩn. client_id là cùng dấu vân tay thiết bị mà bảng điều khiển sử dụng, và quốc gia của khách truy cập được đưa vào user_location khi biết.
| Sự kiện Letlink | Sự kiện GA4 | Tham số bổ sung |
|---|---|---|
| Lượt nhấp | link_click |
short_code, link_type, variation, destination_url, các giá trị UTM, click_id |
| Đơn bán | purchase |
transaction_id (ID đơn hàng của bạn), value, currency |
| Khách tiềm năng | generate_lead |
value, currency khi được gửi |
| Đăng ký | sign_up |
method = short_link |
| Tùy chỉnh | Tên sự kiện của bạn, được chuẩn hóa theo quy tắc GA4 | value, currency khi được gửi |
Mỗi chuyển đổi cũng mang conversion_id (conv-<id>) và click_id của lượt nhấp tạo ra nó, để bạn có thể nối dữ liệu trong BigQuery hoặc loại trùng lặp trong tag.
Không nhận được gì — tôi nên kiểm tra những gì?
- URL tagging server phải dùng HTTPS và truy cập được từ internet. Lỗi
404thường nghĩa là không client nào nhận đường dẫn: hãy kiểm tra activation path của client Measurement Protocol. - Chế độ Preview chỉ hiển thị yêu cầu khi đang mở. Hãy gửi sự kiện thử sau khi mở nó.
- Chuyển đổi luôn được gửi tới tích hợp này, kể cả khi không gian làm việc không chuyển tiếp chuyển đổi tới các nền tảng quảng cáo.