Ngôn ngữ truy vấn Google Ads

Thuật ngữ chính

Tài nguyên: Một thực thể trong Google Ads, chẳng hạn như campaign hoặc ad_group.
Phân đoạn: Một phương diện dùng để nhóm dữ liệu, chẳng hạn như segments.date hoặc segments.device. Khi các phân khúc được đưa vào mệnh đề SELECT cùng với các chỉ số, các chỉ số sẽ được chia theo phân khúc.
Chỉ số: Một chỉ số đo lường hiệu suất, chẳng hạn như metrics.impressions hoặc metrics.clicks.
Tài nguyên được phân bổ: Một tài nguyên được kết hợp ngầm với tài nguyên chính trong mệnh đề FROM, cho phép bạn chọn các thuộc tính của tài nguyên đó cùng với các thuộc tính của tài nguyên chính.

Truy vấn thông tin về tài nguyên hoặc siêu dữ liệu

Ngôn ngữ truy vấn Google Ads có thể truy vấn API Google Ads để biết các loại thông tin sau:

Tài nguyên và các thuộc tính, phân đoạn và chỉ số liên quan bằng cách sử dụng GoogleAdsService Search hoặc SearchStream: Kết quả từ một truy vấn GoogleAdsService là một danh sách các thực thể GoogleAdsRow, trong đó mỗi GoogleAdsRow đại diện cho một tài nguyên.

Nếu bạn yêu cầu bất kỳ thuộc tính hoặc chỉ số nào, thì hàng cũng sẽ bao gồm các trường đó. Nếu bạn yêu cầu phân đoạn, thì phản hồi cũng sẽ cho thấy một hàng bổ sung cho mỗi bộ giá trị phân đoạn-tài nguyên.
Siêu dữ liệu về các trường và tài nguyên có sẵn trong GoogleAdsFieldService: Dịch vụ này cung cấp một danh mục các trường có thể truy vấn cùng với thông tin cụ thể về khả năng tương thích và loại của các trường đó.

Kết quả của một truy vấn GoogleAdsFieldService là danh sách các thực thể GoogleAdsField, trong đó mỗi GoogleAdsField chứa thông tin chi tiết về trường được yêu cầu.

Để biết thêm thông tin chi tiết về cấu trúc truy vấn, hãy xem phần Cấu trúc truy vấn và Ngữ pháp Ngôn ngữ truy vấn Google Ads.

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

Sau đây là ví dụ về một truy vấn cơ bản cho các thuộc tính của tài nguyên chiến dịch minh hoạ cách 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

Truy vấn này sắp xếp theo mã chiến dịch. Mỗi GoogleAdsRow kết quả đại diện cho một đối tượng campaign được điền sẵn các trường đã chọn, bao gồm cả resource_name của chiến dịch.

Để biết những trường khác có sẵn cho các truy vấn về chiến dịch, hãy tham khảo tài liệu tham khảo về Campaign.

Truy vấn chỉ số

Bên cạnh các thuộc tính đã chọn cho một tài nguyên nhất định, bạn cũng có thể truy vấn các chỉ số liên quan:

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

Để xem danh sách các chỉ số có thể truy vấn, hãy tham khảo Metricstài liệu.

Truy vấn cho phân khúc

Bên cạnh các thuộc tính đã chọn cho một tài nguyên nhất định, bạn cũng có thể truy vấn các phân đoạn liên quan:

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

Tương tự như việc truy vấn chỉ số, truy vấn này chỉ lọc những chiến dịch có trạng thái là PAUSED và có hơn 1.000 lượt hiển thị. Tuy nhiên, truy vấn này phân đoạn dữ liệu theo ngày. Điều này dẫn đến việc mỗi GoogleAdsRow kết quả đại diện cho một bộ gồm chiến dịch và ngày Segment. Phân đoạn sẽ chia các chỉ số đã chọn, nhóm theo từng phân đoạn trong mệnh đề SELECT.

Để xem danh sách các phân đoạn có thể truy vấn, hãy tham khảo tài liệu về Segments.

Trong một truy vấn cho một tài nguyên nhất định, bạn có thể kết hợp với các tài nguyên liên quan khác nếu có. Những tài nguyên có liên quan này được gọi là "tài nguyên được ghi nhận". Bạn có thể kết hợp với các tài nguyên được phân bổ một cách gián tiếp bằng cách chọn một thuộc tính trong truy vấn.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

Truy vấn này không chỉ chọn các thuộc tính chiến dịch mà còn kéo các thuộc tính liên quan từ mỗi chiến dịch được chọn. Mỗi GoogleAdsRow thu được sẽ đạ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.

Để biết những tài nguyên được phân bổ có sẵn cho các truy vấn về chiến dịch, hãy tham khảo tài liệu tham khảo về Campaign.

Các phương pháp hay nhất

Chỉ chọn những trường bạn cần để tránh thời gian phản hồi dài và hết thời gian chờ.
Sử dụng LIMIT trong quá trình phát triển và kiểm thử để tránh xử lý các tập hợp kết quả lớn.
Áp dụng bộ lọc trong mệnh đề WHERE để giảm thiểu việc truyền dữ liệu và kích thước phản hồi.
Sử dụng GoogleAdsFieldService để kiểm tra khả năng tương thích của trường và các kiểu dữ liệu trước khi tạo các truy vấn phức tạp.
Xin lưu ý rằng một số trường, đặc biệt là những trường liên quan đến lượng lớn dữ liệu hoặc các phép tính phức tạp, có thể làm tăng chi phí truy vấn.

Thay đổi dựa trên kết quả truy vấn

Khi truy vấn một tài nguyên nhất định, bạn có thể lấy ngay những kết quả được trả về dưới dạng đối tượng, sửa đổi các đối tượng đó và gửi lại cho phương thức biến đổi trong dịch vụ của tài nguyên đó. Sau đây là một quy trình mẫu: 1. Thực hiện một truy vấn cho tất cả chiến dịch hiện đang ở trạng thái PAUSED và có số lượt hiển thị lớn hơn 1.000. 1. Lấy đối tượng Campaign từ trường campaign của mỗi GoogleAdsRow trong phản hồi. 1. Thay đổi trạng thái của từng chiến dịch từ PAUSED thành ENABLED. 1. Gọi CampaignService.MutateCampaigns bằng các chiến dịch đã sửa đổi để cập nhật các chiến dịch đó.

Siêu dữ liệu trường

Các truy vấn được gửi đến GoogleAdsFieldService là để truy xuất siêu dữ liệu trường. Bạn có thể sử dụng thông tin này để hiểu cách kết hợp các trường trong một truy vấn. Vì dữ liệu có sẵn từ API và API này cung cấp siêu dữ liệu cần thiết để xác thực hoặc tạo một truy vấn, nên nhà phát triển có thể thực hiện việc này theo phương pháp có lập trình. Sau đây là một truy vấn điển hình về siêu dữ liệu:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

Bạn có thể thay thế <INSERT_RESOURCE_OR_FIELD> trong truy vấn này bằng một tài nguyên (chẳng hạn như customer hoặc campaign) hoặc trường (chẳng hạn như campaign.id, metrics.impressions hoặc ad_group.id).

Để biết danh sách các trường có thể truy vấn, hãy tham khảo tài liệu về GoogleAdsField.

Ví dụ về mã

Thư viện ứng dụng có các ví dụ về cách sử dụng Ngôn ngữ truy vấn Google Ads trong GoogleAdsService. Thư mục các thao tác cơ bản có các ví dụ như GetCampaigns, GetKeywords và SearchForGoogleAdsFields.

Tiếp

Ngữ pháp truy vấn