Nhật ký thay đổi

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

Ngày 20 tháng 10 năm 2024 Đã thêm loại bộ lọc phương diện EmptyFilter

Khi sử dụng bộ lọc phương diện EmptyFilter, bạn có thể tạo các điều kiện lọc để so sánh với một giá trị trống.

15/10/2024 Thêm tính năng Cấp lấy mẫu vào phương thức reportTasks

Bằng cách sử dụng trường samplingLevel của phương thức properties.runReportTask, bạn có thể kiểm soát mức lấy mẫu của báo cáo.

Tính năng này cho phép tài sản Google Analytics 360 sử dụng giới hạn lấy mẫu cao hơn là 1 tỷ sự kiện. Ngoài ra, bạn có thể đặt giới hạn lấy mẫu thành UNSAMPLED đối với kết quả không được lấy mẫu có số lượng sự kiện lớn.

Ngày 18/9/2024 Thêm tính năng Ảnh chụp nhanh hạn mức tài sản

Bằng cách sử dụng phương thức properties.getPropertyQuotasSnapshot, bạn có thể nhận được ảnh chụp nhanh hiện tại của tất cả hạn mức tài sản được sắp xếp theo danh mục hạn mức cho một tài sản nhất định.

28/06/2024 Thêm hạn mức "lỗi máy khách trên mỗi dự án trên mỗi tài sản"

Giờ đây, mỗi dự án và mỗi tài sản chỉ được phép có tối đa 10.000 lỗi máy chủ API trong khoảng thời gian 15 phút. Điều này bao gồm tất cả các yêu cầu dẫn đến một phản hồi có mã bất kỳ khác với 500 hoặc 200. Ví dụ về các lỗi thuộc hạn mức này: sử dụng các tổ hợp phương diện và chỉ số không tương thích, tất cả các lỗi xác thực.

Nếu vượt quá giới hạn này, các lệnh gọi API tiếp theo đến tài sản đó sẽ tạm thời bị chặn đối với dự án trên Google Cloud được liên kết cho đến khi khoảng thời gian 15 phút kết thúc.

Ngày 14 tháng 5 năm 2024 Thêm tính năng So sánh

Khi sử dụng Thông tin so sánh, bạn có thể đánh giá song song các nhóm nhỏ dữ liệu.

Các phương thức báo cáo cốt lõi của Data API phiên bản 1 beta được cập nhật để hỗ trợ trường comparisons. Khi được đưa vào, trường này sẽ chỉ định cấu hình của các so sánh được yêu cầu.

Trong một yêu cầu, bạn có thể chỉ định một phép so sánh cơ bản bằng cách cung cấp biểu thức dimensionFilter với một yêu cầu hoặc sử dụng một phép so sánh đã lưu bằng cách cung cấp tên tài nguyên của phép so sánh trong trường comparison.

Phương thức getMetadata được cập nhật để liệt kê tất cả thông tin so sánh đã lưu có sẵn cho một tài sản trong trường phản hồi comparisons.

Khi bạn chỉ định ít nhất một giá trị so sánh trong một yêu cầu, phản hồi sẽ chứa cột comparison xác định từng giá trị so sánh.

Hiện tại, bạn chỉ có thể tạo thông tin so sánh đã lưu bằng giao diện người dùng Google Analytics.

Ngày 8 tháng 5 năm 2024 Đã thêm các tác vụ báo cáo (một tính năng báo cáo không đồng bộ) vào Data API phiên bản 1 alpha.

Khi sử dụng các tác vụ báo cáo, bạn có thể bắt đầu một yêu cầu không đồng bộ chạy trong thời gian dài để tạo một báo cáo tuỳ chỉnh về dữ liệu sự kiện Google Analytics.

Các phương thức thao tác sau đây đối với tác vụ báo cáo đã được thêm vào Data API phiên bản 1 alpha:

06/05/2024 Phương diện mới cho sự kiện chính

Hiện đã có các phương diện và chỉ số cho sự kiện chính.

Sửa đổi các yêu cầu báo cáo sử dụng phương diện isConversionEvent để thay vào đó sử dụng phương diện isKeyEvent.

Sửa đổi mọi yêu cầu báo cáo sử dụng Chỉ số không dùng nữa trong bảng sau để sử dụng Chỉ số sự kiện chính.

Chỉ số không dùng nữa Chỉ số sự kiện chính
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

Thực hiện các sửa đổi tương tự đối với mọi cách sử dụng chỉ số sự kiện chính cho một sự kiện chính trong yêu cầu báo cáo của bạn.

Phản hồi cho phương thức properties/getMetadata phản ánh việc giới thiệu các phương diện và chỉ số sự kiện chính trong các đối tượng DimensionMetadata và MetricMetadata như sau:

  • apiName, uiName và description chứa tên API sự kiện chính, tên giao diện người dùng và nội dung mô tả.
  • Trường lặp lại deprecatedApiNames có một mục nhập có tên API chuyển đổi không dùng nữa.

25/3/2024 Đã thêm nhóm kênh chính, nguồn lưu lượng truy cập được đặt thủ công và các phương diện cụ thể về việc tích hợp.

Nhóm kênh chính, nguồn lưu lượng truy cập thủ công và các phương diện dành riêng cho việc tích hợp CM360, DV360, SA360 được thêm vào sơ đồ Data API.

Phương diện đối tượng:

  • audienceId Mã đối tượng. Giá trị nhận dạng dạng số của Đối tượng.

Phương diện Nhóm kênh chính:

  • firstUserPrimaryChannelGroup Nhóm kênh chính có người dùng lần đầu

  • primaryChannelGroup Nhóm kênh chính

  • sessionPrimaryChannelGroup Nhóm kênh chính của phiên

Phương diện Nguồn lưu lượng truy cập thủ công:

  • manualCampaignId Mã chiến dịch được đặt thủ công

  • manualCampaignName Tên chiến dịch được đặt thủ công

  • manualCreativeFormat Định dạng mẫu quảng cáo được đặt thủ công

  • manualMarketingTactic Chiến thuật tiếp thị thủ công

  • manualMedium Phương tiện được đặt thủ công

  • manualSource Nguồn được đặt thủ công

  • manualSourceMedium Nguồn / phương tiện thủ công

  • manualSourcePlatform Nền tảng nguồn được đặt thủ công

  • firstUserManualCampaignId Mã chiến dịch được đặt thủ công có người dùng lần đầu

  • firstUserManualCampaignName Tên chiến dịch được đặt thủ công có người dùng lần đầu

  • firstUserManualCreativeFormat Định dạng mẫu quảng cáo được đặt thủ công cho người dùng lần đầu

  • firstUserManualMarketingTactic Chiến thuật tiếp thị thủ công theo người dùng lần đầu

  • firstUserManualMedium Phương tiện được đặt thủ công cho người dùng lần đầu

  • firstUserManualSource Nguồn được đặt thủ công cho người dùng lần đầu

  • firstUserManualSourceMedium Nguồn / phương tiện thủ công theo người dùng lần đầu

  • firstUserManualSourcePlatform Nền tảng nguồn được đặt thủ công cho người dùng lần đầu

  • sessionManualCampaignId Mã chiến dịch được đặt thủ công dẫn đến phiên

  • sessionManualCampaignName Tên chiến dịch được đặt thủ công dẫn đến phiên

  • sessionManualCreativeFormat Định dạng mẫu quảng cáo được đặt thủ công dẫn đến phiên

  • sessionManualMarketingTactic Chiến thuật tiếp thị thủ công theo phiên

  • sessionManualMedium Phương tiện được đặt thủ công dẫn đến phiên

  • sessionManualSource Nguồn được đặt thủ công dẫn đến phiên

  • sessionManualSourceMedium Nguồn / phương tiện được đặt thủ công theo phiên

  • sessionManualSourcePlatform Nền tảng nguồn được đặt thủ công dẫn đến phiên

Các phương diện tích hợp Campaign Manager 360 (CM360):

  • cm360AccountId Mã tài khoản CM360

  • cm360AccountName Tên tài khoản CM360

  • cm360AdvertiserId Mã nhận dạng nhà quảng cáo CM360

  • cm360AdvertiserName Tên nhà quảng cáo CM360

  • cm360CampaignId Mã chiến dịch CM360

  • cm360CampaignName Tên chiến dịch trên CM360

  • cm360CreativeFormat Định dạng mẫu quảng cáo CM360

  • cm360CreativeId Mã mẫu quảng cáo CM360

  • cm360CreativeName Tên mẫu quảng cáo trên CM360

  • cm360CreativeType Loại mẫu quảng cáo CM360

  • cm360CreativeTypeId Mã loại mẫu quảng cáo CM360

  • cm360CreativeVersion Phiên bản mẫu quảng cáo trên CM360

  • cm360Medium Phương tiện CM360

  • cm360PlacementCostStructure Cấu trúc chi phí vị trí CM360

  • cm360PlacementId Mã vị trí CM360

  • cm360PlacementName Tên vị trí đặt quảng cáo trên CM360

  • cm360RenderingId Mã hiển thị CM360

  • cm360SiteId Mã trang web trên CM360

  • cm360SiteName Tên trang web trên CM360

  • cm360Source Nguồn CM360

  • cm360SourceMedium Nguồn / phương tiện trên CM360

  • firstUserCm360AccountId Mã tài khoản CM360 cho người dùng lần đầu

  • firstUserCm360AccountName Tên tài khoản CM360 của người dùng lần đầu

  • firstUserCm360AdvertiserId Mã nhận dạng nhà quảng cáo CM360 có người dùng lần đầu

  • firstUserCm360AdvertiserName Tên nhà quảng cáo CM360 có người dùng lần đầu

  • firstUserCm360CampaignId Mã chiến dịch CM360 có người dùng lần đầu

  • firstUserCm360CampaignName Tên chiến dịch CM360 cho người dùng lần đầu

  • firstUserCm360CreativeFormat Định dạng mẫu quảng cáo CM360 có người dùng lần đầu

  • firstUserCm360CreativeId Mã mẫu quảng cáo CM360 có người dùng lần đầu

  • firstUserCm360CreativeName Tên mẫu quảng cáo CM360 có người dùng lần đầu

  • firstUserCm360CreativeType Loại mẫu quảng cáo CM360 có người dùng lần đầu

  • firstUserCm360CreativeTypeId Mã loại mẫu quảng cáo CM360 có người dùng lần đầu

  • firstUserCm360CreativeVersion Phiên bản mẫu quảng cáo CM360 có người dùng lần đầu

  • firstUserCm360Medium Phương tiện CM360 cho người dùng lần đầu

  • firstUserCm360PlacementCostStructure Cấu trúc chi phí cho vị trí CM360 có người dùng lần đầu

  • firstUserCm360PlacementId Mã vị trí CM360 cho người dùng lần đầu

  • firstUserCm360PlacementName Tên vị trí CM360 cho người dùng lần đầu

  • firstUserCm360RenderingId Mã hiển thị CM360 cho người dùng lần đầu

  • firstUserCm360SiteId Mã trang web CM360 cho người dùng lần đầu

  • firstUserCm360SiteName Tên trang web CM360 cho người dùng lần đầu

  • firstUserCm360Source Nguồn CM360 cho người dùng lần đầu

  • firstUserCm360SourceMedium Nguồn / phương tiện CM360 có người dùng lần đầu

  • sessionCm360AccountId Mã tài khoản CM360 của phiên

  • sessionCm360AccountName Tên tài khoản CM360 của phiên

  • sessionCm360AdvertiserId Mã nhận dạng nhà quảng cáo CM360 của phiên

  • sessionCm360AdvertiserName Tên nhà quảng cáo CM360 của phiên

  • sessionCm360CampaignId Mã chiến dịch CM360 của phiên

  • sessionCm360CampaignName Tên chiến dịch CM360 của phiên

  • sessionCm360CreativeFormat Định dạng mẫu quảng cáo CM360 của phiên

  • sessionCm360CreativeId Mã mẫu quảng cáo CM360 của phiên

  • sessionCm360CreativeName Tên mẫu quảng cáo trên CM360 của phiên

  • sessionCm360CreativeType Loại mẫu quảng cáo CM360 của phiên

  • sessionCm360CreativeTypeId Mã loại mẫu quảng cáo CM360 của phiên

  • sessionCm360CreativeVersion Phiên bản mẫu quảng cáo CM360 của phiên

  • sessionCm360Medium Phương tiện CM360 của phiên

  • sessionCm360PlacementCostStructure Cấu trúc chi phí cho vị trí CM360 của phiên

  • sessionCm360PlacementId Mã vị trí CM360 của phiên

  • sessionCm360PlacementName Tên vị trí trên CM360 của phiên

  • sessionCm360RenderingId Mã hiển thị CM360 của phiên

  • sessionCm360SiteId Mã trang web trên CM360 của phiên

  • sessionCm360SiteName Tên trang web CM360 của phiên

  • sessionCm360Source Nguồn CM360 của phiên

  • sessionCm360SourceMedium Nguồn / phương tiện CM360 của phiên

Các phương diện tích hợp Google Display & Video 360 (DV360):

  • dv360AdvertiserId Mã nhận dạng nhà quảng cáo DV360

  • dv360AdvertiserName Tên nhà quảng cáo DV360

  • dv360CampaignId Mã chiến dịch DV360

  • dv360CampaignName Tên chiến dịch trên DV360

  • dv360CreativeFormat Định dạng mẫu quảng cáo trên DV360

  • dv360CreativeId Mã mẫu quảng cáo trên DV360

  • dv360CreativeName Tên mẫu quảng cáo trên DV360

  • dv360ExchangeId Mã nền tảng trao đổi quảng cáo trên DV360

  • dv360ExchangeName Tên nền tảng trao đổi quảng cáo trên DV360

  • dv360InsertionOrderId Mã đơn đặt hàng quảng cáo DV360

  • dv360InsertionOrderName Tên đơn đặt hàng quảng cáo trên DV360

  • dv360LineItemId Mã mục hàng trên DV360

  • dv360LineItemName Tên mục hàng trên DV360

  • dv360Medium Phương tiện DV360

  • dv360PartnerId Mã đối tác DV360

  • dv360PartnerName Tên đối tác DV360

  • dv360Source Nguồn DV360

  • dv360SourceMedium Nguồn / phương tiện trên DV360

  • firstUserDv360AdvertiserId Mã nhận dạng nhà quảng cáo DV360 có người dùng lần đầu

  • firstUserDv360AdvertiserName Tên nhà quảng cáo DV360 có người dùng lần đầu

  • firstUserDv360CampaignId Mã chiến dịch DV360 của người dùng lần đầu

  • firstUserDv360CampaignName Tên chiến dịch DV360 của người dùng lần đầu

  • firstUserDv360CreativeFormat Định dạng mẫu quảng cáo DV360 có người dùng lần đầu

  • firstUserDv360CreativeId Mã mẫu quảng cáo DV360 có người dùng lần đầu

  • firstUserDv360CreativeName Tên mẫu quảng cáo DV360 có người dùng lần đầu

  • firstUserDv360ExchangeId Mã giao dịch DV360 có người dùng lần đầu

  • firstUserDv360ExchangeName Tên giao dịch DV360 có người dùng lần đầu

  • firstUserDv360InsertionOrderId Mã đơn đặt hàng quảng cáo DV360 có người dùng lần đầu

  • firstUserDv360InsertionOrderName Tên đơn đặt hàng quảng cáo DV360 có người dùng lần đầu

  • firstUserDv360LineItemId Mã mục hàng DV360 có người dùng lần đầu

  • firstUserDv360LinteItemName Tên mục hàng DV360 có người dùng lần đầu

  • firstUserDv360Medium Phương tiện DV360 của người dùng lần đầu

  • firstUserDv360PartnerId Mã đối tác DV360 có người dùng lần đầu

  • firstUserDv360PartnerName Tên đối tác DV360 có người dùng lần đầu

  • firstUserDv360Source Nguồn DV360 của người dùng lần đầu

  • firstUserDv360SourceMedium Nguồn / phương tiện DV360 có người dùng lần đầu

  • sessionDv360AdvertiserId Mã nhận dạng nhà quảng cáo DV360 của phiên

  • sessionDv360AdvertiserName Tên nhà quảng cáo DV360 của phiên

  • sessionDv360CampaignId Mã chiến dịch DV360 của phiên

  • sessionDv360CampaignName Tên chiến dịch DV360 của phiên

  • sessionDv360CreativeFormat Định dạng mẫu quảng cáo DV360 của phiên

  • sessionDv360CreativeId Mã mẫu quảng cáo trên DV360 của phiên

  • sessionDv360CreativeName Tên mẫu quảng cáo DV360 của phiên

  • sessionDv360ExchangeId Mã nền tảng trao đổi quảng cáo trên DV360 của phiên

  • sessionDv360ExchangeName Tên nền tảng trao đổi quảng cáo trên DV360 của phiên

  • sessionDv360InsertionOrderId Mã đơn đặt hàng quảng cáo DV360 của phiên

  • sessionDv360InsertionOrderName Tên đơn đặt hàng quảng cáo trên DV360 của phiên

  • sessionDv360LineItemId Mã mục hàng DV360 của phiên

  • sessionDv360LineItemName Tên mục hàng DV360 của phiên

  • sessionDv360Medium Phương tiện DV360 của phiên

  • sessionDv360PartnerId Mã đối tác DV360 của phiên

  • sessionDv360PartnerName Tên đối tác DV360 của phiên

  • sessionDv360Source Nguồn DV360 của phiên

  • sessionDv360SourceMedium Nguồn / phương tiện trên DV360 của phiên

Các phương diện tích hợp Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId Mã nhóm quảng cáo trên SA360 của người dùng lần đầu

  • firstUserSa360AdGroupName Tên nhóm quảng cáo trên SA360 có người dùng lần đầu

  • firstUserSa360CampaignId Mã chiến dịch trên SA360 của người dùng lần đầu

  • firstUserSa360CampaignName Chiến dịch trên SA360 có người dùng lần đầu

  • firstUserSa360CreativeFormat Định dạng mẫu quảng cáo trên SA360 thu nạp người dùng lần đầu

  • firstUserSa360EngineAccountId Mã tài khoản công cụ trên Search Ads 360 có người dùng lần đầu

  • firstUserSa360EngineAccountName Tên tài khoản công cụ trên Search Ads 360 có người dùng lần đầu

  • firstUserSa360EngineAccountType Loại tài khoản công cụ trên Search Ads 360 có người dùng lần đầu

  • firstUserSa360KeywordText Văn bản từ khoá trên Search Ads 360 có người dùng lần đầu

  • firstUserSa360ManagerAccountId Mã tài khoản người quản lý SA360 có người dùng lần đầu

  • firstUserSa360ManagerAccountName Tên tài khoản người quản lý SA360 có người dùng lần đầu

  • firstUserSa360Medium Phương tiện trên SA360 có người dùng lần đầu

  • firstUserSa360Query Cụm từ tìm kiếm trên SA360 có người dùng lần đầu

  • firstUserSa360Source Nguồn trên Search Ads 360 có người dùng lần đầu

  • firstUserSa360SourceMedium Nguồn / phương tiện trên SA360 có người dùng lần đầu

  • sa360AdGroupId Mã nhóm quảng cáo trên SA360

  • sa360CampaignId Mã chiến dịch trên SA360

  • sa360AdGroupName Tên nhóm quảng cáo trên SA360

  • sa360CampaignName Chiến dịch trên SA360

  • sa360CreativeFormat Định dạng mẫu quảng cáo trên SA360

  • sa360EngineAccountId Mã tài khoản công cụ trên SA360

  • sa360EngineAccountName Tên tài khoản công cụ trên SA360

  • sa360EngineAccountType Loại tài khoản công cụ trên SA360

  • sa360KeywordText Văn bản từ khoá trên Search Ads 360

  • sa360ManagerAccountId Mã tài khoản người quản lý SA360

  • sa360ManagerAccountName Tên tài khoản người quản lý SA360

  • sa360Medium Phương tiện trên SA360

  • sa360Query Cụm từ tìm kiếm trên SA360

  • sa360Source Nguồn trên SA360

  • sa360SourceMedium Nguồn / phương tiện trên SA360

  • sessionSa360AdGroupId Mã nhóm quảng cáo trên SA360 của phiên

  • sessionSa360CampaignId Mã chiến dịch trên SA360 của phiên

  • sessionSa360ManagerAccountId Mã tài khoản người quản lý trên SA360 thu nạp phiên

  • sessionSa360ManagerAccountName Tên tài khoản người quản lý SA360 của phiên

  • sessionSa360SourceMedium Nguồn / phương tiện trên SA360 thu nạp phiên

Ngày 6 tháng 3 năm 2024 Hỗ trợ đối tượng người dùng không hoạt động trong tính năng Xuất đối tượng.

Tính năng Xuất đối tượng hỗ trợ tốt hơn việc xuất đối tượng người dùng không hoạt động. Người dùng sẽ thuộc các đối tượng này mà không cần có sự kiện đủ điều kiện; ví dụ: người dùng có thể thuộc đối tượng bằng cách không truy cập vào trang web của bạn trong 7 ngày. Ví dụ về đối tượng người dùng không hoạt động bao gồm "Người mua hàng không hoạt động trong 7 ngày", "Người dùng không hoạt động trong 7 ngày" và "Người dùng không nhận được thông báo trong 7 ngày". Để tìm hiểu thêm về những đối tượng được đề xuất đó, hãy xem bài viết Đối tượng được đề xuất.

Ngày 28/2/2024 Tính năng Xuất đối tượng trả về mã nhận dạng người dùng được chỉ định trong hoạt động gắn thẻ.

Tính năng Xuất đối tượng hiện trả về mã nhận dạng người dùng được chỉ định trong tính năng gắn thẻ, ngay cả khi bạn bật dữ liệu do người dùng cung cấp cho tài sản của mình. Nếu bạn bật tính năng thu thập dữ liệu do người dùng cung cấp, thì dữ liệu do người dùng cung cấp cùng với User-ID có thể được gửi đến Google Analytics trong quá trình gắn thẻ để cải thiện kết quả đo lường. Để tìm hiểu thêm, hãy xem bài viết về hoạt động thu thập dữ liệu do người dùng cung cấp.

Ngày 30/1/2024 Hỗ trợ thông báo webhook cho Danh sách đối tượng, Danh sách đối tượng định kỳ trong Data API phiên bản 1 alpha.

Bạn có thể chỉ định các trường AudienceList.webhookNotification và RecurringAudienceList.webhookNotification khi tạo Danh sách đối tượng (bằng cách sử dụng properties.audienceLists.create) hoặc Danh sách đối tượng định kỳ (bằng cách sử dụng properties.recurringAudienceLists.create).

Chức năng này cho phép bạn nhận thông báo Webhook không đồng bộ khi có danh sách đối tượng.

18/01/2024 Cải thiện khả năng tương thích cho những phương diện có chứa chuỗi truy vấn hoặc thành phần phút.

Những phương diện có chứa chuỗi truy vấn hiện tương thích với hầu hết các trường. Các phương diện như pagePathPlusQueryString, unifiedPageScreen, pageLocation và fullPageUrl hiện tương thích với nhiều trường bổ sung, bao gồm sessionSource, browser, city và landingPage.

Các phương diện có thành phần phút hiện tương thích với hầu hết các trường. Các phương diện như minute, nthMinute và dateHourMinute hiện tương thích với một nhóm tương tự gồm các trường bổ sung.

Hãy xem Trình khám phá phương diện và chỉ số GA4 để biết thông tin toàn diện về khả năng tương thích.

13/12/2023 Thông số tuỳ chỉnh ở phạm vi mặt hàng

Giờ đây, bạn có thể thêm phương diện tuỳ chỉnh ở phạm vi mặt hàng vào các truy vấn Data API của Analytics bằng cú pháp sau:

Tên API chung Mô tả
customItem:parameter_name Phương diện tuỳ chỉnh ở phạm vi mặt hàng cho parameter_name

Hãy xem phần Kích thước và chỉ số API để biết thêm thông tin.

05/12/2023 Danh sách đối tượng có trong Data API phiên bản 1 beta dưới dạng Đối tượng xuất

Tính năng Danh sách đối tượng đã được đổi tên thành Xuất đối tượng và được thêm vào Data API phiên bản 1 beta.

Thêm các phương thức sau vào Data API phiên bản 1 beta:

28/11/2023 Đã thêm samplingMetadatas vào phản hồi báo cáo

Thêm samplingMetadatas vào ResponseMetaData. Tập hợp này sẽ chứa một SampleMetadata cho mỗi phạm vi ngày trong yêu cầu mà kết quả được lấy mẫu. Google Analytics sẽ chỉ áp dụng tính năng lấy mẫu khi dự đoán rằng giới hạn về số lượng giá trị riêng biệt sẽ làm giảm chất lượng dữ liệu.

28/11/2023 Thêm chức năng xuất Danh sách đối tượng định kỳ vào Data API phiên bản 1 alpha

Thêm các phương thức properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list vào Data API phiên bản 1 alpha.

Chức năng này cho phép bạn tạo danh sách đối tượng hằng ngày khi Thành viên đối tượng thay đổi. Danh sách đối tượng định kỳ đảm bảo bạn đang sử dụng kết quả mới nhất về tư cách thành viên của Đối tượng.

Ngày 13/10/2023 Thêm tính năng hỗ trợ Đối tượng có thời hạn thành viên là 1 ngày

Giờ đây, chức năng xuất Danh sách đối tượng hỗ trợ những đối tượng có thời gian thành viên là 1 ngày.

Ngày 12/9/2023 Quy tắc sắp xếp mặc định của AudienceList

Theo mặc định, các báo cáo được tạo bằng chức năng xuất Danh sách đối tượng tuân theo các quy tắc sắp xếp giống như các phương thức báo cáo khác của Data API: thứ tự sẽ giảm dần theo cột đầu tiên, sau đó giảm dần theo cột thứ hai, v.v.

Trước khi có thay đổi này, bạn có thể đã nhận được báo cáo sau:

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

Sau thay đổi này, bạn sẽ nhận được báo cáo sau:

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

Ngày 15/8/2023 Đã thêm phương diện isLimitedAdTracking vào giản đồ xuất Danh sách đối tượng

  • isLimitedAdTracking Chế độ cài đặt Giới hạn theo dõi quảng cáo của thiết bị. Các giá trị có thể có bao gồm: true, false và (not set).

    Để tìm hiểu thêm, hãy xem bài viết Các phương diện của danh sách đối tượng.

15/08/2023 Đã thêm phương diện currencyCode, chỉ số itemDiscountAmount

  • currencyCode Mã đơn vị tiền tệ địa phương (dựa trên tiêu chuẩn ISO 4217) của sự kiện thương mại điện tử. Ví dụ: "USD" hoặc "GBP".

  • itemDiscountAmount Giá trị tiền tệ của chiết khấu mặt hàng trong các sự kiện thương mại điện tử. Chỉ số này được điền sẵn trong hoạt động gắn thẻ bằng thông số mặt hàng "discount".

Để tìm hiểu thêm, hãy xem Sơ đồ báo cáo Data API.

10/08/2023 Đã thêm phương diện isAdsPersonalizationAllowed vào giản đồ xuất Danh sách đối tượng

  • isAdsPersonalizationAllowed Bạn được phép cá nhân hoá quảng cáo. Nếu người dùng đủ điều kiện sử dụng chế độ cá nhân hoá quảng cáo, thì isAdsPersonalizationAllowed sẽ trả về true. Nếu người dùng không đủ điều kiện sử dụng chế độ cá nhân hoá quảng cáo, thì isAdsPersonalizationAllowed sẽ trả về false.

    Để tìm hiểu thêm, hãy xem bài viết Các phương diện của danh sách đối tượng.

10/07/2023 Danh sách đối tượng

Đã thêm chế độ hỗ trợ Danh sách đối tượng vào Data API phiên bản 1 alpha. Danh sách đối tượng bao gồm thông tin tổng quan về người dùng trong đối tượng tại thời điểm tạo Danh sách đối tượng.

Các phương thức sau được thêm vào Data API phiên bản 1 alpha:

2023-05-19 Nhóm kênh tuỳ chỉnh

Nhóm kênh tuỳ chỉnh được thêm vào Data API.

11/05/2023 Thay đổi về hạn mức mã thông báo.

Hệ thống hạn mức của Data API đã được cập nhật để tính phí chính xác hơn.

Số lượng mã thông báo được tính cho mỗi yêu cầu đã được cập nhật theo hạn mức thay đổi và được cân bằng lại để cho phép một số lượng lớn hơn các truy vấn báo cáo đơn giản, đồng thời tính phí số lượng mã thông báo hạn mức cao hơn đáng kể cho các báo cáo có phạm vi ngày lớn.

Sau thay đổi này, mặc dù phí cho một số yêu cầu sẽ không thay đổi, nhưng phí cho các truy vấn phức tạp hơn sẽ tăng đáng kể. Ví dụ: yêu cầu về dữ liệu trong hơn 6 tháng có thể tính phí từ 1.000 mã thông báo hạn mức trở lên.

Tài sản chuẩn

Tên hạn mức Giới hạn cũ Hạn mức mới
Số mã thông báo cốt lõi cho mỗi tài sản mỗi ngày 25.000 200.000
Số mã thông báo cốt lõi trên mỗi tài sản mỗi giờ 5.000 40.000
Số lượng mã thông báo cốt lõi cho mỗi dự án, mỗi tài sản, mỗi giờ 1.750 14.000
Số mã thông báo theo thời gian thực cho mỗi tài sản mỗi ngày 25.000 200.000
Số mã thông báo theo thời gian thực trên mỗi tài sản mỗi giờ 5.000 40.000
Số mã thông báo theo thời gian thực cho mỗi dự án, mỗi tài sản, mỗi giờ 1.750 14.000
Số mã thông báo phễu cho mỗi tài sản mỗi ngày 25.000 200.000
Số mã thông báo phễu trên mỗi tài sản mỗi giờ 5.000 40.000
Số mã thông báo phễu trên mỗi dự án, mỗi tài sản, mỗi giờ 1.750 14.000

Tài sản Analytics 360

Tên hạn mức Giới hạn cũ Hạn mức mới
Số mã thông báo cốt lõi cho mỗi tài sản mỗi ngày 250.000 2.000.000
Số mã thông báo cốt lõi trên mỗi tài sản mỗi giờ 50.000 400.000
Số lượng mã thông báo cốt lõi cho mỗi dự án, mỗi tài sản, mỗi giờ 17.500 140.000
Số mã thông báo theo thời gian thực cho mỗi tài sản mỗi ngày 250.000 2.000.000
Số mã thông báo theo thời gian thực trên mỗi tài sản mỗi giờ 50.000 400.000
Số mã thông báo theo thời gian thực cho mỗi dự án, mỗi tài sản, mỗi giờ 17.500 140.000
Số mã thông báo phễu cho mỗi tài sản mỗi ngày 250.000 2.000.000
Số mã thông báo phễu trên mỗi tài sản mỗi giờ 50.000 400.000
Số mã thông báo phễu trên mỗi dự án, mỗi tài sản, mỗi giờ 17.500 140.000

2023-03-02 Thêm phương diện ngày.

  • dayOfWeekName Tên ngày trong tuần. Ngày trong tuần bằng tiếng Anh. Phương diện này có các giá trị là Sunday, Monday, v.v.

  • isoWeek Tuần theo ISO trong năm. Số tuần theo ISO, trong đó mỗi tuần bắt đầu vào thứ Hai. Để biết thông tin chi tiết, hãy xem https://en.wikipedia.org/wiki/ISO_week_date. Các giá trị ví dụ bao gồm 01, 02 và 53.

  • Năm isoYear theo ISO. Năm theo ISO của sự kiện. Để biết thông tin chi tiết, hãy xem https://en.wikipedia.org/wiki/ISO_week_date. Giá trị mẫu bao gồm 2022 và 2023.

  • isoYearIsoWeek Tuần theo ISO trong năm theo ISO. Giá trị kết hợp của isoWeek và isoYear. Giá trị mẫu bao gồm 201652 và 201701.

  • yearMonth Năm – tháng. Giá trị kết hợp của year và month. Giá trị mẫu bao gồm 202212 hoặc 202301.

  • yearWeek Năm – tuần. Giá trị kết hợp của year và week. Giá trị mẫu bao gồm 202253 hoặc 202301.

27/02/2023 Đã thêm phương diện thương mại điện tử.

  • itemListPosition Vị trí danh sách mặt hàng. Vị trí của một mặt hàng (ví dụ: một sản phẩm mà bạn bán) trong danh sách. Phương diện này được điền sẵn trong quá trình gắn thẻ bằng thông số "index" trong mảng items.

  • itemLocationID Mã vị trí mặt hàng. Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Trường này được điền sẵn trong hoạt động gắn thẻ bằng thông số "location_id" trong mảng items.

  • itemPromotionCreativeSlot Vị trí mẫu quảng cáo trong chương trình khuyến mãi của mặt hàng. Tên của vùng mẫu quảng cáo được liên kết với mặt hàng. Bạn có thể chỉ định phương diện này trong hoạt động gắn thẻ bằng tham số creative_slot ở cấp sự kiện hoặc mặt hàng. Nếu thông số được chỉ định ở cả cấp sự kiện và cấp mặt hàng, thì thông số ở cấp mặt hàng sẽ được sử dụng.

21/02/2023 Thêm phương diện "Trang đích + chuỗi truy vấn".

  • landingPagePlusQueryString Trang đích + chuỗi truy vấn. Đường dẫn trang + chuỗi truy vấn được liên kết với lượt xem trang đầu tiên trong một phiên.

Trường này thay thế phương diện landingPage (nay không dùng nữa) và sẽ được cập nhật để không trả về chuỗi truy vấn vào ngày 14 tháng 5 năm 2023.

28/01/2023 Đã thêm chỉ số "Số lượt xem trên mỗi người dùng", "Số người dùng đã cuộn".

  • screenPageViewsPerUser Số lượt xem trên mỗi người dùng. Số lượng màn hình ứng dụng hoặc trang web mà người dùng đã xem trên mỗi người dùng đang hoạt động. Chỉ số này tính cả số lượt xem lặp lại của một trang hoặc màn hình. (screen_view + page_view events) / active users.

  • scrolledUsers Người dùng đã di chuyển lên/xuống. Số lượng người dùng riêng biệt đã di chuyển xuống ít nhất 90% chiều dài của trang.

23/01/2023 Đã thêm phương diện "Châu lục", "Mã châu lục".

  • continent Châu lục. Châu lục nơi bắt nguồn hoạt động của người dùng. Ví dụ: Americas hoặc Asia

  • continentId Mã châu lục. Mã địa lý của lục địa nơi bắt nguồn hoạt động của người dùng, được lấy từ địa chỉ IP của họ.

23/01/2023 Thêm phương diện "Mã bộ lọc dữ liệu thử nghiệm".

  • testDataFilterId Mã bộ lọc dữ liệu thử nghiệm. Giá trị nhận dạng bằng số của một bộ lọc dữ liệu ở trạng thái thử nghiệm. Bạn sử dụng bộ lọc dữ liệu để thêm hoặc loại trừ dữ liệu sự kiện khỏi báo cáo của mình dựa trên các giá trị thông số sự kiện. Để tìm hiểu thêm, hãy xem bài viết https://support.google.com/analytics/answer/10108813.

Ngày 18/10/2022 Đã thêm các chỉ số về Quảng cáo.

  • advertiserAdClicks Số lượt nhấp vào quảng cáo. Tổng số lần người dùng đã nhấp vào một quảng cáo để truy cập vào tài sản.
  • advertiserAdCost Chi phí quảng cáo. Tổng số tiền mà bạn đã trả cho quảng cáo của mình.
  • advertiserAdCostPerClick Chi phí mỗi lượt nhấp vào quảng cáo. Chi phí mỗi lượt nhấp vào quảng cáo là chi phí quảng cáo chia cho số lượt nhấp vào quảng cáo và thường được viết tắt là CPC.
  • advertiserAdCostPerConversion Chi phí mỗi lượt chuyển đổi. Chi phí cho mỗi lượt chuyển đổi là chi phí quảng cáo chia cho số lượt chuyển đổi.
  • advertiserAdImpressions Số lượt hiển thị quảng cáo. Tổng số lượt hiển thị.
  • returnOnAdSpend Lợi tức trên chi tiêu quảng cáo. Lợi tức trên chi tiêu quảng cáo (ROAS) là tổng doanh thu chia cho chi phí quảng cáo của nhà quảng cáo.

17/10/2022 Thêm chỉ số ở phạm vi mặt hàng.

  • itemsAddedToCart Số mặt hàng được thêm vào giỏ hàng. Số lượng đơn vị được thêm vào giỏ hàng cho một mặt hàng.
  • itemsCheckedOut mặt hàng đã được thanh toán. Số đơn vị đã thanh toán cho một mặt hàng.
  • itemsClickedInList Số mặt hàng được nhấp vào trong danh sách. Số lượng đơn vị được nhấp vào trong danh sách cho một mặt hàng.
  • itemsClickedInPromotion Số mặt hàng được nhấp vào trong chương trình khuyến mãi. Số lượng đơn vị được nhấp vào trong chương trình khuyến mãi của một mặt hàng.
  • itemsViewed Số mặt hàng được xem. Số đơn vị đã xem cho một mặt hàng.
  • itemsViewedInList Số mặt hàng được xem trong danh sách. Số lượng đơn vị đã xem trong danh sách cho một mặt hàng.
  • itemsViewedInPromotion Số mặt hàng được xem trong chương trình khuyến mãi. Số lượng đơn vị đã xem trong chương trình khuyến mãi của một mặt hàng.

13/9/2022 Thông báo về các thay đổi đối với khả năng tương thích của lược đồ.

Từ ngày 1 tháng 12 năm 2022, những thay đổi sau đây sẽ xảy ra:

  1. Các phương diện ở phạm vi mặt hàng như itemName đang trở nên không tương thích với các chỉ số ở phạm vi sự kiện như eventCount. Các phương diện ở phạm vi mặt hàng vẫn tương thích với các chỉ số ở phạm vi mặt hàng như itemRevenue, các chỉ số dựa trên người dùng như activeUsers và các chỉ số dựa trên phiên như sessions.

  2. Các phương diện phân bổ như source đang trở nên không tương thích với một số chỉ số ở phạm vi sự kiện như eventCount. Các phương diện phân bổ vẫn sẽ tương thích với các chỉ số có thể phân bổ như conversions, các chỉ số dựa trên người dùng như activeUsers và các chỉ số dựa trên phiên như sessions.

  3. Những phương diện có chứa chuỗi truy vấn như pagePathPlusQueryString sẽ chỉ tương thích với một số phương diện và chỉ số nhất định.

2022-09-01 Thay đổi về hạn mức.

  • Hạn mức Requests per day , Requests Per Minute, Requests Per Minute Per User sẽ bị xoá khỏi Data API.

  • Đã thêm hạn mức Tokens Per Project Per Property Per Hour vào API.

  • Mỗi yêu cầu đều tiêu thụ hạn mức cho cả Tokens Per Property Per Hour và Tokens Per Project Per Property Per Hour.

    Hãy xem Tài liệu về hạn mức để biết thông tin chi tiết về hạn mức mới.

03/08/2022 Đã thêm phương diện SA360 ở phạm vi phiên.

  • sessionSa360AdGroupName Tên nhóm quảng cáo trên SA360 của phiên. Tên nhóm quảng cáo trên Search Ads 360 đã dẫn đến phiên này.

  • sessionSa360CampaignName Chiến dịch trên SA360 có phiên hoạt động. Tên chiến dịch trên Search Ads 360 đã dẫn đến phiên này.

  • sessionSa360CreativeFormat Định dạng quảng cáo trên SA360 dẫn đến phiên. Loại mẫu quảng cáo trên Search Ads 360 đã dẫn đến phiên này. Ví dụ: "Quảng cáo tìm kiếm thích ứng" hoặc "Quảng cáo dạng văn bản mở rộng".

  • sessionSa360EngineAccountId Mã tài khoản công cụ trên SA360 dẫn đến phiên. Mã tài khoản công cụ trên SA360 đã dẫn đến phiên này.

  • sessionSa360EngineAccountName Tên tài khoản công cụ trên SA360 dẫn đến phiên. Tên của tài khoản công cụ trên SA360 đã dẫn đến phiên này.

  • sessionSa360EngineAccountType Loại tài khoản công cụ trên Search Ads 360 có phiên hoạt động. Loại tài khoản công cụ trên Search Ads 360 đã dẫn đến phiên này. Ví dụ: "google ads", "bing" hoặc "baidu".

  • sessionSa360Keyword Văn bản từ khoá trên SA360 liên kết với phiên. Từ khoá trên công cụ tìm kiếm từ Search Ads 360 đã dẫn đến phiên này.

  • sessionSa360Medium Phương tiện trên SA360 thu nạp phiên. Từ khoá trên công cụ tìm kiếm từ Search Ads 360 đã dẫn đến phiên này. Ví dụ: "cpc".

  • sessionSa360Query Cụm từ tìm kiếm trên SA360 liên kết với phiên. Cụm từ tìm kiếm trên Search Ads 360 đã dẫn đến phiên này.

  • sessionSa360Source Nguồn trên SA360 của phiên. Nguồn lưu lượng truy cập từ Search Ads 360 đã dẫn đến phiên này. Ví dụ: "example.com" hoặc "google".

  • Phương diện sessionCampaignId, sessionCampaignName hiện hỗ trợ chiến dịch trên Search Ads 360.

11/07/2022 Thêm các chỉ số về tỷ lệ chuyển đổi.

Tỷ lệ chuyển đổi

  • sessionConversionRate Tỷ lệ phần trăm số phiên hoạt động có một sự kiện chuyển đổi bất kỳ được kích hoạt.

  • userConversionRate Tỷ lệ phần trăm số người dùng đã kích hoạt một sự kiện chuyển đổi bất kỳ.

Chỉ số tỷ lệ chuyển đổi cho một lượt chuyển đổi

  • sessionConversionRate:event_name Tỷ lệ phần trăm số phiên hoạt động có một sự kiện chuyển đổi cụ thể được kích hoạt.

  • userConversionRate:event_name Tỷ lệ phần trăm số người dùng đã kích hoạt một sự kiện chuyển đổi cụ thể.

05/05/2022 Đã thêm chức năng báo cáo Phễu vào kênh Alpha.

  • Phương thức runFunnelReport được thêm vào phiên bản v1alpha của API. Phương thức này trả về một báo cáo phễu tuỳ chỉnh của dữ liệu sự kiện Google Analytics.

  • Phương thức này được ra mắt với độ ổn định alpha, nhằm mục đích thu thập thông tin phản hồi về cú pháp và chức năng trước khi chuyển sang giai đoạn thử nghiệm beta. Vui lòng hoàn tất biểu mẫu Phản hồi về báo cáo phễu Google Analytics Data API để cung cấp ý kiến phản hồi về API này.

Ngày 16/2/2022 Thêm phương diện mới.

Thuật ngữ và nội dung về việc đánh giá thủ công

  • firstUserManualAdContent Nội dung quảng cáo được tạo thủ công cho người dùng lần đầu. Nội dung quảng cáo đã thu nạp người dùng lần đầu. Được điền sẵn bằng thông số utm_content.

  • firstUserManualTerm Từ khoá được đặt thủ công cho người dùng lần đầu. Từ khoá đã thu nạp người dùng lần đầu tiên. Được điền sẵn bằng thông số utm_term.

  • manualAdContent Nội dung quảng cáo được tạo thủ công. Nội dung quảng cáo được phân bổ cho sự kiện chuyển đổi. Được điền sẵn bằng thông số utm_content.

  • manualTerm Từ khoá được đặt thủ công. Cụm từ tìm kiếm được phân bổ cho sự kiện chuyển đổi. Được điền sẵn bằng thông số utm_term.

  • sessionManualAdContent Nội dung quảng cáo được tạo thủ công cho phiên. Nội dung quảng cáo dẫn đến một phiên. Được điền sẵn bằng thông số utm_content.

  • sessionManualTerm Từ khoá được đặt thủ công dẫn đến phiên. Từ khoá đã dẫn đến một phiên. Được điền sẵn bằng thông số utm_term.

Phân tích sự cố

  • crashAffectedUsers Số người dùng gặp sự cố. Số người dùng đã ghi lại một sự cố trong hàng này của báo cáo.

  • crashFreeUsersRate Tỷ lệ người dùng không gặp sự cố.

Ứng dụng/Web

  • averageSessionDuration Thời lượng trung bình (tính bằng giây) của phiên người dùng.

  • newVsReturning Người dùng mới / người dùng cũ.

  • screenPageViewsPerSession Số lượt xem trên mỗi phiên.

  • landingPage Trang đích. Đường dẫn trang + chuỗi truy vấn được liên kết với lượt xem trang đầu tiên trong một phiên.

  • platformDeviceCategory Nền tảng và loại thiết bị mà trang web hoặc ứng dụng di động của bạn đã chạy.

Ứng dụng di động

  • averagePurchaseRevenuePerUser Doanh thu trung bình từ giao dịch mua hàng trên mỗi người dùng.

  • firstTimePurchaserConversionRate Tỷ lệ phần trăm người dùng đang hoạt động đã thực hiện giao dịch mua đầu tiên.

  • firstTimePurchasersPerNewUser Số người mua lần đầu trung bình trên mỗi người dùng mới.

  • dauPerMau DAU / MAU. Tỷ lệ phần trăm luân phiên của người dùng hoạt động trong 30 ngày cũng là người dùng hoạt động trong 1 ngày.

  • dauPerWau DAU / WAU. Tỷ lệ phần trăm luân phiên của người dùng hoạt động trong 7 ngày cũng là người dùng hoạt động trong 1 ngày.

  • wauPerMau WAU / MAU. Tỷ lệ phần trăm luân phiên của người dùng hoạt động trong 30 ngày cũng là người dùng hoạt động trong 7 ngày.

  • purchaserConversionRate Tỷ lệ phần trăm người dùng đang hoạt động đã thực hiện 1 giao dịch mua hàng trở lên.

  • transactionsPerPurchaser Số giao dịch trên mỗi người mua.

Chiến dịch trên Google Ads

  • firstUserGoogleAdsCampaignType Loại chiến dịch của chiến dịch trên Google Ads đã thu nạp người dùng lần đầu.

  • googleAdsCampaignType Loại chiến dịch cho chiến dịch trên Google Ads được phân bổ cho sự kiện chuyển đổi.

  • sessionGoogleAdsCampaignType Loại chiến dịch của chiến dịch trên Google Ads đã dẫn đến phiên hoạt động này.

2021-09-07 Thêm phương diện Ngày/giờ mới.

  • dateHourMinute Giá trị kết hợp của ngày, giờ và phút được định dạng là YYYYMMDDHHMM.

  • minute Phút gồm hai chữ số trong giờ mà sự kiện được ghi lại.

  • nthMinute Số phút kể từ khi bắt đầu phạm vi ngày.

07/09/2021 Thêm phương diện mới được điền sẵn bằng thông số sự kiện.

  • achievementId Mã nhận dạng thành tích trong một trò chơi cho một sự kiện.

  • character Nhân vật do người chơi điều khiển trong một trò chơi cho một sự kiện.

  • fileExtension Đuôi của tệp đã tải xuống.

  • fileName Đường dẫn trang của tệp đã tải xuống.

  • groupId Mã nhóm người chơi trong một trò chơi cho một sự kiện.

  • linkClasses Thuộc tính HTML class cho một đường liên kết ra ngoài.

  • linkDomain Miền đích của đường liên kết ra ngoài.

  • linkId Thuộc tính HTML id cho một đường liên kết ra ngoài hoặc tệp tải xuống.

  • linkText Văn bản của đường liên kết đến một tệp tải xuống.

  • linkUrl URL đầy đủ của một đường liên kết ra ngoài hoặc tệp tải xuống.

  • method Phương thức kích hoạt một sự kiện.

  • outbound Trả về "true" nếu đường liên kết dẫn đến một trang web không thuộc miền của tài sản.

  • pageLocation Giao thức, tên máy chủ, đường dẫn trang và chuỗi truy vấn cho các trang web đã truy cập.

  • pageReferrer URL giới thiệu đầy đủ, bao gồm cả tên máy chủ và đường dẫn.

  • percentScrolled Tỷ lệ phần trăm theo chiều dài của trang mà người dùng đã cuộn xuống (ví dụ: "90").

  • searchTerm Cụm từ mà người dùng tìm kiếm.

  • videoProvider Nguồn của video (ví dụ: "youtube").

  • videoTitle Tiêu đề của video.

  • videoUrl URL của video.

  • visible Trả về "true" nếu nội dung hiển thị.

  • unifiedPagePathScreen Đường dẫn trang (web) hoặc lớp màn hình (ứng dụng) mà sự kiện được ghi lại.

2021-09-07 Các thay đổi về giản đồ API.

Thay đổi về phương diện hiện có:

  • unifiedPageScreen Đối với các sự kiện do web tạo, phương diện này hiện trả về đường dẫn trang và chuỗi truy vấn mà sự kiện được ghi lại.

Thông báo về những thay đổi sắp tới:

  • firstUserTrafficOrigin Nguồn gốc lưu lượng truy cập đầu tiên thu nạp được người dùng. Vui lòng không phụ thuộc vào trường này để trả về giá trị "Thủ công" cho lưu lượng truy cập sử dụng UTM; trường này sẽ cập nhật từ việc trả về giá trị "Thủ công" thành "(not set)" cho một lần ra mắt tính năng sắp tới.

  • sessionTrafficOrigin Nguồn gốc lưu lượng truy cập cho chiến dịch của phiên. Vui lòng không phụ thuộc vào trường này để trả về giá trị "Thủ công" cho lưu lượng truy cập sử dụng UTM; trường này sẽ cập nhật từ việc trả về giá trị "Thủ công" thành "(not set)" cho một lần ra mắt tính năng sắp tới.

  • trafficOrigin Nguồn gốc lưu lượng truy cập cho chiến dịch của sự kiện chuyển đổi. Vui lòng không phụ thuộc vào trường này để trả về giá trị "Thủ công" cho lưu lượng truy cập sử dụng UTM; trường này sẽ cập nhật từ việc trả về giá trị "Thủ công" thành "(not set)" cho một lần ra mắt tính năng sắp tới.

2021-09-07 Đã thêm phương thức checkCompatibility vào API.

checkCompatibility phương thức này liệt kê các phương diện và chỉ số có thể được thêm vào một yêu cầu báo cáo và duy trì khả năng tương thích.

Ngày 21/7/2021 Thay đổi về báo cáo theo thời gian thực.

Giờ đây, bạn có thể chỉ định phạm vi phút của dữ liệu sự kiện để đọc bằng cách sử dụng tham số minuteRanges của phương thức runRealtimeReport.

21/07/2021 Phương diện nhóm kênh mới.

Các phương diện nhóm kênh mới được thêm vào sơ đồ báo cáo Data API:

  • firstUserDefaultChannelGrouping Nhóm kênh mặc định có người dùng lần đầu.

  • defaultChannelGrouping Nhóm kênh mặc định.

10/06/2021 Các thay đổi về sơ đồ API.

  • Đã thêm phương diện minutesAgo vào giản đồ theo thời gian thực của Data API và có thể dùng trong các truy vấn cho phương thức runRealtimeReport. Phương diện này chứa số phút trước khi một sự kiện được thu thập. 00 là phút hiện tại và 01 là phút trước đó.

  • Đã thêm phương diện googleAdsCreativeId vào giản đồ Data API. Phương diện này chứa mã nhận dạng của mẫu quảng cáo trên Google Ads được phân bổ cho sự kiện chuyển đổi.

  • Đã thêm phương diện sessionGoogleAdsCreativeId vào giản đồ Data API. Phương diện này chứa mã nhận dạng của mẫu quảng cáo trên Google Ads dẫn đến một phiên hoạt động trên trang web hoặc ứng dụng của bạn.

  • Phương diện firstUserCreativeId được đổi tên thành firstUserGoogleAdsCreativeId trong giản đồ Data API. Phương diện này chứa mã nhận dạng của mẫu quảng cáo trên Google Ads đã thu nạp người dùng lần đầu tiên.

09/04/2021 API Dữ liệu Google Analytics phiên bản 1 (thử nghiệm) đã được phát hành.

  • Điểm cuối API được cập nhật thành https://analyticsdata.googleapis.com/v1beta.

  • Các phương thức runReport, runPivotReport, batchRunReports, batchRunPivotReports hiện chấp nhận mã nhận dạng của một tài sản Google Analytics 4 trong tham số property của đường dẫn URL thay vì trường entity của nội dung yêu cầu:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • Thư viện ứng dụng API đã được cập nhật để sử dụng điểm cuối API mới.

Ngày 19/2/2021 Thay đổi về phân trang.

  • Kích thước phản hồi mặc định của báo cáo đã tăng từ 10 lên 10.000 hàng dữ liệu sự kiện.

  • Giá trị "limit" : -1 được dùng để cho biết một nỗ lực truy xuất tất cả các hàng không còn được hỗ trợ trong RunReportRequest.

  • Giá trị tối đa của trường limit được đặt thành 100000. Sử dụng phân trang để truy xuất các báo cáo chứa hơn 100.000 hàng.

08/02/2021 Phương diện và chỉ số mới về thương mại điện tử.

Các phương diện và chỉ số thương mại điện tử mới đã được thêm vào sơ đồ API:

Kích thước: adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5 itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

Chỉ số: adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

08/02/2021 Đã thêm phương diện chiến dịch mới.

Các phương diện chiến dịch mới đã được thêm vào sơ đồ API: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

2021-02-08 Thay đổi về phương diện dayOfWeek, week.

  • Giá trị của phương diện dayOfWeek hiện bắt đầu bằng 0 thay vì 1.

  • Giá trị của phương diện week hiện bắt đầu bằng 01 và trả về một số có 2 chữ số từ 01 đến 53. Mỗi tuần bắt đầu từ Chủ Nhật. Ngày 1 tháng 1 luôn ở tuần 01.

2021-01-28 Thêm các biến thể tổng hợp cho chỉ số tuỳ chỉnh.

Mỗi chỉ số tuỳ chỉnh mà một tài sản đăng ký sẽ tạo ra 3 biến thể chỉ số API: tổng, giá trị trung bình và số lượng.

28/01/2021 Thêm phương diện Ngày/giờ mới.

Các phương diện mới sau đây đã được thêm vào sơ đồ API: hour, nthHour, nthYear, dateHour.

28/01/2021 Data API đã giảm số lượng mã thông báo hạn mức được tính cho mỗi truy vấn.

Data API đã giảm số lượng mã thông báo hạn mức được tính cho mỗi truy vấn. Hạn mức cho mã thông báo hạn mức tài sản mỗi giờ và mỗi ngày không thay đổi.

2020-11-09 Phương thức getUniversalMetadata đã bị xoá.

Phương thức getUniversalMetadata đã bị xoá. Vui lòng sử dụng getMetadata. Chúng tôi đã xoá phạm vi ngày tối đa là một năm cho mỗi yêu cầu API.

2020-11-02 Thêm một phương thức báo cáo theo thời gian thực.

Hãy xem phần Tạo báo cáo theo thời gian thực để biết ví dụ và runRealtimeReport để biết tài liệu tham khảo REST.

2020-10-19 Đã cập nhật các cấu phần phần mềm của thư viện ứng dụng.

Các cấu phần phần mềm của thư viện ứng dụng được cập nhật cùng với hướng dẫn sử dụng và mã mẫu.

13/10/2020 Thuộc tính Web và ứng dụng đã được đổi tên thành Google Analytics 4 (GA4).

2020-10-08 Đã thêm phương thức getMetadata vào API.

Phương thức getMetadata trả về Phương diện và chỉ số tuỳ chỉnh có sẵn cho mã tài sản GA4 được chỉ định, cũng như siêu dữ liệu Universal Analytics.

08/10/2020 Bạn có thể xem phương diện và chỉ số tuỳ chỉnh trong báo cáo.

Hãy xem tài liệu về giản đồ API để biết tài liệu về phương diện và chỉ số tuỳ chỉnh. Bản cập nhật này bao gồm Phương diện và chỉ số tuỳ chỉnh ở phạm vi sự kiện cũng như Phương diện tuỳ chỉnh ở phạm vi người dùng.