Các thành phần chính của Search Ads 360 Reporting API 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 một 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
Campaignchứa một hoặc nhiều nhóm quảng cáo để nhóm quảng cáo của bạn thành các tập hợp hợp lý.Mỗi
AdGroupchứ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
AdGroupCriterionhoặcCampaignCriterionvào một nhóm quảng cáo hoặc chiến dịch. Tiêu chí xác định cách quảng cáo được kích hoạt.- 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 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 ví dụ 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ã 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 |
| Mã quảng cáo | Nhóm quảng cáoMỗi cặp AdGroupId / AdId đều là duy nhất trên toàn cầu. |
| Mã AdGroupCriterion | Nhóm quảng cáoMỗi cặp AdGroupId/CriterionId đều là duy nhất trên toàn cầu. |
| Mã CampaignCriterion | Chiến dịchMỗi cặp CampaignId/CriterionId đều là duy nhất trên toàn cầu. |
| Phần mở rộng quảng cáo | Chiến dịchMỗi cặp CampaignId/AdExtensionId đều là duy nhất trên toàn cầu. |
| ID nguồn cấp dữ liệu | Toàn cầu |
| Mã mục 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 về 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 đây là trường hợp đó, đối tượng sẽ chứa một 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 khoá 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à các tài nguyên mẹ của tài nguyên đó thành một đường dẫn.
Tên tài nguyên chiến dịch, ví dụ: có dạng:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
Một chiến dịch có mã nhận dạng 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ụ
Các dịch vụ cho phép bạn truy xuất các thực thể và siêu dữ liệu Search Ads 360. Có 3 loại dịch vụ:
- Dịch vụ tìm kiếm
SearchAds360Servicelà dịch vụ hợp nhất duy nhất để truy xuất tất cả các đối tượng tài nguyên và số liệu thống kê về hiệu suất. Thư viện này cung cấp 2 phương thức:Searchvà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 vị từ cần dùng để lọc yêu cầu và các phân đoạn cần dùng để chia nhỏ 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 chỗ
SearchAds360FieldServicetruy 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 một tài nguyên và kiểu 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ó trong các phương thức tìm kiếmSearchAds360Service. 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 hữu ích khi kiểm tra cấu trúc của một tài nguyên.Sau đây là 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 một cách chi tiết.