Cấu hình

Tài liệu này liệt kê tất cả các trường cấu hình cho GA4.

Lưu ý: Đừng sử dụng bất kỳ trường nào được liệt kê trên trang này làm tên cho tham số tuỳ chỉnh của riêng bạn.

allow_google_signals

Để tắt tất cả các tính năng quảng cáo, hãy đặt allow_google_signals thành false.

Tên trường	Loại	Giá trị mặc định
allow_google_signals	boolean	đúng

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'allow_google_signals', true);

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

Đặt thành false để tắt các tính năng cá nhân hoá quảng cáo.

Tên trường	Loại	Giá trị mặc định
allow_ad_personalization_signals	boolean	đúng

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'allow_ad_personalization_signals', true);

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

campaign_content

Được sử dụng cho thử nghiệm A/B và quảng cáo nhắm mục tiêu theo nội dung. Sử dụng campaign_content để phân biệt các quảng cáo hoặc đường liên kết trỏ đến cùng một URL.

Tên trường	Loại	Giá trị mặc định
campaign_content	string	undefined

Ví dụ:

Lưu ý: Việc đặt giá trị này sẽ ghi đè tham số truy vấn utm_content.

Đặt trên toàn hệ thống

gtag('set', 'campaign_content', 'logolink');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

Được dùng để xác định chiến dịch mà đường liên kết giới thiệu này tham chiếu đến. Sử dụng campaign_id để xác định chiến dịch cụ thể.

Tên trường	Loại	Giá trị mặc định
campaign_id	string	undefined

Ví dụ:

Lưu ý: Việc đặt giá trị này sẽ ghi đè tham số truy vấn utm_id.

Đặt trên toàn hệ thống

gtag('set', 'campaign_id', 'abc.123');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

Sử dụng campaign_medium để xác định phương tiện, chẳng hạn như email hoặc chi phí mỗi lượt nhấp.

Tên trường	Loại	Giá trị mặc định
campaign_medium	string	undefined

Ví dụ:

Lưu ý: Việc đặt giá trị này sẽ ghi đè tham số truy vấn utm_medium.

Đặt trên toàn hệ thống

gtag('set', 'campaign_medium', 'cpc');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

Được dùng để phân tích từ khoá. Sử dụng campaign_name để xác định một quảng cáo sản phẩm cụ thể hoặc chiến dịch mang tính chiến lược cụ thể.

Tên trường	Loại	Giá trị mặc định
campaign_name	string	undefined

Ví dụ:

Lưu ý: Việc đặt giá trị này sẽ ghi đè tham số truy vấn utm_name.

Đặt trên toàn hệ thống

gtag('set', 'campaign_name', 'spring_sale');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

Sử dụng campaign_source để xác định công cụ tìm kiếm, tên bản tin hoặc nguồn khác.

Tên trường	Loại	Giá trị mặc định
campaign_source	string	undefined

Ví dụ:

Lưu ý: Việc đặt giá trị này sẽ ghi đè tham số truy vấn utm_source.

Đặt trên toàn hệ thống

gtag('set', 'campaign_source', 'google');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

Được dùng cho kết quả tìm kiếm có trả phí Sử dụng campaign_term để ghi chú các từ khoá cho quảng cáo này.

Tên trường	Loại	Giá trị mặc định
campaign_term	string	undefined

Ví dụ:

Lưu ý: Việc đặt giá trị này sẽ ghi đè tham số truy vấn utm_term.

Đặt trên toàn hệ thống

gtag('set', 'campaign_term', 'running+shoes');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

chiến dịch

Một đối tượng chứa tất cả các giá trị chiến dịch có thể đặt.

Đối tượng campaign được cung cấp để hỗ trợ các phương thức triển khai cũ và không nên dùng cho hầu hết các trường hợp. Thay vào đó, bạn nên sử dụng phiên bản có tiền tố campaign của mỗi trường:

• campaign_id
• campaign_source
• campaign_medium
• campaign_name
• campaign_term
• campaign_content

Lưu ý quan trọng: Hãy sử dụng phiên bản có tiền tố campaign_ của mỗi giá trị chiến dịch thay vì trường này.

Tên trường	Loại	Giá trị mặc định
campaign	object	undefined

Ví dụ:

Lưu ý: Mọi thông tin chi tiết về chiến dịch mà bạn cung cấp sẽ ghi đè mọi tham số truy vấn utm_.

Đặt trên toàn hệ thống

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

client_id

Xác định phiên bản trình duyệt theo cách gán biệt danh. Theo mặc định, giá trị này được lưu trữ dưới dạng một phần của cookie Analytics của bên thứ nhất với thời hạn là hai năm.

Tên trường	Loại	Giá trị mặc định
client_id	string	Giá trị được tạo ngẫu nhiên cho từng người dùng.

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'client_id', 'aaa.bbb');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

Tên trường	Loại	Giá trị mặc định
content_group	string

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'content_group', '/news/sports');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

cookie_domain

Chỉ định miền được dùng để lưu trữ cookie Analytics.

Đặt thành 'none' để đặt cookie mà không cần chỉ định miền.

Đặt thành 'auto' (giá trị mặc định) để đặt cookie thành miền cấp cao nhất cùng với một miền con (eTLD +1). Ví dụ: nếu bạn đặt cookie_domain thành 'auto', https://example.com sẽ sử dụng example.com cho miền, và https://subdomain.example.com cũng sẽ sử dụng example.com cho miền.

Tên trường	Loại	Giá trị mặc định
cookie_domain	string	'auto'

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'cookie_domain', 'example.com');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'cookie_domain': 'example.com'
});

cookie_expires

Mỗi khi một lượt truy cập được gửi đến Google Analytics, thời gian hết hạn của cookie sẽ được cập nhật thành thời gian hiện tại cộng với giá trị của trường cookie_expires. Điều này có nghĩa là nếu bạn sử dụng thời gian có giá trị mặc định là 2 năm (63072000 giây) và một người dùng truy cập vào trang web của bạn mỗi tháng, thì cookie của họ sẽ không bao giờ hết hạn.

Nếu bạn đặt thời gian cookie_expires thành 0 (không) giây, thì cookie này sẽ chuyển thành cookie dựa trên phiên và sẽ hết hạn khi phiên trình duyệt hiện tại kết thúc.

Thận trọng: Nếu đặt cookie hết hạn quá nhanh, bạn sẽ làm tăng số lượng người dùng và giảm chất lượng đo lường.

Tên trường	Loại	Giá trị mặc định
cookie_expires	number	63072000

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});

cookie_flags

Thêm các cờ bổ sung vào cookie khi đặt cookie. Cờ phải được phân tách bằng dấu chấm phẩy. Xem bài viết viết cookie mới để tham khảo một số ví dụ về cờ cần đặt.

Tên trường	Loại	Giá trị mặc định
cookie_flags	string

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'cookie_flags', 'SameSite=None;Secure');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'cookie_flags': 'SameSite=None;Secure'
});

cookie_path

Chỉ định đường dẫn con dùng để lưu trữ cookie của Analytics.

Tên trường	Loại	Giá trị mặc định
cookie_path	string	'/'

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'cookie_path', '/example_path');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

cookie_prefix

Chỉ định một tiền tố để thêm vào trước tên cookie của Analytics.

Tên trường	Loại	Giá trị mặc định
cookie_prefix	string

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'cookie_prefix', 'prefix');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

cookie_update

Khi bạn đặt cookie_update thành true, gtag.js sẽ cập nhật cookie trên mỗi lần tải trang. Thao tác này sẽ cập nhật thời hạn sử dụng cookie tương ứng với lượt truy cập gần đây nhất vào trang web. Ví dụ: nếu thời hạn sử dụng cookie được đặt thành 1 tuần và người dùng truy cập bằng cùng một trình duyệt 5 ngày một lần, thì thời hạn sử dụng cookie sẽ được cập nhật ở mỗi lượt truy cập và sẽ không bao giờ hết hạn.

Khi bạn đặt chính sách này thành false, cookie sẽ không được cập nhật trong mỗi lần tải trang. Điều này khiến cho thời hạn cookie được đặt dựa trên lần đầu tiên người dùng truy cập vào trang web.

Tên trường	Loại	Giá trị mặc định
cookie_update	boolean	true

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'cookie_update', true);

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

ignore_referrer

Đặt thành true để cho Analytics biết rằng đường liên kết giới thiệu không nên xuất hiện dưới dạng nguồn lưu lượng truy cập. Tìm hiểu trường hợp sử dụng trường này

Tên trường	Loại	Giá trị mặc định
ignore_referrer	boolean	false

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'ignore_referrer', true);

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'ignore_referrer': true
});

language

Chỉ định ngôn ngữ ưu tiên của người dùng. Giá trị mặc định là giá trị navigator.language của người dùng.

Tên trường	Loại	Giá trị mặc định
language	string	Giá trị mặc định sẽ là navigator.language

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'language', 'en-us');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

Chỉ định URL đầy đủ của trang. Giá trị mặc định là giá trị document.location của người dùng.

Tên trường	Loại	Giá trị mặc định	Character Limit
page_location	string	Giá trị mặc định là document.location	1000

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'page_location', 'https://example.com/page1');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

Chỉ định nguồn giới thiệu đã mang lại lưu lượng truy cập cho một trang. Giá trị này cũng được dùng để tính toán nguồn lưu lượng truy cập. Định dạng của giá trị này là một URL. Giá trị mặc định là giá trị document.referrer của người dùng.

Tên trường	Loại	Giá trị mặc định	Character Limit
page_referrer	string	Giá trị mặc định sẽ là document.referrer	420

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'page_referrer', 'https://example.com');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

Tiêu đề của trang hoặc tài liệu. Giá trị mặc định là giá trị document.title của người dùng.

Tên trường	Loại	Giá trị mặc định	Character Limit
page_title	string	Giá trị mặc định sẽ là document.title	300

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'page_title', 'Settings');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

Đặt thành false để ngăn đoạn mã mặc định gửi page_view.

Tên trường	Loại	Giá trị mặc định
send_page_view	boolean	đúng

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'send_page_view', false);

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

Chỉ định độ phân giải của màn hình. Phải là hai số nguyên dương được phân tách bằng x. Ví dụ: đối với màn hình 800px x 600px, giá trị sẽ là 800x600. Được tính từ giá trị window.screen của người dùng.

Tên trường	Loại	Giá trị mặc định
screen_resolution	string	Giá trị mặc định sẽ được tính từ window.screen

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'screen_resolution', '800x600');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

Chỉ định giá trị nhận dạng đã biết cho người dùng do chủ sở hữu trang web/người dùng thư viện cung cấp. Giá trị nhận dạng này không được là PII (thông tin nhận dạng cá nhân). Giá trị này không được tồn tại trong cookie Google Analytics hoặc bộ nhớ khác mà Analytics cung cấp.

Tên trường	Loại	Giá trị mặc định	Character Limit
user_id	string		256

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'user_id', 'id');

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

Thuộc tính người dùng là các thuộc tính có thể dùng để mô tả các phân khúc trong cơ sở người dùng, chẳng hạn như lựa chọn ưu tiên về ngôn ngữ hoặc vị trí địa lý. Bạn có thể đặt thêm tối đa 25 thuộc tính người dùng cho mỗi dự án.

Tên trường	Loại	Giá trị mặc định	Character Limit
user_properties	object		tên thuộc tính=24 giá trị thuộc tính=36

Ví dụ:

Đặt trên toàn hệ thống

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

Đặt cho một sự kiện phát trực tiếp

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});