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 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 Search Ads 360 Reporting API.

Các 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 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, phân đoạn và chỉ số liên quan. Có hai phương thức là Search và SearchStream.

Các truy vấn SearchAds360Service trả về một 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 trường thuộc tính và 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 bộ giá trị 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 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 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à một truy vấn cơ bản cho các thuộc tính của tài nguyên campaign. Truy vấn này 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 bằng 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 khác mà bạn có thể dùng trong truy vấn.

Truy vấn các chỉ số

Đây là một 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à có hơn 1.000 lượt hiển thị.

  • Mỗi SearchAds360Row được trả về đều 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.

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

Truy vấn cho các phân khúc

Đây là một 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ề những chiến dịch có trạng thái PAUSED và có hơn 1.000 lượt hiển thị.

  • Bảng này phân đoạn dữ liệu theo ngày.

  • Do việc phân đoạn, mỗi SearchAds360Row đại diện cho một bộ gồm 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 đoạn để biết thêm thông tin về cách phân đoạn báo cáo.

Đây là một truy vấn cơ bản về 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à thuộc tính liên quan từ 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 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 để biết 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 trường

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

Đây là một 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 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 Search Ads 360 Reporting API: