API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.

Trang này được dịch bởi Cloud Translation API.

Cấu trúc API Báo cáo của Search Ads 360

Thành phần chính của API Báo cáo Search Ads 360 là tài nguyên và dịch vụ. Tài nguyên đại diện cho một thực thể Search Ads 360 và bạn sử dụng một dịch vụ để truy xuất các thực thể Search Ads 360.

Hệ phân cấp đối tượng

Tài khoản Search Ads 360 là một hệ thống phân cấp các đối tượng.

Tài nguyên cấp cao nhất của tài khoản là khách hàng.
Mỗi tài khoản chứa một hoặc nhiều chiến dịch đang hoạt động.
Mỗi Campaign chứa một hoặc nhiều nhóm quảng cáo giúp nhóm các quảng cáo của bạn thành các tập hợp logic.
Mỗi AdGroup chứa một hoặc nhiều quảng cáo cấp nhóm quảng cáo.
Bạn có thể đính kèm một hoặc nhiều tệp AdGroupCriterion hoặc CampaignCriterion vào một nhóm quảng cáo hoặc chiến dịch. Các tiêu chí xác định cách kích hoạt quảng cáo.
- Có nhiều loại tiêu chí, chẳng hạn như từ khoá, độ tuổi và vị trí. Tiêu chí được xác định ở cấp chiến dịch ảnh hưởng đến tất cả các tài nguyên khác trong chiến dịch. Bạn cũng có thể chỉ định ngân sách và ngày cho toàn bộ chiến dịch.

Tài nguyên

Tài nguyên đại diện cho các thực thể trong tài khoản Search Ads 360 của bạn. Ví dụ về các tài nguyên bao gồm Customer, Campaign và AdGroup.

Mã đối tượng

Mỗi đối tượng trong Search Ads 360 đều được xác định bằng mã riêng. Một số mã nhận dạng là duy nhất trên toàn cầu, tức là trên tất cả tài khoản Search Ads 360, trong khi các mã khác chỉ là duy nhất trong một phạm vi giới hạn.

Phạm vi tính duy nhất của mã đối tượng
ID ngân sách	Các khu vực nói tiếng Anh
Mã chiến dịch	Các khu vực nói tiếng Anh
ID Nhóm Quảng cáo	Các khu vực nói tiếng Anh
ID Quảng cáo	Nhóm Quảng cáo Mỗi cặp `AdGroupId` / `AdId` là duy nhất trên toàn hệ thống.
ID tiêu chí của nhóm quảng cáo	Nhóm Quảng cáo Mỗi cặp `AdGroupId` / `CriterionId` là duy nhất trên toàn hệ thống.
ID tiêu chí chiến dịch	Chiến dịch Mỗi cặp `CampaignId` / `CriterionId` là duy nhất trên toàn hệ thống.
Phần mở rộng quảng cáo	Chiến dịch Mỗi cặp `CampaignId` / `AdExtensionId` là duy nhất trên toàn hệ thống.
ID nguồn cấp dữ liệu	Các khu vực nói tiếng Anh
Mã mục nguồn cấp dữ liệu	Các khu vực nói tiếng Anh
ID thuộc tính nguồn cấp dữ liệu	Nguồn cấp dữ liệu
Mã bản đồ nguồn cấp dữ liệu	Các khu vực nói tiếng Anh
ID nhãn	Các khu vực nói tiếng Anh
ID danh sách người dùng	Các khu vực nói tiếng Anh

Các quy tắc mã nhận dạng này có thể hữu ích khi thiết kế bộ nhớ cục bộ cho các đối tượng Search Ads 360.

Các loại đối tượng

Một số đối tượng có thể dùng cho nhiều loại thực thể. Nếu đúng như vậy, đối tượng sẽ chứa trường type mô tả nội dung của đối tượng. Ví dụ: AdGroupAd có thể đề cập đến quảng cáo dạng văn bản, quảng cáo khách sạn hoặc quảng cáo địa phương. Bạn có thể truy cập vào giá trị loại thông qua trường AdGroupAd.ad.type. Giá trị của lớp này được trả về trong enum AdType.

Tên tài nguyên

Mỗi tài nguyên được xác định duy nhất bằng một chuỗi resource_name nối tài nguyên và phần tử mẹ của tài nguyên đó thành một đường dẫn.

Ví dụ: tên tài nguyên chiến dịch có dạng:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

Một chiến dịch có mã 987654 trong tài khoản Search Ads 360 có mã khách hàng 1234567 sẽ có resource_name:

customers/1234567/campaigns/987654

Dịch vụ

Các dịch vụ giúp bạn truy xuất các thực thể và siêu dữ liệu trong Search Ads 360. Có 3 loại dịch vụ:

Dịch vụ tìm kiếm

SearchAds360Service là dịch vụ hợp nhất, duy nhất để truy xuất tất cả đối tượng tài nguyên và số liệu thống kê hiệu suất. Cung cấp 2 phương thức: Search và SearchStream. Cả hai phương thức đều yêu cầu truy vấn cần chỉ định tài nguyên để truy vấn, các thuộc tính tài nguyên và chỉ số hiệu suất để truy xuất, các thuộc tính dùng để lọc yêu cầu và các phân đoạn dùng để phân tích thêm về số liệu thống kê về hiệu suất. Hãy xem bài viết Tạo báo cáo tìm kiếm và Ngôn ngữ truy vấn Search Ads 360 để biết thêm thông tin.

Dịch vụ tại hiện trường

SearchAds360FieldService truy xuất siêu dữ liệu về tài nguyên, chẳng hạn như các thuộc tính hiện có cho tài nguyên và loại dữ liệu của tài nguyên đó. Bạn có thể yêu cầu danh mục tài nguyên, trường tài nguyên, khoá phân đoạn và chỉ số có trong 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.

Dịch vụ dành riêng cho pháp nhân

Các dịch vụ này cung cấp phương thức yêu cầu GET để truy xuất một thực thể tài nguyên. Điều này rất hữu ích cho việc kiểm tra cấu trúc của tài nguyên.

Ví dụ về các dịch vụ dành riêng cho pháp nhân:

CustomColumnService trả về cột tuỳ chỉnh được yêu cầu với đầy đủ thông tin chi tiết.