Google Analytics - Tất cả nhật ký thay đổi API cấu hình

Trang này ghi lại mọi thay đổi đối với API Cấu hình Google Analytics. Cấu hình này bao gồm nhật ký thay đổi cho API cấp phép và API quản lý. Nhà phát triển API nên kiểm tra định kỳ danh sách này để xem có thông báo mới nào không. Bạn cũng có thể đăng ký nhận thông tin về các thay đổi qua các nguồn cấp dữ liệu trong phần Đăng ký dưới đây.

Đăng ký nhật ký thay đổi liên quan

Tất cả nhật ký thay đổi của API Google Analytics
–
Đăng ký rss

Bao gồm tất cả các API thu thập, Cấu hình và Báo cáo.

Tất cả nhật ký thay đổi API cấu hình
–
Đăng ký rss

Bao gồm API quản lý và API cấp phép.

Đã thêm phương thức hashClientId vào API Quản lý

Phương thức hashClientId cung cấp hàm băm của một Mã ứng dụng khách nhất định. Bạn có thể tìm thấy dữ liệu này ở một số định dạng dữ liệu được xuất nhất định, chẳng hạn như trong dữ liệu Google Analytics được xuất sang BigQuery.

Chế độ cài đặt giữ lại dữ liệu người dùng trong API Quản lý

Giờ đây, bạn có thể định cấu hình theo phương thức lập trình các chế độ cài đặt giữ lại dữ liệu người dùng bằng cách sử dụng các trường "dataKeepTtl" và "dataTerritoryResetOnNewActivity" mới được thêm vào tài nguyên WebProperty.

Đây là bản phát hành đầu tiên của API Xoá người dùng:

  • API Xoá người dùng cho phép khách hàng Google Analytics xoá dữ liệu của một người dùng cuối cụ thể khỏi một dự án hoặc tài sản web. Bạn có thể thực hiện yêu cầu Xoá người dùng bằng dự án Firebase hoặc tài sản Google Analytics. Truy cập trang Tổng quan về API xoá người dùng để biết thêm thông tin chi tiết.

Thao tác ghi trong API Quản lý

Các hoạt động ghi trong API Quản lý (ví dụ: tạo, cập nhật, xóa, bản vá) cho Tài sản web, Chế độ xem (Hồ sơ) và Tài nguyên Mục tiêu không còn yêu cầu đưa vào danh sách trắng nữa. Giới hạn hằng ngày mặc định cho tất cả các thao tác ghi trong API Quản lý là 50 lượt ghi/ngày. Hãy xem trang Giới hạn và hạn mức để biết thêm thông tin.

Chỉ số tuỳ chỉnh

Đây là bản phát hành sửa lỗi; bản phát hành này khắc phục vấn đề không thể tạo Chỉ số tùy chỉnh thuộc loại TIME khi chưa đặt min_value. Các yêu cầu không có min_value hiện tạo chỉ số tùy chỉnh có min_value mặc định là 0.

Đơn vị tiền tệ

Đây là bản sửa lỗi; bản phát hành này khắc phục vấn đề một số đơn vị tiền tệ được hỗ trợ trong giao diện web Analytics nhưng không hỗ trợ trong API. Bản phát hành này hỗ trợ thêm các đơn vị tiền tệ sau:

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

Để biết thêm thông tin, hãy xem bài viết Tài liệu tham khảo về Chế độ xem (hồ sơ). – Bài viết Tham khảo đơn vị tiền tệ trong trung tâm trợ giúp.

Bản phát hành này thêm Đối tượng tái tiếp thị vào API Quản lý.

Thành phần tiếp thị lại

API Quản lý cho phép bạn create, get, list, update và patch đối tượng tái tiếp thị cho một tài sản Google Analytics. Để tìm hiểu thêm về cách đối tượng tái tiếp thị hoạt động, hãy xem bài viết Giới thiệu về Đối tượng tái tiếp thị trong Analytics trên trung tâm trợ giúp.

Báo cáo chưa được lấy mẫu

API báo cáo chưa được lấy mẫu không còn giới hạn 100 báo cáo mỗi ngày nữa. API sử dụng cùng một hệ thống mã thông báo mỗi tài sản, mỗi ngày như khi tạo báo cáo chưa được lấy mẫu thông qua giao diện web.

Báo cáo chưa được lấy mẫu

Người dùng hiện tại không thể truy cập vào những báo cáo chưa được lấy mẫu sẽ không còn đường liên kết để tải xuống bên trong thông báo phản hồi của API Quản lý. Hành vi này hiện đã phù hợp với chức năng của trang tổng quan giao diện người dùng, trong đó chỉ chủ sở hữu báo cáo mới có thể thấy đường liên kết tải xuống tài liệu được tạo.

Chế độ xem (Hồ sơ)

Bản phát hành này thêm thuộc tính botFilteringEnabled vào tài nguyên chế độ xem (hồ sơ). Thuộc tính này cho biết liệu tính năng lọc bot có được bật cho chế độ xem (hồ sơ) hay không. Hãy xem Tài liệu tham khảo về Chế độ xem (Hồ sơ) để biết thêm thông tin chi tiết.

Báo cáo chưa được lấy mẫu

Bản phát hành này thêm phương thức delete vào các báo cáo chưa được lấy mẫu. Xem tài liệu tham khảo về Xoá báo cáo chưa được lấy mẫu để biết thông tin chi tiết.

Phân đoạn

Đây là bản phát hành sửa lỗi. Bản phát hành này khắc phục vấn đề khiến các phân đoạn có giá trị đơn vị tiền tệ trong định nghĩa hiển thị không chính xác khi gọi phương thức danh sách phân đoạn.

Phân đoạn

Đây là bản phát hành sửa lỗi. Bản phát hành này khắc phục vấn đề khiến người dùng có phân khúc riêng tư được ghim vào nhiều chế độ xem (hồ sơ) nhận được phản hồi lỗi 500 khi gọi phương thức danh sách phân khúc.

Bản phát hành này bổ sung một tham số bổ sung vào URL cấp phép cho Điều khoản dịch vụ API:

  • Việc thêm tham số URL provisioningSignup=false sẽ khắc phục vấn đề xảy ra khi cấp phép tài khoản Google Analytics cho người dùng không có tài khoản Google Analytics nào. Nhà phát triển phải cập nhật mã nguồn để thêm tham số này vào URL của Điều khoản dịch vụ.

Tạo lô

Trong bản phát hành này, ngoài dịch vụ hỗ trợ hàng loạt nói chung, chúng tôi đã bổ sung tính năng hỗ trợ đặc biệt cho User Permissions API. Các yêu cầu Quyền người dùng theo lô sẽ giúp tăng hiệu suất đáng kể và giảm mức sử dụng hạn mức.

Chế độ xem (Hồ sơ)

Với bản phát hành này, thuộc tính Chế độ xem (Profile) currency giờ đây sẽ mặc định là USD nếu không được đặt trong thao tác insert. Ngoài ra, các thao tác get và list sẽ trả về USD trên các Chế độ xem (Hồ sơ) đã được tạo trước đó mà không có thuộc tính currency.

Bộ lọc

Bản phát hành này đánh dấu việc loại bỏ cuối cùng các trường bộ lọc không dùng nữa IS_MOBILE và IS_TABLET. Các trường này sẽ được thay thế bằng DEVICE_CATEGORY=mobile và DEVICE_CATEGORY=tablet. Các yêu cầu chèn, cập nhật và vá khi đặt các trường bộ lọc để sử dụng IS_MOBILE và IS_TABLET sẽ trả về lỗi.

Bộ lọc

Bản phát hành này hỗ trợ thêm việc sử dụng phương diện tuỳ chỉnh cho một trường bộ lọc bằng cách thêm thuộc tính fieldIndex vào tất cả các phần thông tin chi tiết về bộ lọc. Ví dụ: hiện bạn có thể đặt biểu thức lọc bằng "field": "CUSTOM_DIMENSION" và "fieldIndex": "1" để bộ lọc hoạt động trên phương diện tuỳ chỉnh đầu tiên.

Bàn thắng

Bản phát hành này cũng khắc phục vấn đề không tạo được mục tiêu bằng "comparisonValue": "0".

Bản phát hành này đánh dấu lần ngừng hoạt động cuối cùng và xoá tài nguyên dailyUpload. Tài nguyên dailyUpload chính thức ngừng hoạt động vào ngày 20 tháng 6 năm 2014; giờ đây, bạn phải thực hiện tất cả thao tác nhập dữ liệu chi phí bằng tài nguyên tải lên.

Bản phát hành này bổ sung hai tập hợp mới vào API Quản lý là Phương diện tuỳ chỉnh và Chỉ số tuỳ chỉnh.

Phương diện và số liệu tùy chỉnh

Giờ đây, bạn có thể tạo, liệt kê, nhận, vá cũng như cập nhật các Phương diện và chỉ số tuỳ chỉnh bằng API Quản lý.

Phản hồi của phương thức list cho tất cả tập hợp hiện bao gồm một danh sách trống cho thuộc tính items khi tập hợp không chứa tài nguyên nào. Trước đây, thuộc tính items sẽ bị bỏ qua trong phản hồi. Xem Tài liệu tham khảo API để biết đầy đủ chi tiết về các truy vấn và phản hồi cho dữ liệu cấu hình Google Analytics.

Bản phát hành này giới thiệu một phạm vi mới cho API Quản lý Google Analytics. – analytics.manage.users.readonly – Xem các quyền của người dùng trên Google Analytics.

Thêm trường DEVICE_CATEGORY filter (bộ lọc) mới, đồng thời ngừng sử dụng IS_MOBILE và IS_TABLET. Hãy sử dụng DEVICE_CATEGORY=mobile và DEVICE_CATEGORY=tablet.

Tài nguyên Chế độ xem (Hồ sơ) hiện bao gồm thuộc tính enhancedECommerceTracking cho biết liệu bạn đang bật (true) hay tắt tính năng Thương mại điện tử nâng cao (false).

Bản phát hành này bao gồm các loại nhập dữ liệu mới và ngừng sử dụng tài nguyên dailyUpload.

Nhập dữ liệu

Xem Hướng dẫn dành cho nhà phát triển nhập dữ liệu để biết chi tiết về cách sử dụng API quản lý để nhập dữ liệu vào tài khoản Google Analytics của bạn.

Video tải lên

  • Tài nguyên upload hiện hỗ trợ các loại tệp tải lên sau:
    • Dữ liệu chiến dịch
    • Dữ liệu nội dung
    • Dữ liệu chi phí
    • Dữ liệu sản phẩm
    • Dữ liệu tiền hoàn lại
    • Dữ liệu người dùng
  • Tài nguyên upload có phương thức migrateDataImport mới để di chuyển Dữ liệu chi phí hiện tại customDataSources.

Ngừng sử dụng tính năng tải lên hằng ngày

  • Tài nguyên dailyUpload hiện không được dùng nữa! Hãy xem Hướng dẫn di chuyển để biết chi tiết về cách di chuyển sang sử dụng tính năng Nhập dữ liệu.
  • Tài nguyên dailyUpload sẽ tiếp tục hoạt động trong 6 tháng nữa. Tại thời điểm đó, mọi customDataSources còn lại có thuộc tính uploadType được đặt thành analytics#dailyUploads sẽ tự động được di chuyển và chỉ hoạt động với tài nguyên upload.
  • Những người dùng hiện tại của tài nguyên dailyUpload phải cập nhật mã và chuyển sang sử dụng tài nguyên Tải lên sớm nhất có thể.

Đây là bản phát hành đầu tiên của API cấp phép:

  • Bạn có thể sử dụng API cấp phép để tạo tài khoản Google Analytics mới theo phương thức lập trình. API này chỉ dành cho những người được mời và dành cho các nhà cung cấp dịch vụ đủ điều kiện và các đối tác lớn. Hãy truy cập trang Tổng quan về API cấp phép để biết thêm thông tin chi tiết.

Bản phát hành này bổ sung 2 API cấu hình mới.

Bộ lọc

Báo cáo chưa được lấy mẫu: API Quản lý

Một tài nguyên mới đang được thêm vào API quản lý có tên là Báo cáo chưa được lấy mẫu. Báo cáo chưa được lấy mẫu là báo cáo của Google Analytics (GA) đã được tạo bằng cách sử dụng dữ liệu chưa được lấy mẫu.Hiện chỉ người dùng GA Premium mới có thể xem báo cáo chưa được lấy mẫu. 

Phân khúc: API Quản lý phiên bản 2.4 và v3.0

Những thay đổi sau đã được thực hiện cho Bộ sưu tập phân đoạn:

  • Phân khúc người dùng và phân khúc trình tự hiện được hỗ trợ trong API.
  • Bộ sưu tập phân đoạn hiện trả về tất cả phân đoạn cấp phiên và cấp người dùng được tích hợp sẵn và tùy chỉnh.
  • Giờ đây, thuộc tính definition cho phân đoạn sẽ sử dụng cú pháp phân đoạn mới. Điều này bao gồm định nghĩa cho phân đoạn cấp phiên hoạt động hiện tại sẽ thay đổi từ definition: "" thành definition: "sessions::condition::".
  • Một thuộc tính type mới đã được thêm vào tài nguyên Phân khúc để cho biết một phân khúc là CUSTOM (tức là do người dùng tạo trong giao diện web) hay BUILT_IN (tức là do Google Analytics cung cấp).

Thử nghiệm

Giờ đây, các chỉ số sau đây của AdSense có thể được dùng làm mục tiêu tối ưu hoá:

  • ga:adsenseAdsClicks — Số lần quảng cáo AdSense trên trang web của bạn đã được nhấp.
  • ga:adsenseAdsViewed — Số quảng cáo AdSense đã xem. Có thể hiển thị nhiều quảng cáo trong một Đơn vị quảng cáo.
  • ga:adsenseRevenue — Tổng doanh thu từ quảng cáo trên AdSense.

Những thay đổi sau đây đã được thực hiện đối với các phân đoạn mặc định do các phương diện ga:isMobile và ga:isTablet không còn được dùng:

  • Phân đoạn gaid::-11 đã được đổi tên từ Lưu lượng truy cập trên thiết bị di động thành Lưu lượng truy cập trên thiết bị di động và máy tính bảng. Định nghĩa cho phân đoạn này đã được thay đổi từ ga:isMobile==Yes thành ga:deviceCategory==mobile,ga:deviceCategory==tablet. Lưu ý rằng ga:isMobile bao gồm lưu lượng truy cập trên máy tính bảng, được phản ánh trong định nghĩa mới. Nếu bạn chỉ muốn lưu lượng truy cập trên thiết bị di động, không bao gồm máy tính bảng, hãy chuyển sang phân đoạn Lưu lượng truy cập trên thiết bị di động mới (gaid::-14).
  • Định nghĩa phân đoạn gaid::-13 đã thay đổi từ ga:isTablet==Yes thành ga:deviceCategory==tablet. Số liệu này tiếp tục biểu thị Lưu lượng truy cập trên máy tính bảng.
  • Thêm phân đoạn gaid::-14. Tên của phân đoạn là Lưu lượng truy cập trên thiết bị di động và định nghĩa là ga:deviceCategory==mobile.

Sửa lỗi:

  • Thông tin múi giờ cho chế độ xem (hồ sơ) đã được sửa. Chi tiết: Trước khi có bản sửa lỗi này, trong một số trường hợp khi chế độ xem danh sách (hồ sơ) trong API Quản lý, thông tin múi giờ không chính xác cho một chế độ xem (hồ sơ) đã bị trả về. Giờ đây, thông tin múi giờ cho chế độ xem (hồ sơ) đã nhất quán với thông tin được đặt trong giao diện quản trị của Google Analytics.

Bản phát hành này giới thiệu các thao tác ghi cho tài nguyên Thuộc tính web, Chế độ xem (Hồ sơ) và Mục tiêu, đồng thời bộ 3 tài nguyên mới cho phép quản lý Quyền người dùng.

API thiết lập và cấu hình tài khoản

Quyền của người dùng trong API Quản lý

Trong quá trình ra mắt phân khúc mới, chúng tôi sẽ triển khai những thay đổi sau cho Tập hợp phân khúc:

  • Tất cả Mã phân đoạn sẽ được thay đổi từ số nguyên dương thành chuỗi chữ và số. Nếu đã lưu Mã phân khúc của người dùng, bạn nên cập nhật các Mã phân khúc này để sử dụng Mã phân khúc mới.
  • Bộ sưu tập phân đoạn sẽ chỉ trả về phân đoạn cấp lượt truy cập hiện tại. API này hiện chưa hỗ trợ khách truy cập mới, nhóm thuần tập và phân khúc trình tự.
  • Bộ sưu tập phân đoạn sẽ tiếp tục trả về các phân đoạn mặc định hiện có có cùng ID số âm, tuy nhiên, phân đoạn mặc định mới hiện không được hỗ trợ.

Bản phát hành này thêm 2 thuộc tính mới vào Tài nguyên thuộc tính web:

  • profileCount – Trả về số lượng hồ sơ cho một thuộc tính. Điều này cho phép bạn lọc các thuộc tính không có bất kỳ tiểu sử nào (nghĩa là profileCount = 0).
  • industryVertical – Trả về ngành dọc/danh mục ngành đã chọn cho một thuộc tính.

Sửa lỗi:

  • Thuộc tính eCommerceTracking của Tài nguyên hồ sơ hiện nhất quán với các chế độ cài đặt Thương mại điện tử trong phần quản trị của giao diện web. Trả về true khi tính năng Theo dõi thương mại điện tử được bật và false nếu không bật.
  • Một điểm cuối mới đã được thêm vào API Quản lý phiên bản 3 để truy cập và sửa đổi các tài nguyên Thử nghiệm.
  • Tài nguyên hồ sơ hiện bao gồm một thuộc tính type để xác định xem một hồ sơ có được định cấu hình cho một Trang web hoặc Ứng dụng hay không. Hai giá trị có thể sử dụng là: WEB hoặc APP.

Bản phát hành này bổ sung các phản hồi hữu ích về lỗi cho API Quản lý.

  • Chúng tôi đã thêm các mã lỗi, lý do và nội dung mô tả mới vào phần nội dung của phản hồi lỗi API. Tất cả các mã đều đã được ghi lại cho cả hai phiên bản (Phiên bản 2.4 và Phiên bản 3.0) của API Quản lý.

Bản phát hành này bổ sung dữ liệu, thay đổi chức năng hiện có và sửa một lỗi.

Dữ liệu mới

  • Bộ sưu tập Phân đoạn nâng cao hiện chứa trường segmentId có thể được sử dụng trong tham số phân đoạn của API Xuất dữ liệu.

Các thay đổi

  • Loại dữ liệu của max-results đã được thay đổi thành integer.

  • Giá trị mặc định và tối đa của max-results đã được đổi thành 1000.

Sửa lỗi

  • Tài khoản, thuộc tính web và hồ sơ cho thử nghiệm Trình tối ưu hóa trang web của Google không còn được bao gồm trong các bộ sưu tập tương ứng của chúng.

Bản phát hành này bổ sung hai phiên bản API mới với nhiều tính năng mới và không dùng phiên bản cũ nữa. Những thay đổi này ảnh hưởng đến cách bạn yêu cầu và xử lý dữ liệu từ API.

Phiên bản 3.0

  • Đây là phiên bản lớn mới nhất của API và không có khả năng tương thích ngược. Mọi hoạt động phát triển API trong tương lai sẽ được thực hiện trên phiên bản này.

  • Dữ liệu mới

    • Bản trình bày đầy đủ các mục tiêu của sự kiện
    • Mã thuộc tính web nội bộ có thể được dùng để liên kết sâu đến giao diện người dùng GA
    • Cấu hình hồ sơ cho tham số truy vấn tìm kiếm trang và trang mặc định

  • Các thay đổi

Phiên bản 2.4

  • Đây là bản nâng cấp nhỏ và chủ yếu tương thích ngược với Phiên bản 2.3 hiện có.

  • Các thay đổi

    • Chính sách hạn mức mới
    • Tích hợp với Google API Console để quản lý quyền truy cập vào API và yêu cầu nâng hạn mức
    • Tiếp tục hỗ trợ các cơ chế uỷ quyền hiện tại và OAuth 2.0
    • URL mới để tạo yêu cầu: https://www.googleapis.com/analytics/v2.4/management/…
    • Chỉ phản hồi ở định dạng XML
    • Không hỗ trợ thư viện ứng dụng Google Data JavaScript
    • Đầu ra XML phù hợp với phiên bản 2.3, vì vậy, các thư viện ứng dụng khách hiện có khác của Google Data sẽ tiếp tục hoạt động.

Ngừng sử dụng

  • Chúng tôi xin thông báo về việc ngừng sử dụng phiên bản 2.3 cũ của API Quản lý. Nó sẽ tiếp tục hoạt động trong hai tháng, sau đó tất cả các yêu cầu v2.3 sẽ trả về phản hồi v2.4.

Đây là bản phát hành beta của API Quản lý Google Analytics!

Nguồn cấp dữ liệu mới

Thư viện ứng dụng mới cập nhật

  • API Quản lý đang được phát hành trong cùng một thư viện với API Xuất dữ liệu của Google Analytics. Cả thư viện Google Data Java và JavaScript đều đã được cập nhật. Bạn có thể truy cập mỗi nguồn cấp dữ liệu bằng cách chỉ định URI nguồn cấp dữ liệu thích hợp cho phương thức getManagementFeed() của thư viện.

Tài liệu mới

  • Một phần mới trong tài liệu dành cho nhà phát triển Google Analytics đã được tạo để mô tả cách hoạt động của API Quản lý mới.