Trang này được dịch bởi Cloud Translation API.

Nhật ký thay đổi

Để biết thông báo chính thức về API Google Analytics, vui lòng đăng ký Nhóm thông báo API Google Analytics.

15/12/2023 Báo cáo về quyền truy cập dữ liệu hiện được cung cấp cho tất cả tài sản Google Analytics.

Một số trường của tính năng Báo cáo truy cập dữ liệu hiện có sẵn cho tất cả các tài sản Google Analytics, cả khách hàng tiêu chuẩn và khách hàng Google Analytics 360.

Xem tài liệu về giản đồ để biết thêm thông tin.

15/12/2023 Phương diện `accessDateHour` được thêm vào giản đồ báo cáo Quyền truy cập dữ liệu.

Phương diện accessDateHour đã được thêm vào giản đồ báo cáo quyền truy cập vào dữ liệu. Trường này chứa ngày giờ của người dùng GA đã truy cập vào dữ liệu báo cáo GA.

05/10/2023 Những tài sản có mô hình phân bổ theo lượt nhấp đầu tiên, mô hình phân bổ tuyến tính, mô hình phân bổ mức giảm dựa trên thời gian và mô hình phân bổ dựa trên vị trí sẽ được mặc định sử dụng mô hình DDA trên nhiều kênh.

Kể từ giữa tháng 10 năm 2023, mô hình phân bổ lượt nhấp đầu tiên, tuyến tính, giảm dựa trên thời gian và dựa trên vị trí sẽ không dùng được với phương thức UpdateAttributionSettings cho mọi tài sản nữa.

Nếu tài sản của bạn hiện được định cấu hình để sử dụng một trong các mô hình này, thì tài sản đó sẽ đổi thành phân bổ dựa trên dữ liệu trên nhiều kênh. Thay vào đó, bạn vẫn sẽ có các lựa chọn sử dụng Mô hình phân bổ theo lượt nhấp cuối cùng trên nhiều kênh hoặc Mô hình ưu tiên lượt nhấp gần đây nhất từ Google Ads.

01/09/2023 Thêm phương thức cấu hình giản đồ giá trị lượt chuyển đổi SKAdNetwork.

Đã thêm các phương thức GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas vào API Quản trị phiên bản 1alpha.

Chức năng này cho phép quản lý cấu hình giản đồ giá trị lượt chuyển đổi SKAdNetwork cho luồng iOS.

01/09/2023 Thêm phương thức `UpdateConversionEvent`.

Đã thêm phương thức UpdateConversionEvent vào API Quản trị phiên bản 1beta.

01/09/2023 Đổi tên trường `BigQueryLink.enterprise_export_enabled` thành `fresh_daily_export_enabled`.

Trường enterprise_export_enabled của tài nguyên BigQueryLink đã được đổi tên thành fresh_daily_export_enabled.

14/07/2023 Thay đổi có thể gây lỗi đối với phương thức `properties.updateAttributionSettings`, `properties.getAttributionSettings`.

Kể từ ngày 24 tháng 7 năm 2023, những thay đổi có thể gây lỗi sẽ được thực hiện đối với API Quản trị phiên bản 1 alpha. Điều này sẽ ảnh hưởng đến chức năng của các phương thức properties.getAttributionSettings, properties.updateAttributionSettings.

Các thành phần của enum ReportingAttributionModel sẽ được đổi tên như sau:

Tên cũ	Tên mới
`CROSS_CHANNEL_DATA_DRIVEN`	`PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN`
`CROSS_CHANNEL_LAST_CLICK`	`PAID_AND_ORGANIC_CHANNELS_LAST_CLICK`
`CROSS_CHANNEL_FIRST_CLICK`	`PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK`
`CROSS_CHANNEL_LINEAR`	`PAID_AND_ORGANIC_CHANNELS_LINEAR`
`CROSS_CHANNEL_POSITION_BASED`	`PAID_AND_ORGANIC_CHANNELS_POSITION_BASED`
`CROSS_CHANNEL_TIME_DECAY`	`PAID_AND_ORGANIC_CHANNELS_TIME_DECAY`
`ADS_PREFERRED_LAST_CLICK`	`GOOGLE_PAID_CHANNELS_LAST_CLICK`

Các thành phần của enum AdsWebConversionDataExportScope sẽ được đổi tên như sau:

Tên cũ	Tên mới
`CROSS_CHANNEL`	`PAID_AND_ORGANIC_CHANNELS`
`ADS_PREFERRED`	`GOOGLE_PAID_CHANNELS`

10-07-2023 Thêm trường `ads_web_conversion_data_export_scope` vào loại `AttributionSettings`

Thêm trường ads_web_conversion_data_export_scope vào loại AttributionSettings. Bạn có thể sửa đổi trường này bằng phương thức UpdateAttributionSettings.

05/06/2023 Ngừng sử dụng mô hình phân bổ theo lượt nhấp đầu tiên, mô hình phân bổ tuyến tính, mô hình phân bổ mức giảm dựa trên thời gian và mô hình phân bổ dựa trên vị trí.

Kể từ tháng 6 năm 2023, bạn không thể sử dụng phương thức UpdateAttributionSettings để định cấu hình tài sản GA4 bằng mô hình phân bổ lượt nhấp đầu tiên, tuyến tính, giảm dựa trên thời gian và mô hình phân bổ dựa trên vị trí. Kể từ tháng 9 năm 2023, các mô hình này sẽ không được cung cấp cho tất cả tài sản.

Hãy tham khảo thông báo về sản phẩm Google Analytics để biết thêm thông tin.

31/05/2023 Thêm các phương pháp quản lý mối liên kết AdSense.

Đã thêm các phương thức GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks vào API Quản trị phiên bản 1alpha.

Chức năng này cho phép quản lý các mối liên kết AdSense với Analytics cho tài sản GA4.

31/05/2023 Thêm một phương thức để tra cứu một tài sản GA4 đã kết nối.

Phương thức FetchConnectedGa4Property được thêm vào API Quản trị phiên bản 1alpha

Chức năng này cho phép lấy thông tin về tài sản GA4 được liên kết với tài sản Universal Analytics trong quá trình di chuyển sang GA4.

31/05/2023 Thêm phương thức để quản lý các quy tắc tạo sự kiện.

Các phương thức CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule đã được thêm vào API Quản trị phiên bản 1alpha.

Chức năng này cho phép quản lý các quy tắc tạo sự kiện. Các quy tắc này có thể kích hoạt việc tạo một sự kiện hoàn toàn mới dựa trên các tiêu chí khớp của sự kiện nguồn.

31/05/2023 Thêm các phương thức để quản lý nhóm kênh tuỳ chỉnh.

Thêm các phương thức GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup vào API Quản trị phiên bản 1alpha.

Chức năng này cho phép quản lý các nhóm kênh tuỳ chỉnh cho các nguồn lưu lượng truy cập của trang web.

Sau khi tạo, bạn có thể truy vấn các nhóm kênh tuỳ chỉnh bằng cách sử dụng Google Analytics Data API phiên bản 1.

31/03/2023 Thêm các phương thức quản lý Chế độ cài đặt đo lường nâng cao.

Thêm phương thức properties.dataStreams.updateEnhancedMeasurementSettings, properties.dataStreams.getEnhancedMeasurementSettings vào API Quản trị phiên bản 1alpha.

Chức năng này cho phép quản lý Chế độ cài đặt đo lường nâng cao cho Luồng dữ liệu web của tài sản GA4.

31/03/2023 Thêm các phương thức quản lý Thẻ trang web đã kết nối.

Thêm phương thức properties.createConnectedSiteTag, properties.deleteConnectedSiteTag, properties.listConnectedSiteTags vào API Quản trị phiên bản 1alpha.

Chức năng này cho phép quản lý Thẻ trang web đã kết nối và rất hữu ích khi chuyển tiếp lưu lượng truy cập từ tài sản Universal Analytics đến tài sản Google Analytics 4.

31/03/2023 Thêm các phương thức `runAccessReport` ở cấp tài khoản và tài sản vào API Quản trị phiên bản 1beta.

Đã thêm các phương thức properties.runAccessReport và accounts.runAccessReport vào phiên bản v1beta của API Quản trị. Các phương thức sẽ trả về một báo cáo về bản ghi truy cập dữ liệu tuỳ chỉnh.

24/2/2023 Thêm các phương thức quản lý Tập dữ liệu mở rộng.

Tài nguyên ExpandedDataSet đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get tương ứng. Bạn có thể dùng chức năng này để quản lý Tập dữ liệu mở rộng trong Google Analytics 360.

24/02/2023 Liên kết truy cập sẽ thay thế Đường liên kết người dùng để quản lý quyền của người dùng.

Tài nguyên AccessBinding đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác sau:

Chức năng này cho phép quản lý quyền của người dùng đối với tài khoản hoặc tài sản GA4 và nên được dùng thay cho Đường liên kết người dùng.

Chức năng Đường liên kết người dùng sẽ bị loại bỏ khỏi API Quản trị phiên bản 1 alpha vào ngày 1/6/2023

24/02/2023 Ngừng sử dụng các phương thức kiểm tra quyền của người dùng.

Các phương thức sau không còn được dùng nữa và sẽ bị xoá khỏi API Quản trị phiên bản 1 alpha kể từ ngày 1/6/2023:

24/2/2023 Thêm các phương thức quản lý Đối tượng.

Tài nguyên Audience đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get tương ứng.

Chức năng này cho phép quản lý đối tượng cho tài sản GA4.

15/02/2023 Thêm các phương thức chọn không sử dụng quy trình thiết lập GA4 tự động.

Các thao tác properties.setAutomatedGa4ConfigurationOptOut, properties.fetchAutomatedGa4ConfigurationOptOut đã được thêm vào phiên bản v1alpha của API.

Chức năng này cho phép quản lý trạng thái chọn không tham gia quy trình thiết lập GA4 tự động cho tài sản UA.

15/02/2023 Thêm các phương thức quản lý đường liên kết BigQuery.

Tài nguyên BigQueryLink đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác properties.bigQueryLinks.get, properties.bigQueryLinks.list tương ứng.

Chức năng này cho phép truy xuất thông tin về mối liên kết giữa tài sản GA4 và dự án BigQuery.

15/2/2023 Thêm các phương thức quản lý mối liên kết của Search Ads 360.

Tài nguyên SearchAds360Link đã được thêm vào phiên bản v1alpha của API, cùng với các thao tác properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get tương ứng.

Chức năng này cho phép quản lý các mối liên kết giữa tài sản GA4 và một thực thể Search Ads 360.

15/2/2023 Thay đổi có thể gây lỗi.

Các giá trị LESS_THAN_OR_EQUAL, GREATER_THAN_OR_EQUAL đã bị xoá khỏi enum NumericFilter.Operation.
Xoá giá trị PARTIAL_REGEXP khỏi enum StringFilter.MatchType.

15/2/2023 Các thay đổi khác.

Đã thêm trường tokensPerProjectPerHour vào loại AccessQuota.
Đã thêm các giá trị EXPANDED_DATA_SET, CHANNEL_GROUP vào enum ChangeHistoryResourceType.
Đã thêm các giá trị searchAds360Link, expandedDataSet, bigqueryLink vào ChangeHistoryResource.

11/08/2022 Thêm phương thức `runAccessReport` vào API Quản trị phiên bản 1alpha.

Phương thức properties.runAccessReport đã được thêm vào phiên bản v1alpha của API Quản trị. Phương thức này sẽ trả về một báo cáo tuỳ chỉnh về các bản ghi quyền truy cập dữ liệu. Báo cáo này cung cấp bản ghi lại mỗi lần người dùng đọc dữ liệu báo cáo của Google Analytics. Báo cáo về quyền truy cập dữ liệu được cung cấp cho Quản trị viên của các tài sản Google Analytics 360.

11/07/2022 Phát hành phiên bản API Quản trị phiên bản 1beta.

Chúng tôi đã phát hành phiên bản v1beta của API Quản trị Google Analytics.

API Quản trị sẽ tiếp tục hỗ trợ cả kênh Alpha và Beta của API này. Kênh Beta chứa một tập hợp con các tính năng có sẵn trong giai đoạn Alpha được coi là ổn định và dự kiến sẽ không trải qua thay đổi đáng kể trong tương lai. Các tính năng mới sẽ được bổ sung vào bản Beta khi chúng hoàn thiện.

12/10/2021 Các phương thức AdvancedMeasurementSettings đã bị xoá khỏi API.

Các phương thức properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings sẽ bị xoá khỏi API, nhưng bạn sẽ sớm có thể sửa đổi các chế độ cài đặt Đo lường nâng cao thông qua API.
Trường directRoles của tài nguyên UserLink không còn hỗ trợ vai trò predefinedRoles/manage-users. Bạn nên sử dụng vai trò predefinedRoles/admin mới, tương đương với sự kết hợp của các vai trò predefinedRoles/edit và predefinedRoles/manage-users cũ. Thay đổi này ảnh hưởng đến hành vi của các phương thức accounts.userLinks, properties.userLinks, đồng thời phù hợp với những thay đổi về Quản lý quyền truy cập và quy định hạn chế về dữ liệu được đưa ra trong Google Analytics.

05/06/2021 Bổ sung các tính năng.

Các tính năng sau sẽ được thêm vào API:

Phương thức accounts.searchChangeHistoryEvents đã được thêm vào API. Phương thức này tìm kiếm thông qua tất cả các thay đổi đối với một tài khoản hoặc tài khoản con của tài khoản đó dựa trên tập hợp bộ lọc đã chỉ định. Các nguyên nhân phổ biến thường là do việc cập nhật trong giao diện người dùng của Google Analytics, những thay đổi từ dịch vụ hỗ trợ khách hàng hoặc các thay đổi tự động của hệ thống Google Analytics.
Đã thêm các phương thức quản lý thông tin bí mật về Measurement Protocol trong properties.webDataStreams.measurementProtocolSecrets:
- create Tạo một mã thông báo bí mật cho Measurement Protocol.
- delete Xoá mã thông báo bí mật của giao thức đo lường mục tiêu.
- get Tìm một mã thông báo bí mật của Measurement Protocol.
- list Trả về mã thông báo bí mật cho giao thức đo lường con trong Thuộc tính mẹ đã chỉ định.
- patch Cập nhật mã thông báo bí mật cho Measurement Protocol.
Các phương thức quản lý sự kiện chuyển đổi đã được thêm trong properties.conversionEvents:
- create Tạo sự kiện chuyển đổi có các thuộc tính đã chỉ định.
- delete Xoá sự kiện chuyển đổi trong tài sản.
- get Truy xuất một sự kiện chuyển đổi.
- list Trả về danh sách sự kiện chuyển đổi trong thuộc tính mẹ được chỉ định.
Các phương thức quản lý phương diện tuỳ chỉnh đã được thêm trong properties.customDimensions:
- archive Lưu trữ phương diện tuỳ chỉnh trên một tài sản.
- create Tạo một phương diện tuỳ chỉnh.
- get Tra cứu một phương diện tuỳ chỉnh.
- list Liệt kê các phương diện tuỳ chỉnh trên một thuộc tính.
- patch Cập nhật một phương diện tuỳ chỉnh trên một tài sản.
Các phương thức quản lý chỉ số tuỳ chỉnh được thêm trong properties.customMetrics:
- archive Lưu trữ chỉ số tuỳ chỉnh trên một tài sản.
- create sử dụng chỉ số tuỳ chỉnh.
- get Tra cứu một chỉ số tuỳ chỉnh.
- list Liệt kê các chỉ số tuỳ chỉnh trên một thuộc tính.
- patch Cập nhật chỉ số tuỳ chỉnh cho một tài sản.
Thêm các phương thức properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings cho phép kiểm soát chế độ cài đặt Tín hiệu của Google cho tài sản Google Analytics 4.
Các trường chỉ đầu ra delete_time, expire_time được thêm vào loại Property.

05/06/2021 Thay đổi có thể gây lỗi.

Chúng tôi ra mắt những thay đổi có thể gây lỗi sau đây:

properties.iosAppDataStreams.create, properties.androidAppDataStreams.create phương thức đã bị xoá khỏi API. Vui lòng sử dụng Firebase để tạo luồng ứng dụng trong tài sản Google Analytics 4.
Phương thức properties.delete hiện trả về dữ liệu thuộc tính đã xoá dưới dạng loại Property thay vì trả về phản hồi trống.
Hiện tại, bạn bắt buộc phải sử dụng trường time_zone thuộc loại Property.
Đã xoá trường deleted khỏi loại Property.
Trường email_address của loại UserLink hiện không thể thay đổi.
Trường name của loại UserLink hiện chỉ có dữ liệu đầu ra.

28/01/2021 Thêm tính năng hỗ trợ phân trang cho thao tác `ListFirebaseLinks`.

28/01/2021 Thay đổi có thể gây lỗi.

Thay đổi có thể gây lỗi: – Trường update_mask là trường bắt buộc cho tất cả các thao tác Cập nhật.

Trường country_code đã được đổi tên thành region_code trong Account.
Trường url_query_parameter đã được đổi tên thành uri_query_parameter trong EnhancedMeasurementSettings.
Đã xoá trường parent khỏi GoogleAdsLink.

20/10/2020 Thêm tính năng hỗ trợ cho tính năng tóm tắt tài khoản.

Đã thêm tính năng hỗ trợ cho phương thức tóm tắt tài khoản.

13/10/2020 Đổi tên Tài sản web và ứng dụng thành Google Analytics 4 (GA4).

15/08/2020 Đổi tên API Web và ứng dụng quản lý thành API Quản trị.

API Web và ứng dụng quản lý Google Analytics đã được đổi tên thành API Quản trị của Google Analytics. Do đó, điểm cuối API đã thay đổi thành analyticsadmin.googleapis.com. Mã hiện có được viết dựa trên phiên bản trước của URL điểm cuối API và thư viện ứng dụng cần được cập nhật cho phù hợp.