Nhật ký thay đổi

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

28/06/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"

Hiện giới hạn 10.000 lỗi máy chủ API được phép cho mỗi dự án, mỗi thuộc tính, trong cửa sổ 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ã bất kỳ không phải là 500 hoặc 200. Ví dụ về các lỗi thuộc hạn mức này: sử dụng kế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 khác đến thuộc tính đó sẽ tạm thời bị chặn đối với dự án Google Cloud được liên kết cho đến khi hết khoảng thời gian 15 phút.

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

Khi sử dụng công cụ 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 chính của Data API phiên bản 1beta được cập nhật để hỗ trợ trường comparisons (khi được đưa vào) sẽ chỉ định cấu hình của các phép so sánh được yêu cầu.

Trong yêu cầu, bạn có thể chỉ định phép so sánh cơ bản bằng cách cung cấp biểu thức dimensionFilter thông qua yêu cầu, hoặc sử dụng 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ả các phép so sánh đã lưu có sẵn cho một thuộc tính 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.

2024-05-08 Thêm các 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 alpha.

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 với tác vụ báo cáo sau đây đã được thêm vào Data API phiên bản alpha:

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

Bạn hiện có thể sử dụng 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 được dùng nữa Chỉ số về 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 các yêu cầu báo cáo.

Phản hồi cho phương thức properties/getMetadata phản ánh việc ra mắt 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 tên API chuyển đổi không dùng nữa.

25/03/2024 Thêm nhóm kênh chính, nguồn lưu lượng truy cập thủ công và phương diện dành riêng cho chế độ 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 tích hợp CM360, DV360, SA360 được thêm vào giản đồ 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 của 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

Các 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 đượ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 được đặt thủ công theo người dùng lần đầu

  • firstUserManualCreativeFormat Định dạng mẫu quảng cáo được đặt thủ công theo 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 theo người dùng lần đầu

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

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

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

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

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

  • sessionManualCreativeFormat Định dạng quảng cáo được đặt thủ công theo 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 theo phiên

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

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

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

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

  • cm360AccountId mã tài khoản CM360

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

  • 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 trên CM360

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

  • cm360CreativeFormat định dạng 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 trên CM360

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

  • cm360PlacementId mã vị trí trên CM360

  • cm360PlacementName tên vị trí trên CM360

  • cm360RenderingId mã hiển thị trên CM360

  • cm360SiteId mã trang web trên CM360

  • cm360SiteName tên trang web trên CM360

  • cm360Source nguồn trên CM360

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

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

  • firstUserCm360AccountName Tên tài khoản CM360 có 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 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 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 có người dùng lần đầu

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

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

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

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

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

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

  • firstUserCm360Source Nguồn CM360 có 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 trên CM360 của phiên

  • sessionCm360CampaignName Tên chiến dịch trên 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 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 trên CM360 của phiên

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

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

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

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

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

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

  • sessionCm360Source Nguồn trê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 trên DV360

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

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

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

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

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

  • dv360LineItemId Mã mục hàng DV360

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

  • dv360Medium Phương tiện trên DV360

  • dv360PartnerId Mã đối tác DV360

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

  • dv360Source Nguồn trê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ó người dùng lần đầu

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

  • firstUserDv360CreativeFormat Định dạng 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ã nền tảng trao đổi quảng cáo DV360 có người dùng lần đầu

  • firstUserDv360ExchangeName Tên nền tảng trao đổi quảng cáo 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 trên DV360 có 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 trên DV360 của phiên

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

  • sessionDv360CreativeFormat Định dạng quảng cáo trên 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 trên DV360 của phiên

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

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

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

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

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

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

  • sessionDv360Medium Phương tiện trê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 trê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 SA360 có người dùng lần đầu

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

  • firstUserSa360CampaignId Mã chiến dịch trên SA360 có 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 quảng cáo trên SA360 có người dùng lần đầu

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

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

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

  • firstUserSa360KeywordText Văn bản từ khoá trên SA360 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 SA360 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 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 SA360

  • 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 SA360

  • sessionSa360AdGroupId Mã nhóm quảng cáo 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ý SA360 của 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 của phiên

2024-03-06 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 nhập những đối tượng này mà không cần một sự kiện đủ điều kiện; ví dụ: người dùng có thể nhập đố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", "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ề các đối tượng được đề xuất đó, hãy xem phần Đối tượng được đề xuất.

28/02/2024 Dữ liệu 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 tính năng gắn thẻ ngay cả khi 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 khi gắn thẻ để cải thiện hoạt động đ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 bản alpha Data API phiên bản 1.

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

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

18/01/2024 Cải thiện khả năng tương thích cho các 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 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 kích thước 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 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 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ể đưa các 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 Nội dung mô tả
customItem:parameter_name Phương diện tuỳ chỉnh ở phạm vi mặt hàng cho event_name

Xem các Phương diện và chỉ số API để biết thêm thông tin.

05/12/2023 Danh sách đối tượng đã có trong phiên bản thử nghiệm beta của Data API phiên bản 1 dưới dạng Dữ liệu 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à thêm vào phiên bản beta của Data API v1.

Thêm các phương thức sau vào bản thử nghiệm Data API v1:

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 từng 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 hoạt động lấy mẫu khi dự đoán rằng các 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 phiên bản alpha của Data API

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 API Dữ liệu.

Chức năng này cho phép bạn tạo danh sách đối tượng mỗi ngày khi thay đổi về gói thành viên Đối tượng. Danh sách Đối tượng định kỳ giúp đảm bảo bạn đang xử lý những kết quả mới nhất cho gói Đối tượng.

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

Thêm phương thức properties.audienceLists.exportSheet vào Data API phiên b���n 1 alpha để cho phép bạn xuất Danh sách đối tượng sang Google Trang tính.

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

Các đối tượng có thời hạn thành viên là 1 ngày hiện được chức năng xuất Danh sách đối tượng hỗ trợ.

12/09/2023 Các quy tắc sắp xếp mặc định của danh sách đối tượng

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 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ẽ được 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 đúng
DAC false
ABC false
AAA đúng

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

deviceId isAdsPersonalizationAllowed
AAA đúng
ABC false
ABC đúng
DAC false

15-08-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ể 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-08-2023 Đã thêm phương diện currencyCode, chỉ số itemDiscountAmount

  • currencyCode Mã nội tệ (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 việc 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 bằng cách gắn thẻ theo thông số mặt hàng "discount".

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

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

  • isAdsPersonalizationAllowed Có được phép cá nhân hoá quảng cáo không. Nếu người dùng đủ điều kiện sử dụng chế độ cá nhân hoá quảng cáo, 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 Phương diện danh sách đối tượng.

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

Đã thêm tuỳ chọn hỗ trợ cho Danh sách đối tượng vào phiên bản alpha của Data API. Danh sách đối tượng cung cấp thông tin tổng quan nhanh về người dùng thuộc đố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 phiên bản alpha của Data API:

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

Đã thêm tính năng hỗ trợ Nhóm kênh tuỳ chỉnh 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 để cho phép 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 cho phù hợp với thay đổi về hạn mức và được cân bằng lại theo cách cho phép 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í nhiều mã thông báo hạn mức hơn đáng kể cho các báo cáo có ngày lớn.

Sau thay đổi này, mặc dù mức phí cho một số yêu cầu vẫn giữ nguyên, nhưng mức phí đối với các truy vấn phức tạp hơn sẽ tăng đáng kể. Ví dụ: các yêu cầu trong hơn 6 tháng dữ liệu 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 Giới hạn cũ Giới hạn mới
Số mã thông báo cốt lõi trên mỗi tài sản mỗi ngày 25.000 200.000
Số mã thông báo cốt lõi mỗi tài sản mỗi giờ 5.000 40.000
Số mã thông báo cốt lõi của mỗi dự án/tài sản mỗi giờ 1.750 14.000
Số mã thông báo theo thời gian thực trên 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 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 trên mỗi dự án/tài sản mỗi giờ 1.750 14.000
Số mã thông báo của kênh trên mỗi tài sản mỗi ngày 25.000 200.000
Số mã thông báo của phễu mỗi tài sản mỗi giờ 5.000 40.000
Số mã thông báo của phễu mỗi dự án/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ũ Giới hạn mới
Số mã thông báo cốt lõi trên 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 mỗi tài sản mỗi giờ 50.000 400.000
Số mã thông báo cốt lõi của mỗi dự án/tài sản mỗi giờ 17.500 140.000
Số mã thông báo theo thời gian thực trên 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 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 trên mỗi dự án/tài sản mỗi giờ 17.500 140.000
Số mã thông báo của kênh trên mỗi tài sản mỗi ngày 250.000 2.000.000
Số mã thông báo của phễu mỗi tài sản mỗi giờ 50.000 400.000
Số mã thông báo của phễu mỗi dự án/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ị Sunday, Monday, v.v.

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

  • isoYear năm ISO. Năm ISO diễn ra sự kiện. Để biết thông tin chi tiết, hãy truy cập vào https://en.wikipedia.org/wiki/ISO_week_date. Các 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. Các 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. Các 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. Các giá trị mẫu bao gồm 202253 hoặc 202301.

2023-02-27 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 bằng cách gắn thẻ theo thông số "index" trong mảng items.

  • itemLocationID Mã vị trí mặt hàng. Vị trí thực tế của mặt hàng này (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ục đượ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 thông tin gắn thẻ theo 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 khuyến mãi liên kết với mặt hàng. Bạn có thể chỉ định phương diện này khi gắn thẻ bằng thông số creative_slot ở cấp sự kiện hoặc mặt hàng. Nếu thông số này đượ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 cụm từ tìm kiếm".

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

Trường này thay thế phương diện landingPage 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 các chỉ số "Số lượt xem trên mỗi người dùng", "S�� người dùng đã cuộn".

  • screenPageViewsPerUser lượt xem trên mỗi người dùng. Số màn hình ứng dụng hoặc số trang trong 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 cuộn xuống ít nhất 90% của trang.

23/01/2023 Thêm phương diện "Châu lục" và "Mã nhận dạng lục địa".

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

  • continentId Mã châu lục. Mã địa lý của châu lục nơi hoạt động của người dùng bắt nguồn, đượ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 dạng số của 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 https://support.google.com/analytics/answer/10108813.

18-10-2022 Đã thêm chỉ số quảng cáo.

  • advertiserAdClicks lượt nhấp vào Google Ads. 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 Giá mỗi lượt chuyển đổi. Chi phí mỗi lượt chuyển đổi là 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 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.
  • Đã thanh toán itemsCheckedOut mặt hàng. Số đơn vị được thanh toán cho một mặt hàng.
  • Đã nhấp vào itemsClickedInList mặt hàng 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.
  • Đã nhấp vào itemsClickedInPromotion mặt hàng 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.
  • Đã xem itemsViewed mặt hàng. Số đơn vị được xem cho một mặt hàng.
  • Có itemsViewedInList 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 mặt hàng được xem trong chương trình khuyến mãi. Số đơn vị được xem trong chương trình khuyến mãi cho một mặt hàng.

13/09/2022 Thông báo về những thay đổi đối với khả năng tương thích với 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ẽ 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 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 hoạt động 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. Phương diện phân bổ sẽ vẫn tương thích với các chỉ số phân bổ như conversions, chỉ số dựa trên người dùng như activeUsers và các chỉ số dựa trên phiên hoạt động như sessions.

  3. Những phương diện bao gồm chuỗi truy vấn như pagePathPlusQueryString sẽ chỉ tương thích với một nhóm phương diện và chỉ số có giới hạn.

Để tìm hiểu thêm, hãy xem nội dung giải thích chi tiết về những thay đổi đối với khả năng tương thích.

01/09/2022 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 sẽ sử dụng hạn mức cho cả Tokens Per Property Per Hour và Tokens Per Project Per Property Per Hour.

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

2022-08-03 Đã thêm các phương diện SA360 trong phạm vi phiên hoạt động.

  • 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 SA360 của 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 của 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 của phiên. 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 Search Ads 360 có phiên hoạt động. 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 Search Ads 360 có phiên hoạt động. Loại tài khoản công cụ trong 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 của phiên. Từ khoá trên công cụ tìm kiếm trên Search Ads 360 đã dẫn đến phiên này.

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

  • sessionSa360Query Truy vấn 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 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".

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

11/07/2022 Thêm 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 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.

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

  • Phương thức này được giới thiệu ở độ ổn định alpha nhằm thu thập ý kiến phản hồi về cú pháp và các chức năng trước khi chuyển sang giai đoạn thử nghiệm beta. Vui lòng hoàn tất bài viết 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.

16-02-2022 Đã thêm phương diện mới.

Điều khoản và nội dung được tạo thủ công

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

  • firstUserManualTerm Từ khoá được đặt thủ công theo người dùng lần đầu. Cụm từ đầu tiên thu nạp người dùng. Đượ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. Từ khoá đượ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 có phiên hoạt động. 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 theo 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 Người dùng bị ảnh hưởng bởi sự cố. Số lượng người dùng đã ghi lại sự cố trong hàng báo cáo này.

  • 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 của người dùng.

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

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

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

Ứ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 về số người dùng đang hoạt động trong 30 ngày cũng là người dùng hoạt động trong 1 ngày.

  • dauPerWau Số người dùng hoạt động hằng ngày (DAU)/Số người dùng hoạt động hằng ngày (WAU). Tỷ lệ phần trăm luân phiên về số người dùng đang 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 số người dùng đang 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ố lượt 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 đầu tiên thu nạp người dùng.

  • 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 cho chiến dịch trên Google Ads đã dẫn đến phiên này.

07/09/2021 Đã thêm các phương diện Ngày/giờ mới.

  • dateHourMinute Các 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ừ thời điểm bắt đầu phạm vi ngày.

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

  • achievementId Mã thành tích trong một trò chơi của 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 của một sự kiện.

  • linkClasses Thuộc tính lớp HTML 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 mã HTML cho một đường liên kết ra ngoài hoặc tệp tải xuống.

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

  • linkUrl URL đầy đủ cho 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ề giá trị "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 của các trang web đã truy cập.

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

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

  • searchTerm Cụm từ do 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 xuất hiện.

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

07/09/2021 Thay đổi giản đồ API.

Thay đổi đối với 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 nhật ký.

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

  • firstUserTrafficOrigin Nguồn lưu lượng truy cập đầu tiên thu nạp người dùng. Vui lòng không phụ thuộc vào trường này. Trường này sẽ trả về "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ừ trả về "Thủ công" thành trả về "(not set)" cho lần ra mắt tính năng sắp tới.

  • sessionTrafficOrigin Nguồn lưu lượng truy cập của chiến dịch của phiên. Vui lòng không phụ thuộc vào trường này. Trường này sẽ trả về "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ừ trả về "Thủ công" thành trả về "(not set)" cho lần ra mắt tính năng sắp tới.

  • trafficOrigin Nguồn 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ường này sẽ trả về "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ừ trả về "Thủ công" thành trả về "(not set)" cho lần ra mắt tính năng sắp tới.

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

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

21/07/2021 Thay đổi đối với báo cáo theo thời gian thực.

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

21/07/2021 Các phương diện mới dành cho nhóm kênh.

Các phương diện nhóm kênh mới được thêm vào giản đồ 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/6/2021 Thay đổi về giản đồ API.

  • Phương diện minutesAgo được thêm vào giản đồ theo thời gian thực Data API và có thể dùng trong các truy vấn tới 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 có nghĩa 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 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 Chúng tôi đã phát hành phiên bản beta của Google Analytics Data API v1.

  • Đã cập nhật điểm cuối của API lên 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 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.

19/02/2021 Thay đổi về cách 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 dùng để cho biết thao tác truy xuất tất cả hàng không còn được hỗ trợ trong RunReportRequest nữa.

  • Giá trị lớn nhất 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.

08/02/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 giản đồ 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 chiến dịch mới đã được thêm vào giản đồ API: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

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

  • 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ó hai chữ số từ 01 đến 53. Mỗi tuần bắt đầu vào Chủ Nhật. Ngày 1 tháng 1 luôn ở tuần 1.

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

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

28/01/2021 Đã 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 giản đồ API: hour, nthHour, nthYear, dateHour.

28/01/2021 Data API đã giảm hạn mức mã thông báo được tính cho mỗi cụm từ tìm kiếm.

Data API đã giảm 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.

09-11-2020 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 trong một năm cho mỗi yêu cầu API.

02-11-2020 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 để xem ví dụ và xem bài viết runRealtimeReport để tham khảo tài liệu tham khảo REST.

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: Thuộc tính 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 đã chỉ định, cũng như siêu dữ liệu Universal.

08/10/2020 Các phương diện và chỉ số tuỳ chỉnh đã có trong báo cáo.

Xem tài liệu về giản đồ API để biết tài liệu về các 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ư Phương diện tuỳ chỉnh ở phạm vi người dùng.