Ngôn ngữ truy vấn Search Ads 360

Ngôn ngữ truy vấn Search Ads 360 cho phép bạn tạo truy vấn tìm kiếm để truy xuất dữ liệu báo cáo và siêu dữ liệu tài nguyên bằng API Báo cáo Search Ads 360.

Dịch vụ tìm kiếm

Bạn có thể sử dụng Ngôn ngữ truy vấn Search Ads 360 để truy vấn API bằng:

SearchAds360Service

Sử dụng dịch vụ này để truy vấn tài nguyên và các thuộc tính, phân đoạn và chỉ số liên quan. Có hai phương thức, Search và SearchStream.

Truy vấn SearchAds360Service trả về danh sách các thực thể SearchAds360Row:

  • Mỗi hàng đại diện cho một tài nguyên.
  • Nếu được yêu cầu, các hàng sẽ bao gồm các thuộc tính và trường chỉ số.
  • Nếu bạn yêu cầu phân đoạn, các hàng bổ sung sẽ được thêm vào cho mỗi cặp phân đoạn-tài nguyê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.

SearchAds360FieldService

Sử dụng dịch vụ này để truy vấn siêu dữ liệu về các trường và tài nguyên có sẵn. Dịch vụ này cung cấp một danh mục các trường có thể truy vấn, trong đó có thông tin chi tiết về khả năng tương thích và loại trường.

SearchAds360FieldService trả về danh sách các thực thể SearchAds360Field:

  • Mỗi trường chứa thông tin chi tiết về trường được yêu cầu.

Hãy xem phần Truy xuất siêu dữ liệu tài nguyên để tìm hiểu thêm.

Ví dụ về truy vấn cơ bản

Các phần sau đây cung cấp ví dụ về truy vấn cơ bản mà bạn có thể điều chỉnh để tạo truy vấn của riêng mình.

Truy vấn các thuộc tính của tài nguyên

Đây là truy vấn cơ bản cho các thuộc tính của tài nguyên campaign, trả về mã chiến dịch, tên và trạng thái:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • Mỗi SearchAds360Row được trả về đại diện cho một đối tượng campaign.
  • Các hàng được điền sẵn các trường đã chọn (bao gồm cả resource_name của chiến dịch đã cho).
  • Truy vấn được sắp xếp theo mã chiến dịch.

Hãy xem campaign để biết các trường khác có sẵn mà bạn có thể sử dụng trong truy vấn.

Truy vấn chỉ số

Đây là truy vấn cơ bản cho các chỉ số liên quan đến thuộc tính của tài nguyên campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • Truy vấn này trả về những chiến dịch có trạng thái PAUSED và hơn 1.000 lượt hiển thị.
  • Mỗi SearchAds360Row được trả về có một trường metrics được điền bằng các chỉ số đã chọn.
  • Truy vấn được sắp xếp theo mã chiến dịch.

Hãy xem metrics để biết các chỉ số khác bạn có thể sử dụng trong truy vấn.

Truy vấn phân khúc

Đây là truy vấn cơ bản cho các phân đoạn liên quan đến các thuộc tính của tài nguyên campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
  • Truy vấn này trả về những chiến dịch có trạng thái PAUSED và hơn 1.000 lượt hiển thị.
  • Phương pháp này phân đoạn dữ liệu theo ngày.
  • Do quá trình phân đoạn, mỗi SearchAds360Row đại diện cho một bộ dữ liệu của một chiến dịch và phân khúc ngày.
  • Truy vấn được sắp xếp theo mã chiến dịch.

Hãy xem segments để biết danh sách các phân khúc mà bạn có thể sử dụng trong truy vấn và Phân đoạn để biết thêm thông tin về cách phân đoạn báo cáo.

Đây là truy vấn cơ bản trên tài nguyên campaign, kết hợp các thuộc tính của tài nguyên bidding_strategy (nếu có). Loại tài nguyên có liên quan này được gọi là tài nguyên được phân bổ.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • Truy vấn này sẽ chọn các thuộc tính chiến dịch và các thuộc tính liên quan từ từng chiến dịch đã chọn.
  • Mỗi SearchAds360Row được trả về đại diện cho một đối tượng campaign được điền sẵn các thuộc tính chiến dịch đã chọn, cũng như thuộc tính chiến lược đặt giá thầu đã chọn, bidding_strategy.name.

Xem campaign để tìm hiểu những tài nguyên được phân bổ có sẵn cho các truy vấn chiến dịch.

Truy vấn siêu dữ liệu trường

Bạn có thể sử dụng SearchAds360FieldService để truy xuất siêu dữ liệu trường.

Đây là truy vấn cơ bản cho siêu dữ liệu trường:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Thay thế RESOURCE OR FIELD (TÀI NGUYÊN HOẶC TRƯỜNG) bằng một tài nguyên (chẳng hạn như customer hoặc campaign) hoặc một trường (chẳng hạn như campaign.id, metrics.impressions hoặc ad_group.id).

Hãy xem phần Truy xuất siêu dữ liệu tài nguyên để biết thêm thông tin về cách truy xuất siêu dữ liệu trường.

Tìm hiểu thêm

Tìm hiểu thêm về cách tạo truy vấn trong API Báo cáo Search Ads 360: