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

Ngôn ngữ truy vấn của Search Ads 360 giúp bạn xây dựng 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 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 của Search Ads 360 để truy vấn API bằng cách sử dụng:

SearchAds360Service

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

Các 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 khúc, thì các hàng bổ sung sẽ được bao gồm cho mỗi phân khúc 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 kèm theo thông tin cụ thể về khả năng tương thích và loại dữ liệu.

SearchAds360FieldService trả về danh sách SearchAds360Field trường hợp:

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

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 các ví dụ về truy vấn cơ bản mà bạn có thể điều chỉnh để xây dựng truy vấn của chính bạn.

Truy vấn các thuộc tính của một 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ã, 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.
  • Hàng được điền sẵn với các trường đã chọn (bao gồm các trường của chiến dịch nhất định resource_name).
  • 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 cho các chỉ số liên quan đến thuộc tính của campaign tài nguyên:

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 trả về chiến dịch có trạng thái PAUSED và hơn 1.000 chiến dịch số lần hiển thị.
  • Mỗi SearchAds360Row được trả về có một trường metrics được điền sẵn chỉ số đã chọn.
  • Truy vấn sắp xếp theo mã chiến dịch.

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

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 thuộc tính của campaign tài nguyên:

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 trả về chiến dịch có trạng thái PAUSED và hơn 1.000 chiến dịch số lần hiển thị.
  • Chế độ xem này phân đoạn dữ liệu theo ngày.
  • Theo kết quả của phân đoạn, mỗi SearchAds360Row đại diện cho một bộ dữ liệu một 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 truy cập vào segments để biết danh sách phân đoạn mà bạn có thể sử dụng trong các truy vấn của mình và để biết thêm thông tin về Phân đoạn 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 là đượ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 chiến dịch và thuộc tính có liên quan trong mỗi 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 với các thuộc tính chiến dịch đã chọn, cũng 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ổ nào có sẵn cho các truy vấn chiến dịch.

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

Bạn có thể sử 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 của 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 trường siêu dữ liệu.

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: