Nhật ký thay đổi

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

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.

Ngày 15 tháng 10 năm 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 cấp độ 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 tháng 9 năm 2024 Thêm tính năng Ảnh chụp nhanh về 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ể xem thông tin tổng quan nhanh hiện tại về tất cả hạn mức cơ sở lưu trú được sắp xếp theo danh mục hạn mức cho một cơ sở lưu trú nhất định.

Ngày 28 tháng 6 năm 2024 Thêm hạn mức "lỗi ứng dụng khách trên mỗi dự án trên mỗi tài sản"

Hiện tại, mỗi dự án, 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 phản hồi bằng 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ả 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ẽ bị tạm thời chặn cho dự án Google Cloud được liên kết cho đến khi kết thúc khoảng thời gian 15 phút.

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 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 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 phép 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 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 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 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 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 tác vụ báo cáo sau đây đã được thêm vào Data API v1alpha:

Ngày 6 tháng 5 năm 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 để 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 trường hợp 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 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 đố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 còn được dùng nữa.

Ngày 25 tháng 3 năm 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ể về 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ể được thêm vào giản đồ API Dữ liệu.

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 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 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 có 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

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í 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 của 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ủa 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í 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 cho 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 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í trên 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 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 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 cho 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 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 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ủ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 có 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 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 trên SA360 có người dùng lần đầu

  • sa360AdGroupId Mã nhóm quảng cáo 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 Truy vấn 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ý 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

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ẽ được đưa 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 đưa vào đối tượng này 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ề những đối tượng được đề xuất đó, hãy xem bài viết Đối tượng được đề xuất.

Ngày 28 tháng 2 năm 2024 Tệp xuất đối tượng trả về mã nhận dạng người dùng được chỉ định trong quá trình 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 Mã nhận dạng người dùng 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 tháng 1 năm 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 alpha 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 (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.

Ngày 18 tháng 1 năm 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 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 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 các 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.

Ngày 13 tháng 12 năm 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 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ần 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 có sẵn trong Data API phiên bản 1 beta 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 Dữ liệu xuất đối tượng và được thêm vào Data API phiên bản thử nghiệm beta 1.

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

Ngày 28 tháng 11 năm 2023 Thêm samplingMetadatas để báo cáo phản hồi

Thêm samplingMetadatas vào ResponseMetaData. Bộ sưu tậ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 chỉ áp dụng tính năng lấy mẫu khi dự đoán rằng các 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.

Ngày 28 tháng 11 năm 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 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 sử dụng kết quả mới nhất về Thành viên đối tượng.

Ngày 8 tháng 11 năm 2023 Thêm chức năng xuất Danh sách đối tượng sang Sheets vào Data API v1 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.

Ngày 13 tháng 10 năm 2023 Hỗ trợ thêm Đố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ợ đối tượng có thời hạn thành viên là 1 ngày.

Ngày 12 tháng 9 năm 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 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 đúng
DAC false
ABC false
AAA đúng

Sau khi 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

Ngày 15 tháng 8 năm 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 Kích thước danh sách đối tượng.

Ngày 15 tháng 8 năm 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 của khoản 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 quá trình gắn thẻ bằng thông số mặt hàng "discount".

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

Ngày 10 tháng 8 năm 2023 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, thì isAdsPersonalizationAllowed sẽ trả về true. Nếu người dùng không đủ điều kiện sử dụng tính năng 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 Kích thước danh sách đối tượng.

Ngày 10 tháng 7 năm 2023 Danh sách đối tượng

Thêm tính năng hỗ trợ Danh sách đối tượng vào Data API v1 alpha. Danh sách đối tượng bao gồm thông tin tổng quan nhanh về những 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

Thêm tính năng hỗ trợ Nhóm kênh tuỳ chỉnh vào Data API.

Ngày 11 tháng 5 năm 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 thay đổi về hạn mức và được cân bằng lại để cho phép nhiều truy vấn báo cáo đơn giả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 khi thay đổi này, mặc dù phí cho một số yêu cầu sẽ giữ nguyên, nhưng phí cho các truy vấn phức tạp hơn sẽ tăng lên đá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í 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ũ 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 trên mỗi tài sản mỗi giờ 5.000 40.000
Số mã thông báo cốt lõi trên mỗi dự án, trê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 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 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 trên 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 trên 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, trê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ũ 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 trên mỗi tài sản mỗi giờ 50.000 400.000
Số mã thông báo cốt lõi trên mỗi dự án, trê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 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 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 trên 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 trên 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, trên mỗi tài sản, mỗi giờ 17.500 140.000

Ngày 2 tháng 3 năm 2023 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 từ 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 theo ISO isoYear. 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. 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.

Ngày 27 tháng 2 năm 2023 Thêm các 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 tham 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 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 quá trình gắn thẻ bằng tham số creative_slot ở cấp sự kiện hoặc cấp 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.

Ngày 21 tháng 2 năm 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.

Ngày 28 tháng 1 năm 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ố màn hình ứng dụng hoặc số trang trên 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 đã cuộn. Số lượng người dùng riêng biệt đã cuộn xuống ít nhất 90% trang.

Ngày 23 tháng 1 năm 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 châu lục 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ọ.

Ngày 23 tháng 1 năm 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 tháng 10 năm 2022 Thêm các chỉ số của Google Ads.

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

Ngày 17 tháng 10 năm 2022 Thêm các chỉ số ở phạm vi mặt hàng.

  • itemsAddedToCart Đã thêm 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 Các mặt hàng đã được thanh toán. Số lượng đơ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 của một mặt hàng.
  • itemsViewed Số mặt hàng được xem. Số lượng đơ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ị đượ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 của một mặt hàng.

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

Kể 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 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 sẽ 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 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. Các phương diện phân bổ sẽ vẫn 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 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.

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

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 sẽ 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 sẽ 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 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 mẫu quảng cáo trên SA360 của phiên. Loại mẫu quảng cáo trong 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 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 trong 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 trong Search Ads 360 đã dẫn đến phiên này. Ví dụ: "chi phí mỗi lượt nhấp".

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

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

Ngày 11 tháng 7 năm 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 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ể.

Ngày 5 tháng 5 năm 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 sẽ 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 tháng 2 năm 2022 Thêm các phương diện mới.

Thuật ngữ 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 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. Đượ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ừ đượ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 dẫn đến 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 của người dùng.

  • newVsReturning Người dùng mới / 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 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 người dùng đang hoạt động đã thực hiện 1 giao dịch mua 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 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 Số phút gồm hai chữ số của giờ mà sự kiện được ghi lại.

  • nthMinute Số phút kể từ khi 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ã 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 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 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ã nhận dạng 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 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 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 được 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.

Ngày 7 tháng 9 năm 2021 Thay đổi về 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 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 đã thu nạp người dùng lần đầu. 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 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 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 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ủ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 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.

Phương thức 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.

Ngày 21 tháng 7 năm 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ần đọc bằng cách sử dụng thông số minuteRanges của phương thức runRealtimeReport.

Ngày 21 tháng 7 năm 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 giản đồ báo cáo API dữ liệu:

  • firstUserDefaultChannelGrouping Nhóm kênh mặc định của 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ề giản đồ 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 sử dụng trong các truy vấn đến 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ã 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ã 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 Google Ads đã thu nạp người dùng lần đầu.

Ngày 9 tháng 4 năm 2021 Phát hành phiên bản thử nghiệm của API Dữ liệu Google Analytics phiên bản 1.

  • Điểm cuối của 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 tài sản Google Analytics 4 trong thông 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 tháng 2 năm 2021 Thay đổi về 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 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 tính năng phân trang để truy xuất các báo cáo chứa hơn 100.000 hàng.

Ngày 8 tháng 2 năm 2021 Ra mắt các phương diện và chỉ số thương mại điện tử mới.

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:

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.

Ngày 8 tháng 2 năm 2021 Thêm các 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 giản đồ API: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

Ngày 8 tháng 2 năm 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 hai 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.

Ngày 28 tháng 1 năm 2021 Thêm biến thể tổng hợp cho các 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, trung bình và số lượng.

Ngày 28 tháng 1 năm 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 giản đồ API: hour, nthHour, nthYear, dateHour.

Ngày 28 tháng 1 năm 2021 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 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.

Ngày 9 tháng 11 năm 2020 Xoá phương thức getUniversalMetadata.

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

Ngày 2 tháng 11 năm 2020 Thêm 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.

Ngày 19 tháng 10 năm 2020 Cập nhật cấu phần phần mềm 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.

Ngày 13 tháng 10 năm 2020 Tài sản web và ứng dụng đã được đổi tên thành Google Analytics 4 (GA4).

Ngày 8 tháng 10 năm 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.

Ngày 8 tháng 10 năm 2020 Phương diện và chỉ số tuỳ chỉnh có trong báo cáo.

Hãy 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.