Search Ads 360 Reporting API dựa trên một nền tảng hiện đại và ra mắt một số khái niệm mới. Các khái niệm này được mô tả trong các phần sau.
Tài nguyên
Đối tượng tài nguyên thay thế các loại báo cáo. Thay vì yêu cầu các loại báo cáo được xác định trước, giờ đây, bạn có thể truy vấn tất cả tài nguyên bằng một ngôn ngữ truy vấn mới tương tự như SQL. Hãy xem bài viết Cấu trúc Search Ads 360 Reporting API để tìm hiểu thêm.
Báo cáo tìm kiếm
Tìm kiếm có dịch vụ riêng trong API mới. Dịch vụ Tìm kiếm thay thế dịch vụ Báo cáo cũ. Tất cả truy vấn đều đi qua
SearchAds360Service
cung cấp 2 phương thức là SearchStream và Search để tìm kiếm và
truy xuất dữ liệu báo cáo và chỉ số. Cả hai phương thức tìm kiếm đều trả về tất cả đối tượng SearchAds360Row khớp với truy vấn tìm kiếm của bạn. Xem bài viết
Tạo báo cáo tìm kiếm để biết thêm thông tin.
Siêu dữ liệu tài nguyên
SearchAds360FieldService
cho phép bạn yêu cầu động danh mục tài nguyên, trường tài nguyên, khoá phân khúc và chỉ số có trong các phương thức tìm kiếm SearchAds360Service. Xem bài viết Truy xuất siêu dữ liệu tài nguyên để tìm hiểu
thêm.
Tên trường
API này giới thiệu tên trường lồng nhau được phân tách bằng ký hiệu dấu chấm. Ví dụ: campaign.id và ad_group.id. Bạn cũng có thể lồng sâu hơn, ví dụ: ad_group.campaign.id. Hãy xem
bài viết Cấu trúc Search Ads 360 Reporting API để tìm hiểu
thêm.
Báo cáo trong Search Ads 360 API cũ dựa trên các trường riêng biệt trên các thực thể khác nhau cho các khái niệm tương tự. Ví dụ: cả báo cáo
campaign và
adgroup đều có một trường
campaignId riêng biệt.
Ngôn ngữ truy vấn
API này giới thiệu Ngôn ngữ truy vấn Search Ads 360. Đây là một ngôn ngữ linh hoạt, tương tự như SQL, cho phép bạn xác định các truy vấn để truy xuất dữ liệu báo cáo cụ thể phù hợp nhất với doanh nghiệp của bạn. Xem Ngôn ngữ truy vấn Search Ads 360 để tìm hiểu thêm.
Yêu cầu GET
Trong API mới, tìm kiếm có dịch vụ riêng (SearchAds360Service), nhưng các yêu cầu GET vẫn tồn tại trên dịch vụ cụ thể của từng thực thể. Ví dụ: bạn có thể lấy
thông tin về cột tuỳ chỉnh từ
CustomColumnService.
Xem
Các thay đổi về định dạng trong Search Ads 360 Reporting API
để tìm hiểu thêm.
Cột tuỳ chỉnh
Trong Search Ads 360 mới, cột công thức và lượt chuyển đổi tuỳ chỉnh được gọi là cột tuỳ chỉnh.
Tìm hiểu thêm về cột tuỳ chỉnh.
Mới
CustomColumnService
cho phép sử dụng cột tuỳ chỉnh. Miễn là bạn có các quyền cần thiết, bạn có thể yêu cầu các tài nguyên CustomColumn do bất kỳ tài khoản nào trong cây tài khoản sở hữu.
Quản lý tài khoản
Search Ads 360 mới sắp xếp các tài khoản theo hệ phân cấp gồm tài khoản người quản lý, tài khoản người quản lý phụ và tài khoản khách hàng. Tài khoản người quản lý là tài khoản đại lý, còn tài khoản người quản lý phụ là tài khoản nhà quảng cáo trong Search Ads 360 cũ. Xem bài viết Giới thiệu về tài khoản người quản lý Search Ads 360 để tìm hiểu thêm.
Bạn có thể truy vấn cây tài khoản rồi gửi yêu cầu cho từng tài khoản mà bạn muốn lấy dữ liệu báo cáo.
Do thay đổi trong hệ phân cấp tài khoản, các trường liên quan đến khái niệm nhà quảng cáo/đại lý đã được thay thế bằng các lựa chọn thay thế phù hợp để cung cấp tính tương đương về chức năng ở bất cứ nơi nào có thể. Xem bài viết Ánh xạ trường để biết danh sách các trường bị ảnh hưởng và trường thay thế.
Tiêu đề mã khách hàng đăng nhập
login-customer-id là một tiêu đề mới bắt buộc khi sử dụng tài khoản người quản lý để truy cập vào tài khoản người quản lý phụ hoặc tài khoản khách hàng. Xem
bài viết Tiêu đề mã khách hàng đăng nhập
để biết thêm thông tin.
Lập phiên bản
Search Ads 360 Reporting API sử dụng
tính năng lập phiên bản ngữ nghĩa. Có các phiên bản chính và phụ,
được định dạng là vMAJOR_MINOR. Xem bài viết
Lập phiên bản để tìm hiểu thêm.