Trang này dành cho những nhà phát triển cần định cấu hình thẻ Google bằng gtag.js. Để điều chỉnh chế độ cài đặt trong giao diện người dùng, hãy xem bài viết Định cấu hình chế độ cài đặt thẻ Google.
Sau khi cài đặt thẻ Google, bạn có thể gọi các lệnh gtag() ở bất kỳ vị trí nào trong mã sau đoạn mã thẻ Google.
Trang này hướng dẫn bạn cách:
- Gửi sự kiện đến các sản phẩm của Google bằng lệnh
event - Đặt các giá trị được gửi cùng với mọi sự kiện bằng lệnh
set
Trước khi bắt đầu
Hướng dẫn này giả định rằng bạn đã làm xong những việc sau:
- Tìm hiểu cách hoạt động của thẻ Google
- Đã cài đặt thẻ Google
Để thiết lập luồng dữ liệu, bạn cần:
- Quyền truy cập vào mã trang web nơi bạn đã cài đặt thẻ Google
- Mã thẻ của sản phẩm của Google mà bạn muốn kết nối với thẻ Google
Mã thẻ là gì và cách tìm mã thẻ?
Mã thẻ hoặc mã vùng chứa xác định vùng chứa Trình quản lý thẻ của Google hoặc cấu hình đích đến của Google được tải bằng đoạn mã thẻ Google. Theo mặc định, các lượt cài đặt mới sẽ sử dụng mã vùng chứa của Trình quản lý thẻ của Google (GTM-), trong khi mã dành riêng cho đích đến sẽ xác định từng sản phẩm của Google. Bảng sau đây cung cấp thông tin tổng quan về các tiền tố mã nhận dạng được hỗ trợ:| Tiền tố | Loại mã nhận dạng | Mô tả |
|---|---|---|
| GTM-XXXXXX | Mã vùng chứa Trình quản lý thẻ của Google (mặc định) | Mã nhận dạng mặc định cho vùng chứa Trình quản lý thẻ của Google. Hỗ trợ tất cả thẻ Google, thẻ của bên thứ ba và thẻ tuỳ chỉnh. |
| G-XXXXXX | Mã nhận dạng theo đích đến | Xác định một đích đến của Google Analytics (Mã đo lường). |
| AW-XXXXXX | Mã nhận dạng theo đích đến | Xác định đích đến của quảng cáo Google Ads (Mã chuyển đổi). |
| DC-XXXXXX | Mã nhận dạng theo đích đến | Xác định đích đến của Floodlight (Mã nhận dạng nhà quảng cáo). |
| MC-XXXXXX | Mã nhận dạng theo đích đến | Xác định một đích đến của Google Merchant Center. |
| GT-XXXXXX | Mã thẻ Google | Xác định thẻ Google được tạo trong các phiên bản trước. |
Tìm mã thẻ của bạn:
Bước 1: Kết nối các sản phẩm của Google với thẻ của bạn
Sử dụng lệnh config để thiết lập luồng dữ liệu đến các sản phẩm của Google.
Giới thiệu về lệnh config
Lệnh config chỉ định những sản phẩm của Google mà bạn muốn gửi dữ liệu sự kiện đến.
Lệnh này có định dạng như sau:
gtag('config', 'TAG_ID', {<additional_config_params>});
Các tham số cấu hình bổ sung
Bạn có thể điều chỉnh và mở rộng lệnh config bằng cách chỉ định các tham số trong đối tượng {<additional_config_params>} không bắt buộc. Ví dụ: việc thêm tham số sau đây sẽ ngăn hệ thống tự động gửi lượt xem trang Google Analytics:
gtag('config', 'TAG_ID', {'send_page_view': false});
Thiết lập tính năng thu thập dữ liệu
Để thiết lập tính năng thu thập dữ liệu cho một sản phẩm của Google, hãy thêm lệnh config có mã thẻ.
Ví dụ
Thẻ Google (GT-XXXXXX) gửi dữ liệu đến các đích đến mà bạn đã xác định cho thẻ, chẳng hạn như Google Ads và Google Analytics.
Ví dụ sau đây cho biết cách cập nhật mã để tải thẻ Google thứ hai được kết nối với một đích đến Floodlight.
Để gửi dữ liệu đến Floodlight (mã thẻ DC-ZZZZZZ), hãy thêm một lệnh config khác
sau khi khởi chạy thẻ Google đầu tiên (mã thẻ GT-XXXXXX):
<head>
...
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'GT-XXXXXX');
gtag('config', 'DC-ZZZZZZ');
</script>
</head>
Hành vi config theo sản phẩm cụ thể
Tuỳ thuộc vào sản phẩm được chỉ định trong TAG_ID, lệnh config cũng có thể bắt đầu một số hành vi nhất định cho sản phẩm đó. Ví dụ: trong một số trường hợp, lệnh config sẽ yêu cầu gtag.js bắt đầu một sự kiện lượt xem trang.
Để tìm hiểu thêm về cách lệnh config hoạt động liên quan đến từng sản phẩm, hãy đọc tài liệu dành riêng cho từng sản phẩm:
- Lượt chuyển đổi trên Google Ads và hoạt động tái tiếp thị
- Campaign Manager và Display & Video 360
- Search Ads 360
- Google Analytics
Bước 2: Gửi dữ liệu bằng event
Sau khi định cấu hình kết nối với các sản phẩm của Google, bạn cần sử dụng lệnh event để gửi dữ liệu.
Giới thiệu về lệnh event
Lệnh event cho phép bạn gửi dữ liệu sự kiện đến các sản phẩm mà bạn đã chỉ định bằng lệnh config. Lệnh này có định dạng như sau:
gtag('event', 'event_name', {
'key': 'value',
});
Giới thiệu về tên sự kiện và cặp khoá-giá trị
Sự kiện được đề xuất: Sự kiện được đề xuất là những sự kiện do bạn triển khai, nhưng có cặp khoá-giá trị xác định trước. Những sự kiện này cho phép bạn sử dụng các tính năng báo cáo hiện có và sẽ có.
Sự kiện tuỳ chỉnh: Để xác định sự kiện và cấu trúc dữ liệu của riêng mình, bạn có thể nhập các giá trị tuỳ chỉnh để gửi một sự kiện tuỳ chỉnh.
Thiết lập sự kiện
Bạn có thể gọi phương thức event ở bất kỳ vị trí nào trong mã sau khi khởi chạy thẻ Google.
Xác định một sự kiện. Nếu bạn đang sử dụng một sự kiện được đề xuất, hãy đảm bảo rằng bạn sử dụng tên sự kiện được chuẩn hoá và cặp khoá-giá trị được xác định trước.
Xác định thời điểm sự kiện sẽ được kích hoạt, ví dụ: khi sự kiện được gửi cùng với một lượt tải trang hoặc khi người dùng nhấp vào một nút.
Ví dụ
Ví dụ sau đây minh hoạ một cách có thể đo lường lượt đăng ký nhận bản tin khi người dùng nhấp vào một nút. Ví dụ này sử dụng một sự kiện tuỳ chỉnh và gửi sự kiện đó đến một tài sản Google Analytics.
<head>
...
/* 1. Initialize the Google tag and gtag.js library */
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
</head>
<body>
<script>
let date = Date.now();
/* 2. Define your event. */
function newsletterSignup() {
gtag('event', 'newsletter_signup', {
'time': date,
});
}
</script>
...
/* 3. Trigger your event */
<button type="submit" onclick="newsletterSignup()">Sign me up!</button>
...
</body>
Không bắt buộc: Gửi dữ liệu cùng với mọi sự kiện bằng set
Lệnh set cho phép bạn xác định các tham số sẽ được liên kết với mọi sự kiện tiếp theo trên trang.
Ví dụ: bạn có thể chia sẻ các thông số chiến dịch để nhiều thẻ trên cùng một trang có thể truy cập vào các thông số đó.
Lệnh này có định dạng như sau:
gtag('set', 'parameterName');
Bước 3: Xác thực chế độ thiết lập
Cách đảm bảo dữ liệu sự kiện của bạn được gửi đúng cách:
- Mở sản phẩm của Google mà bạn muốn xem dữ liệu.
- Kiểm tra xem dữ liệu có đang được gửi đến hay không. Mỗi sản phẩm có một nơi riêng để bạn có thể kiểm tra xem dữ liệu có đang được nhận hay không:
- Google Analytics: Kiểm tra báo cáo theo thời gian thực.
- Google Ads: Kiểm tra bảng Hành động chuyển đổi và xem cột Trạng thái (có thể mất đến 24 giờ để cập nhật).
- Floodlight: Sử dụng Tag Assistant để xác minh rằng thẻ Floodlight đang kích hoạt.
Các bước tiếp theo
Sau khi thiết lập các sản phẩm và sự kiện của Google, bạn đã hoàn tất việc thiết lập cấu hình cơ bản cho thẻ Google.
Nếu bạn đang quản lý nhiều sản phẩm và muốn quản lý luồng dữ liệu của các sản phẩm đó một cách chi tiết hơn, hãy xem bài viết Nhóm và định tuyến dữ liệu.