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
hayCampaignCriterion
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áoMỗi cặp AdGroupId / AdId là duy nhất trên toàn hệ thống. |
Mã AdGroupCriterion | Nhóm quảng cáoMỗi cặp AdGroupId / CriterionId là duy nhất trên toàn hệ thống. |
Mã CampaignCriterion | Chiến dịchMỗ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ịchMỗ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ế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 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 đủ.