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

Các 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 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 nhóm quảng cáo.
Bạn có thể đính kèm một hoặc nhiều AdGroupCriterion hay CampaignCriterion vào một nhóm quảng cáo hoặc chiến dịch. 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í. Các tiêu chí được xác định ở cấp chiến dịch sẽ ả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 trên toàn 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ác tài nguyên mẫu bao gồm Customer, Campaign và AdGroup.

Mã đối tượng

Mỗi đối tượng trong Search Ads 360 được xác định bằng mã nhận dạng 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 một số mã nhận dạng khác chỉ duy nhất trong một phạm vi giới hạn.

Phạm vi duy nhất của mã đối tượng
ID ngân sách	Toàn cầu
Mã chiến dịch	Toàn cầu
ID Nhóm Quảng cáo	Toàn cầu
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.
Mã AdGroupCriterion	Nhóm quảng cáo Mỗi cặp `AdGroupId` / `CriterionId` là duy nhất trên toàn hệ thống.
Mã CampaignCriterion	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	Toàn cầu
Mã mặt hàng trong nguồn cấp dữ liệu	Toàn cầu
Mã thuộc tính nguồn cấp dữ liệu	Nguồn cấp dữ liệu
Mã ánh xạ nguồn cấp dữ liệu	Toàn cầu
ID nhãn	Toàn cầu
Mã danh sách người dùng	Toàn cầu

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

Các kiểu đối tượng

Một số đối tượng có thể được 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ể tham chiếu đế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ị của loại thông qua trường AdGroupAd.ad.type. Giá trị của thuộc tính này được trả về trong enum AdType.

Tên tài nguyên

Mỗi tài nguyên được xác định riêng biệt bằng một chuỗi resource_name nối tài nguyên đó và tài nguyên mẹ 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, có resource_name:

customers/1234567/campaigns/987654

Dịch vụ

Dịch vụ cho phép bạn truy xuất các thực thể và siêu dữ liệu của 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. Thư viện này cung cấp hai phương thức: Search và SearchStream. Cả hai phương thức đều yêu cầu một truy vấn chỉ định tài nguyên cần truy vấn, các thuộc tính tài nguyên và chỉ số hiệu suất cần truy xuất, các mệnh đề dùng để lọc yêu cầu và các phân đoạn dùng để phân tích thêm 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 có sẵn 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 cho các tài nguyên, trường tài nguyên, khoá phân đoạn và chỉ số có sẵn 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 thực thể

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

Sau đây là một số ví dụ về 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 một cách đầy đủ.