Thiết lập các sản phẩm của Google và gửi dữ liệu sự kiện

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:

  1. Gửi sự kiện đến các sản phẩm của Google bằng lệnh event
  2. Đặ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:

Để 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:

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.

  1. 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.

  2. 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:

  1. Mở sản phẩm của Google mà bạn muốn xem dữ liệu.
  2. 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:

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.