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 của riêng bạn thông số tuỳ chỉnh.

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 cầu

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

Bạn có thể đặ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ầu

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 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 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 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ầu

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 cầu

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 sản phẩm cụ thể quảng cáo hoặc chiến dịch mang tính chiến lược.

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ầu

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 tên khác nguồn.

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ầu

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ể đặt.

Đối tượng campaign được cung cấp để hỗ trợ các hoạt động triển khai cũ, và không nên dùng trong hầu hết 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 của 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 truy vấn utm_ tham số.

Đặ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 khi hết 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ầu

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 cầu

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). Chẳng hạn như nếu cookie_domain được đặt thành 'auto' https://example.com sẽ sử dụng example.com cho miền này và https://subdomain.example.com cũng sẽ sử dụng example.com cho miền này.

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

Ví dụ:

Đặt trên toàn cầu

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 cookie sẽ là đã 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à 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 của cookie_expires thành 0 (0) giây, cookie 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ố 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ầu

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ầu

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 cầu

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 cầu

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 trang tải. Thao tác này sẽ cập nhật thời hạn sử dụng cookie thành được đặt tương ứng với lượt truy cập gần đây vào trang web. Ví dụ: nếu thời hạn cookie được đặt thành một tuần, và người dùng truy cập bằng cùng một trình duyệt mỗi 5 ngày thì cookie sẽ hết hạn sẽ được cập nhật vào mỗi lượt truy cập và sẽ không bao giờ hết hạn.

Khi bạn đặt thành false, cookie sẽ không được cập nhật trong mỗi lần tải trang. Điều này có ảnh hưởng của thời hạn cookie có liên quan đến lần đầu tiên người dùng truy cập của bạn.

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

Ví dụ:

Đặt trên toàn cầu

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 không nên hiển thị đường liên kết giới thiệu làm nguồn lưu lượng truy cập. Tìm hiểu trường hợp nên 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ầu

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. Mặc định là của người dùng Giá trị navigator.language.

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ầu

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. Mặc định là của người dùng Giá trị document.location.

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ầu

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 cầu

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à document.title của người dùng giá trị.

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ầu

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ầu

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ừ ngày window.screen

Ví dụ:

Đặt trên toàn cầu

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 một giá trị nhận dạng đã biết cho người dùng do chủ sở hữu/thư viện trang web cung cấp người dùng. Giá trị nhận dạng này không được là PII (thông tin nhận dạng cá nhân). Chiến lược phát hành đĩa đơn giá trị này không được duy trì trong cookie Google Analytics hoặc các Analytics khác bộ nhớ đã 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ầu

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ể dùng để mô tả các phân đoạn trong người dùng cơ sở người dùng, chẳng hạn như ngôn ngữ ưu tiên hoặc vị trí địa lý. Tối đa 25 có thể đặt thuộc tính người dùng bổ sung 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 cầu

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'
  }
});