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 Google Analytics.

Lưu ý: Khô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 các tính năng quảng cáo dựa trên giá trị nhận dạng cho quảng cáo của bên thứ ba, 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 cục

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

Đặt cho một luồng

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 cục

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

Đặt cho một luồng

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 những 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 cầu

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

Đặt cho một luồng

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 một 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 cục

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

Đặt cho một luồng

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

campaign_medium

Sử dụng campaign_medium để xác định một 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 cục

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 sử dụng để phân tích từ khóa. Sử dụng campaign_name để xác định một quảng cáo sản phẩm hoặc một 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 cục

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

Đặt cho một luồng

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 cục

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 sử dụng cho tìm kiếm phải trả tiền. 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 cầu

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ể được đặ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 trong 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 từng 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 từng 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 cầu

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ữ như 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 cục

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

Đặt cho một luồng

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 cục

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

Đặt cho một luồng

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 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 cookie_domain được đặt thành 'auto', thì 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 cục

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

Đặt cho một luồng

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à hai 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 sẽ chuyển thành cookie dựa trên phiên và sẽ hết hạn khi phiên hiện tại trên trình duyệt 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 cục

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 cục

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

Đặt cho một luồng

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

cookie_path

Chỉ định đường dẫn con được dùng để lưu trữ cookie phân tích.

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

Ví dụ:

Đặt trên toàn cục

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

Đặt cho một luồng

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

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

Ví dụ:

Đặt trên toàn cục

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

Đặt cho một luồng

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 trong 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 được đặt tương ứng với lượt truy cập vào trang web gần đây nhất. 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 giá trị tham số 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 cục

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

Đặt cho một luồng

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

ignore_referrer

Đặt thành true để cho Analytics biết rằng bạn không muốn hiển thị đường liên kết giới thiệu 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 cục

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

Đặt cho một luồng

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 cục

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

Đặt cho một luồng

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 cục

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

Đặt cho một luồng

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à 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 cục

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

Đặt cho một luồng

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 cục

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 cục

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

Đặt cho một luồng

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 có kích thước 800 x 600 pixel, giá trị tham số 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ừ ngày window.screen

Ví dụ:

Đặt trên toàn cục

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

Đặt cho một luồng

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). Bạn không được giữ lại giá trị này trong cookie của Google Analytics hoặc bộ nhớ khác do 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 cục

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à những thuộc tính có thể được 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		property name=24 property value=36

Ví dụ:

Đặt trên toàn cục

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

Đặt cho một luồng

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