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.

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

Đặ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ụ:

Đặ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ụ:

Đặ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ụ:

Đặ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ụ:

Đặ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ụ:

Đặ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:

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

Ví dụ:

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

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'

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

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.

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

Đặ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 */
});

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

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

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 '/'

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

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

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

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

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