Tài liệu này liệt kê tất cả các trường cấu hình cho GA4.
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ụ:
Đặ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ụ:
Đặ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ụ:
Đặ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ụ:
Đặ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ụ:
Đặ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ụ:
Đặ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:
Tên trường | Loại | Giá trị mặc định |
---|---|---|
campaign |
object |
undefined |
Ví dụ:
Đặ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.
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'
}
});