Tính năng quảng cáo

Hướng dẫn này mô tả cách sử dụng trình bổ trợ tính năng quảng cáo cho analytics.js.

Tổng quan

Bạn có thể bật Các tính năng quảng cáo của Google Analytics (bao gồm Danh sách tiếp thị lại dành cho quảng cáo đi kèm kết quả tìm kiếm) trong Google Analytics từ phần Cài đặt tài sản > Thu thập dữ liệu. Bạn có thể sử dụng trình bổ trợ tính năng quảng cáo cho analytics.js để bật các tính năng quảng cáo theo cách có lập trình, cũng như để ghi đè và tắt tất cả các tính năng báo cáo quảng cáo và tiếp thị lại được thiết lập trong giao diện người dùng Google Analytics.

Triển khai

Bạn nên bật các tính năng báo cáo quảng cáo trong phần cài đặt tài sản của Google Analytics.

Để bật trình bổ trợ tính năng quảng cáo, hãy thêm lệnh gọi require và chỉ định trình bổ trợ displayfeatures.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'displayfeatures');
ga('send', 'pageview');

Trình bổ trợ này gửi một yêu cầu đến stats.g.doubleclick.net để bật các tính năng quảng cáo. Trình bổ trợ này tạo một cookie mới có tên là _gat có thời gian chờ là một phút. Cookie này không lưu trữ bất kỳ thông tin người dùng nào; cookie này chỉ được dùng để giới hạn số lượng yêu cầu phải được gửi đến doubleclick.net.

Tên cookie mặc định là _gat. Bạn có thể thay đổi chế độ cài đặt này bằng cách đặt tuỳ chọn cookieName khi cần có trình bổ trợ:

ga('require', 'displayfeatures', {cookieName: 'display_features_cookie'});

Lưu ý rằng đối số thứ ba thường được dùng để chỉ định vị trí tập lệnh. Vì trình bổ trợ này có trong analytics.js, nên bạn chỉ cần chuyển undefined.

Sử dụng nhiều thiết bị theo dõi

Để sử dụng trình bổ trợ tính năng quảng cáo có nhiều trình theo dõi, hãy thêm tên trình theo dõi vào trước lệnh gọi require:

// create a tracker named 'foo' for property UA-XXXXX-Y
ga('create', 'UA-XXXXX-Y', {name: 'foo'});
ga('foo.require', 'displayfeatures');
ga('foo.send', 'pageview');

// create a second tracker named 'bar' for a different property UA-XXXX-Z
ga('create', 'UA-XXXXX-Z', {name: 'bar'});
ga('bar.require', 'displayfeatures');
ga('bar.send', 'pageview');

Khi trình bổ trợ tính năng quảng cáo cho một trình theo dõi được đặt tên được tải, tên trình theo dõi sẽ được thêm vào tên cookie. Ví dụ ở trên sẽ tạo các cookie _gat_foo_gat_bar.

Tắt các tính năng quảng cáo

Bạn có thể bật các tính năng quảng cáo thông qua phần cài đặt quản trị viên Google Analytics, nên có thể bạn cần tắt các tính năng này theo phương thức lập trình.

Để tắt tất cả các tính năng quảng cáo bằng analytics.js, hãy đặt allowAdFeatures thành false sau lệnh createtrước lệnh send.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdFeatures', false);
ga('send', 'pageview');

Khi bạn đặt thành true (giá trị mặc định), allowAdFeatures sẽ cho phép trình bổ trợ displayfeatures và các chế độ cài đặt tính năng quảng cáo trong Google Analytics hoạt động. Trường này không tự bật các tính năng này.

Đặt allowAdFeatures thành false để tắt beacon cho các tính năng quảng cáo của Google Analytics, cho dù chúng được bật thông qua trình bổ trợ displayfeatures hay từ bên trong Google Analytics.

Để chỉ tắt các tính năng cá nhân hoá quảng cáo, hãy đặt allowAdPersonalizationSignals thành false sau lệnh createtrước lệnh send.

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdPersonalizationSignals', false);
ga('send', 'pageview');