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

Ngôn ngữ truy vấn của Search Ads 360 cho phép bạn tạo các cụm từ 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 cách sử dụng API Báo cáo Search Ads 360.

Tìm kiếm dịch vụ

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

SearchAds360Service

Hãy sử dụng dịch vụ này để truy vấn tài nguyên cũng như các thuộc tính, phân đoạn và chỉ số có 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 trường thuộc tính và trường chỉ số.
  • Nếu bạn yêu cầu phân đoạn, thì các hàng bổ sung sẽ được đưa vào cho mỗi bộ dữ liệu tài nguyên phân đoạn.

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 với thông tin cụ thể về khả năng tương thích và loại của các trường đó.

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

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

Xem 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 các 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 đối với các thuộc tính của tài nguyên campaign trả về mã, tên và trạng thái chiến dịch:

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 những trường đã chọn (bao gồm cả resource_name của chiến dịch đã cho).
  • Truy vấn sắp xếp theo mã chiến dịch.

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

Truy vấn chỉ số

Đây là truy vấn cơ bản về 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ề các 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 sẵn các chỉ số đã chọn.
  • Truy vấn sắp xếp theo mã chiến dịch.

Xem metrics để biết các chỉ số có sẵn khác mà bạn có thể sử dụng trong truy vấn của mình.

Truy vấn phân đoạn

Đây là truy vấn cơ bản cho các phân đoạn liên quan đến 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ề các chiến dịch có trạng thái PAUSED và hơn 1.000 lượt hiển thị.
  • Phân đoạn dữ liệu theo ngày.
  • Nhờ có phân đoạn, mỗi SearchAds360Row đại diện cho một bộ dữ liệu của chiến dịch và phân đoạn ngày.
  • Truy vấn sắp xếp theo mã chiến dịch.

Hãy xem segments để biết danh sách các phân đoạn mà bạn có thể sử dụng trong truy vấn và phần 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 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 chọn các thuộc tính của chiến dịch và thuộc tính có liên quan từ mỗi chiến dịch được 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.

Hãy xem campaign để tìm hiểu xem có sẵn tài nguyên phân bổ nào cho các truy vấn chiến dịch.

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

Bạn có thể dùng SearchAds360FieldService để truy xuất siêu dữ liệu của 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ế 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).

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 của 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: