Nhật ký thay đổi

Để nhận thông báo chính thức về API Google Analytics, hãy đăng ký tham gia Nhóm thông báo về API Google Analytics.

14/9/2026 Thêm tính năng hỗ trợ truy vấn trò chuyện trong phiên bản v1 alpha

Thêm phương thức properties.chat để tương tác với dữ liệu Google Analytics bằng các truy vấn ngôn ngữ tự nhiên.

  • Nội dung yêu cầu chấp nhận một câu hỏi, một mã phiên không bắt buộc để tiếp tục cuộc trò chuyện trước đó và một tham số returnPropertyQuota không bắt buộc.
  • Phản hồi trả về dữ liệu phản hồi có cấu trúc của cuộc trò chuyện trong các đối tượng ResponseBlock, mã phiên và thông tin chi tiết về hạn mức mã thông báo của tài sản bằng PropertyChatQuota nếu được yêu cầu.
  • Phạm vi OAuth https://www.googleapis.com/auth/analytics.chatbot.read cung cấp quyền đọc đối với phương thức properties.chat.

14/9/2026 Thêm lý do cắt bớt dữ liệu vào phản hồi báo cáo

Thêm trường dataTruncationReasons vào ResponseMetaData trong phiên bản v1 beta và v1 alpha. Khi dữ liệu của báo cáo bị cắt bớt, trường này sẽ bao gồm danh sách các đối tượng DataTruncationReason bao gồm loại cắt bớt, thông báo mô tả và ngày bị ảnh hưởng.

23/4/2026 Thêm tính năng hỗ trợ báo cáo lượt chuyển đổi trong phiên bản v1 alpha

Thêm tính năng hỗ trợ truy xuất dữ liệu từ báo cáo Hiệu suất lượt chuyển đổi bằng phương thức runReport trong Data API phiên bản 1 alpha. Nhờ đó, bạn có thể truy cập vào cùng một dữ liệu lượt chuyển đổi có trong giao diện người dùng Google Analytics trong mục Quảng cáo > Hiệu suất lượt chuyển đổi.

  • Thêm trường ConversionSpec vào RunReportRequest, cho phép lọc lượt chuyển đổi bằng conversionActions (mã hành động chuyển đổi) và chọn AttributionModel (DATA_DRIVEN hoặc LAST_CLICK).
  • Thêm trường Section vào ResponseMetaData để xác định xem dữ liệu trong báo cáo là từ báo cáo chuẩn (SECTION_REPORT) hay báo cáo lượt chuyển đổi (SECTION_ADVERTISING).

Cập nhật phương thức getMetadata trong Data API phiên bản 1 alpha để cung cấp thông tin cho báo cáo lượt chuyển đổi:

  • Thêm trường conversions vào phản hồi, trả về danh sách các đối tượng ConversionMetadata ánh xạ mã hành động chuyển đổi với tên hiển thị.
  • Thêm trường sections vào DimensionMetadata và MetricMetadata để xác định xem một trường cụ thể có tương thích với báo cáo chuẩn, báo cáo lượt chuyển đổi hay cả hai hay không.

20/10/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 Mức 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 các tài sản Google Analytics 360 có 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 để nhận kết quả không được lấy mẫu cho số lượng sự kiện lớn.

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

Bằng cách sử dụng phương thức properties.getPropertyQuotasSnapshot, bạn có thể nhận được thông tin tổng quan nhanh hiện tại về 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/6/2024 Thêm hạn mức "lỗi ứng dụng trên mỗi dự án trên mỗi tài sản"

Giờ đây, mỗi dự án, mỗi tài sản chỉ được phép có tối đa 10.000 lỗi phía 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 phản hồi có mã 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ả lỗi xác thực.

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

14/5/2024 Thêm tính năng So sánh

Khi 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 1beta đượ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 phép 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 cùng 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 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 phép so sánh trong yêu cầu, phản hồi sẽ chứa cột comparison xác định từng phép 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 nhiệm 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 v1alpha.

Khi sử dụng 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 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 tác vụ báo cáo sau đây đã được thêm vào Data API v1alpha:

6/5/2024 Các 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 để 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 thay đổi tương tự đối với mọi trường hợp sử dụng chỉ số sự kiện quan trọng cho một sự kiện quan trọng trong yêu cầu báo cáo của bạn.

Nội dung 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ố của 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, tên giao diện người dùng và nội dung mô tả của sự kiện chính.
  • 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 thủ công và các phương diện cụ thể cho 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 chế độ tích hợp CM360, DV360, SA360 đã được thêm vào lược đồ API của 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 một Đố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 Chiến dịch thủ công

  • manualCampaignName Tên chiến dịch thủ công

  • manualCreativeFormat Định dạng 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 thủ công

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

  • manualSourceMedium Nguồn/phương tiện được đặt 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 thủ công có người dùng lần đầu

  • firstUserManualCreativeFormat Định dạng mẫu quảng cáo 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 được đặt thủ công cho 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 thủ công dẫn đến phiên

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

  • sessionManualCreativeFormat Định dạng 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

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 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í 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 cho 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 có 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 cho 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í vị trí CM360 cho 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 quảng cáo trên 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 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í CM360 của phiên

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

  • sessionCm360SiteId Mã trang web 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

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 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 trên DV360

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

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

  • dv360LineItemName Tên mục hàng 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 cho người dùng lần đầu

  • firstUserDv360AdvertiserName Tên nhà quảng cáo DV360 cho 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ủa 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 hoạt động

  • sessionDv360CampaignName Tên chiến dịch DV360 của phiên hoạt động

  • 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 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 hoạt động

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

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

  • firstUserSa360AdGroupName Tên nhóm quảng cáo trên Search Ads 360 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 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 Search Ads 360 có người dùng lần đầu

  • firstUserSa360Query Cụm từ tìm kiếm trên Search Ads 360 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 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 quảng cáo trên SA360

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

  • sa360EngineAccountName Tên tài khoản công cụ trên Search Ads 360

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

  • 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 Search Ads 360

  • sa360Query Cụm từ tìm kiếm trên Search Ads 360

  • sa360Source Nguồn trên Search Ads 360

  • 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

6/3/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 cho việc xuất đối tượng người dùng không hoạt động. Người dùng được thêm vào những đố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ể được thêm vào đố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 không hoạt động trong 7 ngày qua", "Người dùng không hoạt động trong 7 ngày qua" và "Người dùng không nhận được thông báo trong 7 ngày qua". Để 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.

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ẻ.

Giờ đây, tính năng Xuất đối tượng sẽ trả về mã nhận dạng người dùng được chỉ định trong hoạt động gắn thẻ ngay cả khi tính năng dữ liệu do người dùng cung cấp được bật cho tài sản của bạn. 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 thu thập dữ liệu do người dùng cung cấp.

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/1/2024 Cải thiện khả năng tương thích cho các phương diện bao gồm chuỗi truy vấn hoặc thành phần phút.

Các phương diện bao gồm 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 bao gồm 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 trường bổ sung tương tự.

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

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

Giờ đây, bạn có thể đưa phương diện tuỳ chỉnh ở phạm vi mặt hàng vào các truy vấn Analytics Data API 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ương diện và chỉ số API để biết thêm thông tin.

Ngày 5 tháng 12 năm 2023 Danh sách đối tượng hiện có trong Data API phiên bản 1 thử nghiệm dưới dạng tệp xuất đối tượng

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 thử nghiệm.

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 phương pháp lấy mẫu khi dự đoán rằng hạn mức 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 v1 alpha

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

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

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

Chức năng xuất Danh sách đối tượng hiện hỗ trợ những đối tượng có thời hạn thành viên là 1 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 sẽ tuân theo các quy tắc sắp xếp thứ tự giống như các phương thức báo cáo khác của API dữ liệu: 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 sai
ABC sai
AAA true

Sau khi thay đổi này có hiệu lực, bạn sẽ nhận được báo cáo sau:

deviceId isAdsPersonalizationAllowed
AAA true
ABC sai
ABC true
DAC sai

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 Phương diện danh sách đối tượng.

15/8/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ị bằng tiền của khoản chiết khấu cho 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 tham số mặt hàng "discount".

Để tìm hiểu thêm, hãy xem Giản đồ báo cáo của API Dữ liệu.

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

  • isAdsPersonalizationAllowed Cho 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ề giá trị 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 Phương diện danh sách đối tượng.

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

Hỗ trợ Danh sách đối tượng được thêm 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 nhanh 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 đây đã được thêm vào Data API phiên bản 1 alpha:

Ngày 19 tháng 5 năm 2023 Nhóm kênh tuỳ chỉnh

Data API hiện đã hỗ trợ nhóm kênh tuỳ chỉnh.

11/5/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 để cho phép tính phí chính xác hơn.

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

Sau thay đổi này, mặc dù phí cho một số yêu cầu sẽ không đổi, nhưng phí cho các truy vấn phức tạp hơn sẽ tăng đáng kể. Ví dụ: các yêu cầu về dữ liệu trong hơn 6 tháng có thể tính phí 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 Hạn mức 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 chính cho mỗi tài sản mỗi giờ 5.000 40.000
Số mã thông báo chính 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 cho 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
Mã thông báo phễu trên mỗi tài sản mỗi giờ 5.000 40.000
Mã thông báo phễu cho 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 Hạn mức 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 chính cho mỗi tài sản mỗi giờ 50.000 400.000
Số mã thông báo chính 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 cho 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
Mã thông báo phễu trên mỗi tài sản mỗi giờ 50.000 400.000
Mã thông báo phễu cho 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. Ví dụ về giá trị bao gồm 01, 02 và 53.

  • isoYear năm 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. Ví dụ về giá trị 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. Ví dụ về giá trị: 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/2/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 trên 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 quá trình 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 cấp mặt hàng. Nếu bạn chỉ định tham số ở cả cấp sự kiện và cấp mặt hàng, thì tham số ở cấp mặt hàng sẽ được sử dụng.

21/2/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 không còn được dùng nữa và sẽ được cập nhật để không trả về chuỗi truy vấn kể từ ngày 14 tháng 5 năm 2023.

2023-01-28 Thêm các 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ố màn hình ứng dụng hoặc số trang trên trang web mà mỗi người dùng đang hoạt động đã xem. 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ố người dùng riêng biệt đã cuộn xuống ít nhất 90% trang.

23/1/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/1/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 dạ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.

18/10/2022 Thêm các chỉ số về Quảng cáo.

  • advertiserAdClicks 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í mỗi lượt chuyển đổi bằng chi phí quảng cáo chia cho số lượt chuyển đổi.
  • advertiserAdImpressions 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 các chỉ số ở phạm vi mặt hàng.

  • Đã thêm itemsAddedToCart mặt hàng 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ị được 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 cho một mặt hàng.
  • itemsViewed mục đã xem. Số đơn vị được 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ị được 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ị được xem trong chương trình khuyến mãi cho một mặt hàng.

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

Từ ngày 1 tháng 12 năm 2022, những thay đổi có thể gây lỗi sau đây sẽ có hiệu lực:

  1. Các phương diện ở phạm vi mặt hàng như itemName đang dầ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 sẽ 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 dầ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. Các phương diện bao gồm 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.

Ngày 1 tháng 9 năm 2022 Thay đổi về hạn mức.

  • Hạn mức Requests per day , Requests Per Minute, Requests Per Minute Per User đã bị xoá khỏi API Dữ liệu.

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

  • Mỗi yêu cầu đều sử dụng 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.

Ngày 3 tháng 8 năm 2022 Thêm các phương diện SA360 trong 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 dẫn đến phiên. 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 Search Ads 360 có phiên hoạt động. Mã tài khoản công cụ trong 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ụ trong SA360 đã dẫn đến phiên này.

  • sessionSa360EngineAccountType Loại tài khoản công cụ trên SA360 dẫn đến phiên. 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 của 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 thu nạp 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".

  • sessionCampaignId, sessionCampaignName hiện hỗ trợ các chiến dịch trên Search Ads 360.

11/7/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ó 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ố về 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, trả về 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 tháng 2 năm 2022 Thêm phương diện mới.

Cụm từ và nội dung 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 tham 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 tham 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 tham 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 tham 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 hoạt động. Được điền sẵn bằng tham số utm_content.

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

Phân tích sự cố

  • crashAffectedUsers Người dùng bị ảnh hưởng bởi sự cố. Số người dùng đã ghi lại 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) cho phiên của 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.

  • Trang đích của landingPage. Đườ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 số người dùng đang hoạt động đã mua hàng lần đầu.

  • 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 số 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 của 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 này.

Ngày 7 tháng 9 năm 2021 Thêm các 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 dưới dạng YYYYMMDDHHMM.

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

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

Ngày 7 tháng 9 năm 2021 Thêm các 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 của người chơi trong 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 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 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) nơi sự kiện được ghi lại.

2021-09-07 Thay đổi về lược đồ API.

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

  • unifiedPageScreen Đối với các sự kiện được tạo trên web, 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 đã thu nạp người dùng lần đầu. Vui lòng không dựa vào trường này để trả về giá trị "Manual" 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ị "Manual" thành trả về giá trị "(not set)" cho một tính năng sắp ra mắt.

  • sessionTrafficOrigin Nguồn gốc lưu lượng truy cập của chiến dịch trong phiên. Vui lòng không dựa vào trường này để trả về giá trị "Manual" 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ị "Manual" thành trả về giá trị "(not set)" cho một tính năng sắp ra mắt.

  • trafficOrigin Nguồn gốc lưu lượng truy cập của chiến dịch có sự kiện chuyển đổi. Vui lòng không dựa vào trường này để trả về giá trị "Manual" 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ị "Manual" thành trả về giá trị "(not set)" cho một tính năng sắp ra mắt.

Ngày 7 tháng 9 năm 2021 Đã thêm phương thức checkCompatibility vào API.

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

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/7/2021 Các 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 lược đồ báo cáo của 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.

Ngày 10 tháng 6 năm 2021 Thay đổi về lược đồ API.

  • Phương diện minutesAgo đã được thêm vào giản đồ theo thời gian thực của API Dữ liệu và có thể được dùng trong các truy vấn cho phương thức runRealtimeReport. Phương diện này cho biết 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 lược đồ API dữ liệu. 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 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 lược đồ 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.

2021-04-09 Google Analytics Data API 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

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

19/2/2021 Thay đổi về tính năng phân trang.

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

  • Giá trị "limit" : -1 dùng để cho biế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 tính năng phân trang để truy xuất báo cáo chứa hơn 100.000 hàng.

Ngày 8 tháng 2 năm 2021 Các 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 lược đồ API:

Phương diện: 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 các phương diện mới của chiến dịch.

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

08/02/2021 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ố gồm 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ố tùy chỉnh.

Mỗi chỉ số tùy chỉnh mà một tài sản đăng ký sẽ tạo ra ba biến thể chỉ số API: tổng, trung bình và số lượng.

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

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

2021-01-28 Data API giảm số lượng mã thông báo hạn mức được tính phí 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 phí cho mỗi truy vấn. Hạn mức về số lượng mã thông báo hạn mức của 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. Phạm vi ngày tối đa là một năm cho mỗi yêu cầu API đã bị xoá.

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

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

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

Cấu phần phần mềm 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 Tài sản web và ứng dụng đã được đổi tên thành Google Analytics 4 (GA4).

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

Phương thức getMetadata trả về các 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 chung.

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

Hãy xem tài liệu về lược đồ 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 các phương diện và chỉ số tuỳ chỉnh ở phạm vi sự kiện, cũng như các phương diện tuỳ chỉnh ở phạm vi người dùng.