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 loại này được mô tả trong các phần sau.
Tài nguyên
Đối tượng tài nguyên thay thế 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 cách sử dụng ngôn ngữ truy vấn mới giống SQL. Hãy xem cấu trúc API Báo cáo Search Ads 360 để 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 phải thông qua SearchAds360Service. Phương thức này cung cấp hai phương thức là SearchStream và Search để tìm kiếm và truy xuất dữ liệu báo cáo cũng như các 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 cụm từ tìm kiếm của bạn. Hãy 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 linh động yêu cầu danh mục cho tài nguyên, trường tài nguyên, khoá phân đoạn và chỉ số có trong các phương thức tìm kiếm SearchAds360Service. Hãy xem phần Truy xuất siêu dữ liệu tài nguyên để tìm hiểu thêm.
Tên trường
API 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 thêm, ví dụ: ad_group.campaign.id. Hãy xem cấu trúc API Báo cáo Search Ads 360 để tìm hiểu thêm.
Tính năng báo cáo trong API Search Ads 360 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 ra mắt Ngôn ngữ truy vấn Search Ads 360. Đây là một ngôn ngữ linh hoạt giống 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 mình. Hãy xem bài viết Ngôn ngữ truy vấn Search Ads 360 để tìm hiểu thêm.
Nhận yêu cầu
Trong API mới, hoạt động 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 từng 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. Hãy xem bài viết Thay đổi về định dạng trong API Báo cáo Search Ads 360 để tìm hiểu thêm.
Cột tùy 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. CustomColumnService mới cho phép các 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 tài nguyên CustomColumn do bất kỳ tài khoản nào sở hữu trong
cây tài khoản.
Quản lý tài khoản
Search Ads 360 mới sắp xếp các tài khoản theo hệ thống 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ụ đại diện cho tài khoản nhà quảng cáo trong Search Ads 360 cũ. Hãy 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 báo cáo dữ liệu.
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/công ty quảng cáo đã được thay thế bằng các phương án thay thế thích hợp để cung cấp tính tương đồng về chức năng bất cứ khi nào có thể. Hãy xem phần Liên kết 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. Hãy xem phần 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 phiên bản ngữ nghĩa.
Có các phiên bản chính và phiên bản phụ, được định dạng là vMAJOR_MINOR. Hãy xem phần Tạo phiên bản để tìm hiểu thêm.