Để 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:
accounts.accessBindings.create
accounts.accessBindings.delete
accounts.accessBindings.patch
accounts.accessBindings.list
accounts.accessBindings.get
accounts.accessBindings.batchCreate
accounts.accessBindings.batchDelete
accounts.accessBindings.batchUpdate
accounts.accessBindings.batchGet
properties.accessBindings.create
properties.accessBindings.delete
properties.accessBindings.patch
properties.accessBindings.list
properties.accessBindings.get
properties.accessBindings.batchCreate
properties.accessBindings.batchDelete
properties.accessBindings.batchUpdate
properties.accessBindings.batchGet
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 enumNumericFilter.Operation
.Xoá giá trị
PARTIAL_REGEXP
khỏi enumStringFilter.MatchType
.
15/2/2023 Các thay đổi khác.
- Đã thêm trường
tokensPerProjectPerHour
vào loạiAccessQuota
. - Đã thêm các giá trị
EXPANDED_DATA_SET
,CHANNEL_GROUP
vào enumChangeHistoryResourceType
. - Đã thêm các giá trị
searchAds360Link
,expandedDataSet
,bigqueryLink
vàoChangeHistoryResource
.
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ênUserLink
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ứcaccounts.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
: - Các phương thức quản lý phương diện tuỳ chỉnh đã được thêm trong
properties.customDimensions
: - Các phương thức quản lý chỉ số tuỳ chỉnh được thêm trong
properties.customMetrics
: - 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ạiProperty
.
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ạiProperty
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ạiProperty
. - Đã xoá trường
deleted
khỏi loạiProperty
. - Trường
email_address
của loạiUserLink
hiện không thể thay đổi. - Trường
name
của loạiUserLink
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ànhregion_code
trongAccount
.Trường
url_query_parameter
đã được đổi tên thànhuri_query_parameter
trongEnhancedMeasurementSettings
.Đã xoá trường
parent
khỏiGoogleAdsLink
.
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.