Thẻ Google là một đoạn mã có thể được thêm vào một trang web để đo lường hoạt động của người dùng trên nhiều sản phẩm của Google, bao gồm cả Google Analytics, Google Ads và Google Marketing Platform. Tìm hiểu thêm về thẻ Google.
Hướng dẫn này mô tả cách tích hợp thẻ Google vào Hệ thống quản lý nội dung (CMS) hoặc trình tạo trang web để cung cấp cho người dùng cuối quyền truy cập vào các sản phẩm đo lường của Google.
Đối tượng
Hướng dẫn này dành cho chủ sở hữu Hệ thống quản lý nội dung (CMS) hoặc trình tạo trang web muốn cung cấp cho người dùng một chế độ tích hợp với các sản phẩm đo lường của Google. Hướng dẫn này không dành cho người dùng CMS hoặc trình tạo trang web.
Trước khi bắt đầu
Đảm bảo bạn có Mã nhà phát triển thẻ Google. Nếu bạn chưa có Mã nhận dạng nhà phát triển thẻ Google, hãy điền vào biểu mẫu yêu cầu Mã nhận dạng nhà phát triển thẻ Google. Mã nhận dạng nhà phát triển khác với các mã nhận dạng khác, chẳng hạn như Mã đo lường hoặc Mã chuyển đổi mà người dùng cuối thêm vào mã đo lường trang web của họ.
Tổng quan
Để tích hợp nền tảng của bạn với các sản phẩm của Google, hãy làm theo các bước sau:
- Tạo mối tích hợp với thẻ Google
- Cập nhật cấu trúc hoạt động đầu vào của người dùng
- Triển khai API chế độ đồng ý
- Thiết lập dữ liệu sự kiện
- Xác minh chế độ tích hợp mới cập nhật
- Cập nhật hướng dẫn triển khai cho người dùng
Tạo chế độ tích hợp với thẻ Google
Bằng cách tạo mối tích hợp với thẻ Google, khách hàng của bạn có thể triển khai các sản phẩm đo lường của Google (thông qua gtag.js) trên mọi trang trong trang web của họ. Hãy nhớ xoá mọi chế độ tích hợp thẻ cũ hiện có (ví dụ: analytics.js) trước khi tạo chế độ tích hợp với gtag.js.
Để tạo một mối tích hợp với thẻ Google, hãy thay thế đoạn mã hiện có bằng đoạn mã sau. Đảm bảo người dùng có thể thay thế TAG_ID bằng Mã nhận dạng thẻ của riêng họ.
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GOOGLE_TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
gtag('js', new Date());
gtag('config', 'GOOGLE_TAG_ID');
</script>
Xin lưu ý những điều sau:
- Nhà quảng cáo có thể chọn không sử dụng các tính năng cá nhân hoá quảng cáo như tái tiếp thị bằng thông số
allow_ad_personalization_signals(xem phần Tắt tính năng thu thập dữ liệu quảng cáo được cá nhân hoá. - Lý tưởng nhất là đoạn mã thẻ Google chỉ nên xuất hiện một lần trên mỗi trang. Đoạn mã này có thể chứa nhiều mã thẻ. Nếu có một phiên bản gtag.js hiện tại, bạn nên thêm mã nhận dạng thẻ mới vào thẻ hiện tại. Tìm hiểu thêm.
Cập nhật cấu trúc hoạt động đầu vào của người dùng
Khách hàng của bạn có thể cung cấp nhiều dạng mã thẻ Google thông qua một giao diện, bất kể họ đang triển khai sản phẩm đo lường nào của Google.
Ví dụ: sau đây là một đầu vào thẻ Google đơn giản. Hoạt động tích hợp này phải được coi là một hoạt động triển khai cho thẻ Google. Bạn có thể đặt tiêu đề phụ cho phương pháp này là cách triển khai Google Ads và Google Analytics.
Ngoài ra, sơ đồ sau đây cho thấy cách một nền tảng có thể có các luồng người dùng riêng biệt cho Analytics và Google Ads, nhưng mỗi luồng đều dẫn đến một giao diện nơi người dùng cung cấp mã nhận dạng thẻ Google của họ.
Đầu vào mã nhận dạng thẻ sẽ chấp nhận nhiều biến thể mã nhận dạng bằng cách sử dụng mẫu biểu thức chính quy [A-Z]{1,3}\\w{5,}[\w]*.
Triển khai API chế độ đồng ý (còn gọi là Chế độ đồng ý)
Thẻ Google có API chế độ đồng ý tích hợp để quản lý sự đồng ý của người dùng. Thẻ này có thể phân biệt sự đồng ý của người dùng đối với cookie cho mục đích quảng cáo với sự đồng ý đối với cookie cho mục đích phân tích.
Kết quả mong đợi là khách hàng nhận được ít nhất gtag('consent', 'update' {...}) cuộc gọi được tích hợp mà không cần phải làm gì. Điều này sẽ đảm bảo rằng thẻ Google (Google Ads, Floodlight, Google Analytics, Trình liên kết chuyển đổi) có thể đọc trạng thái đồng ý mới nhất của người dùng và đưa trạng thái đó vào các yêu cầu mạng gửi đến Google (thông qua tham số &gcs).
Các bước triển khai bổ sung sẽ là triển khai hoặc hỗ trợ nhà quảng cáo triển khai (ví dụ: thông qua giao diện người dùng) trạng thái gtag('consent', default' {...}) và bỏ chặn thẻ Google (tức là không có điều kiện kích hoạt dựa trên sự đồng ý) để cho phép chế độ đồng ý kích hoạt các thẻ này dựa trên trạng thái đồng ý.
Để biết thông tin chi tiết về cách triển khai, hãy xem phần Quản lý chế độ cài đặt về sự đồng ý (trên web).
Thiết lập dữ liệu sự kiện
Bạn nên gửi dữ liệu sự kiện phong phú từ trang web của khách hàng đến Tài khoản Google của họ mà khách hàng không cần làm gì cả. Ví dụ: bạn có thể thêm các sự kiện dọc theo một phễu mua hàng (tức là add_to_cart, begin_checkout, add_payment_info, add_shipping_info và purchase), tạo khách hàng tiềm năng và lượt đăng ký.
Sau đây là các phương pháp hay nhất để thêm sự kiện:
- Ghi nhật ký mọi thứ có thể
- Thiết lập ít nhất 8 sự kiện chính
- Ưu tiên sự kiện thương mại điện tử
Ghi nhật ký mọi thứ có thể
Nếu có thể, bạn nên thiết lập sự kiện theo mặc định. Nội dung như vậy bao gồm:
- Sự kiện chính, chẳng hạn như
purchasehoặcsign_up - Sự kiện trước sự kiện chính, chẳng hạn như
add_to_cart - Mức độ tương tác dựa trên hành vi, chẳng hạn như lượt tương tác với nội dung nghe nhìn, giúp khách hàng hiểu rõ cách họ đang tương tác với người dùng cuối
Bạn chỉ nên thêm đoạn mã sự kiện chính vào các trang sự kiện chính (ví dụ: xác nhận mua hàng, xác nhận gửi biểu mẫu). Xin lưu ý rằng bạn vẫn nên thêm thẻ Google vào mọi trang trên trang web.
Sự kiện được gửi bằng lệnh event.
Điều này bao gồm cùng một Mã nhận dạng nhà phát triển thẻ Google mà bạn đã thêm vào thẻ trang web chung như mô tả ở trên:
gtag('event', 'my_event', {
'developer_id.<developer ID>': true,
// Additional event parameters
});
Ví dụ: bạn có thể dùng lệnh event để gửi sự kiện login có giá trị method là "Google":
gtag('event', 'login', {
'developer_id.<developer ID>': true,
'method': 'Google'
});
<!-- Event snippet for sales conversion page -->
<script>
gtag('event', 'conversion', {
'developer_id.<developer ID>': true,
'value': <value>,
'currency': '<currency>',
'transaction_id': '<transaction_id>'
});
</script>
Xin lưu ý những điều sau:
- Mã nhận dạng nhà phát triển
<developer ID>là mã nhận dạng riêng biệt và dành riêng cho nền tảng của bạn. Đính kèm mã nhận dạng vào mọi sự kiện. - Các tham số sau đây là không bắt buộc và có thể bỏ qua:
'value'là giá trị bằng số của sự kiện quan trọng (ví dụ: giá của một giao dịch mua)'currency'là mã đơn vị tiền tệ gồm 3 chữ cái, hữu ích cho những nhà quảng cáo chấp nhận nhiều đơn vị tiền tệ'transaction_id'là một mã nhận dạng riêng biệt của giao dịch (ví dụ: mã đơn đặt hàng); mã này được dùng cho mục đích loại bỏ trùng lặp.
- Mặc dù một số thông số là không bắt buộc, nhưng bạn nên đưa nhiều thông tin nhất có thể cho mỗi sự kiện.
- Thông số cung cấp thêm thông tin về cách người dùng tương tác với trang web hoặc ứng dụng của bạn. Ví dụ: khi người dùng xem một sản phẩm mà bạn bán, bạn có thể thêm các thông số mô tả về sản phẩm mà họ đã xem (như tên, danh mục và giá sản phẩm).
- Một số thông số tự động điền các phương diện và chỉ số được tạo sẵn trong Google Analytics, đồng thời giúp người dùng hiểu rõ hơn về khách hàng của họ.
Nếu muốn đo lường một sự kiện chính dựa trên lượt nhấp (ví dụ: lượt nhấp vào nút hoặc phản hồi động cho một trang web sử dụng AJAX), bạn cũng có thể sử dụng đoạn mã sau:
<!-- Event snippet for sales conversion page
In your HTML page, add the snippet and call gtag_report_conversion
when someone clicks on the chosen link or button. -->
<script>
function gtag_report_conversion(url) {
var callback = function () {
if (typeof(url) != 'undefined') {
window.location = url;
}
};
gtag('event', 'conversion', {
'developer_id.<developer ID>': true,
'value': <value>,
'currency': '<currency>',
'transaction_id': '<transaction_id>',
'event_callback': callback
});
return false;
}
</script>
Thiết lập ít nhất 8 sự kiện chính
Bạn nên thiết lập một nhóm sự kiện cốt lõi có giá trị nhất đối với chủ sở hữu trang web. Ở mức tối thiểu, bạn nên thiết lập các sự kiện sau:
view_item_list: khi người dùng xem danh sách các mục (ví dụ: danh sách sản phẩm). Tìm hiểu thêmgtag('event', 'view_item_list', { item_list_id: "related_products", item_list_name: "Related products", items: [{ item_id: "SKU_123", item_name: "Test Item", currency: "USD", discount: 2.22, price: 99.9, quantity: 1 }] });add_to_cart: khi người dùng thêm một hoặc nhiều sản phẩm vào giỏ hàng. Tìm hiểu thêmgtag('event', 'add_to_cart', { value: 99.0, currency: "USD", items: [{ item_id: "SKU_123", item_name: "Test Product", price: 99.0, currency: 'USD', quantity: 1, item_category: "All Products" }] });begin_checkout: khi người dùng bắt đầu quy trình thanh toán cho một hoặc nhiều sản phẩm. Tìm hiểu thêmgtag('event', 'begin_checkout') { value: 99.0, currency: "USD", items: [{ item_id: "SKU_123", item_name: "Test Product", price: 99.0, currency: 'USD', quantity: 1, item_category: "All Products" }] });purchase: khi người dùng mua một hoặc nhiều sản phẩm hoặc dịch vụ. Tìm hiểu thêmgtag('event', 'purchase', {value: XX, currency: 'USD', items: [{xx},{xx}]});sign_up: khi người dùng đăng ký để người dùng cuối có thể thấy các phương thức đăng ký phổ biến nhất (ví dụ: Tài khoản Google, địa chỉ email). Tìm hiểu thêmgtag('event', 'sign_up', {method: 'web'});generate_lead: khi người dùng gửi một biểu mẫu. Tìm hiểu thêmgtag('event', 'generate_lead', {value: XX, currency: 'USD'});subscribe: khi người dùng đăng ký một dịch vụ hoặc bản tin.gtag('event', 'subscribe', {value: XX, currency: 'USD', coupon: 'XX'});book_appointment: khi người dùng đặt lịch hẹn.gtag('event', 'book_appointment', {value: XX, currency: 'USD', coupon: 'XX'});
Đề xuất bổ sung
Google hỗ trợ nhiều sự kiện và thông số khác, đặc biệt là đối với hoạt động thương mại điện tử. Nói chung, bạn nên ghi lại những thông tin sau:
- Mọi sự kiện thành công được liên kết trực tiếp với giá trị
- Sự kiện thành công đóng góp vào các sự kiện chính cốt lõi (add_to_cart, sign_up, v.v.)
- Lượt tương tác và lượt tương tác của người dùng giúp nhà quảng cáo hiểu được cách họ tương tác với người dùng cuối
Sau đây là các tài nguyên bổ sung giúp giải thích thêm về hoạt động thu thập sự kiện:
- Sự kiện
- Sự kiện đề xuất theo trường hợp sử dụng
- Đo lường hoạt động thương mại điện tử cho tài sản Google Analytics
Chúng tôi muốn thảo luận về các phần mở rộng tiềm năng cho giản đồ này, vì vậy, vui lòng cho chúng tôi biết nếu bạn có đề xuất.
Xác minh chế độ tích hợp mới cập nhật
Trước khi chuyển các thay đổi sang bản phát hành công khai, hãy xác minh khả năng tương thích với những nội dung sau:
- Thẻ Google có đích đến là Google Analytics
- Thẻ Google để tái tiếp thị và đo lường lượt chuyển đổi
Ngoài ra, hãy xác minh rằng thẻ kích hoạt đúng cách trên tất cả các trang (bao gồm cả trang sự kiện quan trọng) bằng cách sử dụng một trong các công cụ sau:
- Google Tag Assistant: Tag Assistant cho phép bạn xem những thẻ Google đã được kích hoạt và thứ tự kích hoạt. Chế độ gỡ lỗi của Tag Assistant cho biết dữ liệu nào đang được truyền vào lớp dữ liệu và những sự kiện nào đã kích hoạt các lượt trao đổi dữ liệu đó.
- Công cụ dành cho nhà phát triển Chrome: Sử dụng thẻ Mạng để lọc các yêu cầu có chứa "google" nhằm xác minh cách dữ liệu được gửi.
- (Phía máy chủ) Báo cáo theo thời gian thực của Google Analytics: Tạo một tài khoản Google Analytics miễn phí và sử dụng báo cáo Theo thời gian thực để xem liệu các lượt truy cập của thẻ có được máy chủ của Google nhận được hay không.
Để báo cáo lỗi hoặc gửi ý kiến phản hồi về thông tin bị thiếu, hãy điền vào biểu mẫu Hỗ trợ hệ thống quản lý nội dung.
Nếu có thể, vui lòng chia sẻ quyền truy cập vào kiểm thử với Google để xác minh liên tục.
Cập nhật hướng dẫn triển khai cho người dùng
Cập nhật tài liệu để cung cấp hướng dẫn rõ ràng về cách triển khai các sản phẩm đo lường của Google bằng cách sử dụng chế độ triển khai của bạn. Chia sẻ bản nháp của các hướng dẫn này bằng cách điền vào biểu mẫu Đánh giá tài liệu thiết lập tích hợp CMS để chúng tôi có thể đưa ra ý kiến phản hồi.