Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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 đoạn được đưa vào mệnh đề SELECT cùng với các chỉ số, các chỉ số sẽ được phân tách theo phân đoạn.
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 liên kết 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 của Google Ads có thể truy vấn Google Ads API để 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ả của một truy vấn GoogleAdsService là 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 có thuộc tính hoặc chỉ số nào được yêu cầu, thì hàng cũng bao gồm các trường đó. Nếu có bất kỳ phân đoạn nào được yêu cầu, thì phản hồi cũng sẽ hiển thị thêm một hàng cho mỗi bộ dữ liệu 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, kèm theo 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 về cấu trúc truy vấn, hãy xem phần Cấu trúc truy vấn và Ngữ pháp của Ngôn ngữ truy vấn Google Ads.

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

Dưới đâ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ã nhận dạng, tên và trạng thái của chiến dịch:

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.

Để tìm hiểu những trường khác có sẵn cho truy vấn chiến dịch, hãy tham khảo tài liệu tham khảo 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 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 kết quả 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 tài liệu về Metrics.

Truy vấn cho phân đoạn

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 có 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 các 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ộ dữ liệu gồm một chiến dịch và phân đoạn ngày. Việc phân đoạn sẽ chia tách 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 có 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 phân bổ". Bạn có thể kết hợp với các tài nguyên được phân bổ một cách ngầm định bằng cách chọn một thuộc tính trong truy vấn của mình.

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 lấy các thuộc tính liên quan từ mỗi chiến dịch đã chọn. Mỗi GoogleAdsRow kết quả đại diện cho một đối tượng campaign được điền sẵn các thuộc tính phân bổ cho 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.

Để 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, 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 kết quả lớn.
Áp dụng bộ lọc trong mệnh đề WHERE để giảm thiểu việc chuyể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 loại dữ liệu trước khi tạo 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 dữ liệu lớn hoặ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ể ngay lập tức lấy các kết quả được trả về dưới dạng đối tượng, sửa đổi các đối tượng đó rồi gửi lại cho phương thức thay đổi trong dịch vụ của tài nguyên đó. Sau đây là một quy trình mẫu:

Thực thi một truy vấn cho tất cả chiến dịch PAUSED có số lượt hiển thị lớn hơn 1000.
Lấy đối tượng Campaign từ trường campaign của mỗi GoogleAdsRow trong phản hồi.
Thay đổi trạng thái của từng chiến dịch từ PAUSED thành ENABLED.
Gọi CampaignService.MutateCampaigns bằng các chiến dịch đã sửa đổi và FieldMask tương ứng để 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 nhằm mục đích 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 sử dụng các trường cùng nhau trong một truy vấn. Vì dữ liệu có sẵn trong 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 truy vấn, nên nhà phát triển có thể thực hiện việc này theo phương thức lập trình. Sau đây là một truy vấn thông thường cho 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.

Sự khác biệt theo phiên bản

Mặc dù cú pháp, mệnh đề và toán tử của Ngôn ngữ truy vấn Google Ads là giống nhau trên tất cả các phiên bản Google Ads API được hỗ trợ (phiên bản 23, 24, 25 và 26), nhưng danh mục tài nguyên, phân đoạn, chỉ số và hành vi báo cáo có thể truy vấn sẽ khác nhau tuỳ theo phiên bản lớn. Truy vấn GoogleAdsFieldService tại điểm cuối của phiên bản API mục tiêu để kiểm tra các trường và quy tắc tương thích cho phiên bản đó:

Chế độ xem thành phần Mở rộng URL cuối cùng:
- Hỗ trợ chiến dịch Mua sắm (phiên bản 26 trở lên): final_url_expansion_asset_view hỗ trợ chiến dịch Mua sắm (campaign.advertising_channel_type = 'SHOPPING') ngoài chiến dịch Tối đa hoá hiệu suất và chiến dịch Tìm kiếm. Đối với chiến dịch Mua sắm, bạn có thể chọn và lọc theo các trường ad_group, nhưng không thể chọn các trường asset_group.
- Chỉ số có thể chọn (phiên bản 25 trở lên): Truy vấn final_url_expansion_asset_view sẽ trả về tất cả chỉ số có thể chọn cho chế độ xem. Trong phiên bản 24 trở xuống, phản hồi chỉ bao gồm metrics.conversions và metrics.conversions_value cho chiến dịch Tối đa hoá hiệu suất và metrics.impressions cho chiến dịch Tìm kiếm.
Tài nguyên mục tiêu vòng đời: Trong phiên bản 25 trở lên, tất cả mục tiêu vòng đời (Thu nạp khách hàng mới, Giữ chân khách hàng và Giữ chân khách hàng thân thiết) đều được truy vấn từ các tài nguyên goal và campaign_goal_config hợp nhất, thay thế customer_lifecycle_goal và campaign_lifecycle_goal (được dùng cho mục tiêu Thu nạp khách hàng mới trong phiên bản 24 trở xuống, cùng với goal và campaign_goal_config cho mục tiêu Giữ chân khách hàng).
Báo cáo về sản phẩm cho chiến dịch Quảng cáo ứng dụng: Trong phiên bản 24 trở lên, tài nguyên shopping_product sẽ trả về các hàng sản phẩm cho chiến dịch Quảng cáo ứng dụng, ngoài chiến dịch Mua sắm, chiến dịch Tối đa hoá hiệu suất, chiến dịch Tạo nhu cầu và chiến dịch Video (trong phiên bản 23, chiến dịch Quảng cáo ứng dụng bị loại trừ khỏi kết quả của shopping_product).
Tài nguyên, phân khúc và chỉ số theo phiên bản:
- Phiên bản 26 trở lên: Bao gồm tài nguyên search_lift_keyword_bundle, campaign.lift_measurement_config, local_services_lead.campaign, segments.search_lift_keyword_bundle, segments.search_property và các chỉ số về Mức tăng lưu lượng tìm kiếm (chẳng hạn như metrics.relative_search_lift, metrics.normalized_incremental_searches, metrics.search_lift_cost_micros và metrics.search_lift_impressions).
- Phiên bản 25 trở lên: Bao gồm các tài nguyên đo lường mức tăng (chẳng hạn như lift_measurement_config), các phân khúc như segments.ad_sub_format_type và segments.loyalty_membership, cũng như các chỉ số tương tác trên YouTube (metrics.youtube_likes, metrics.youtube_comments và metrics.youtube_shares). Xoá local_services_lead.contact_details.email (có thể chọn trong phiên bản 24 trở xuống).
- v24 trở lên: Bao gồm tài nguyên cart_data_sales_view, segments.conversion_attribution_event_type trên shopping_performance_view, segments.mobile_device_platform và segments.ad_network_type trên performance_max_placement_view. Xoá campaign.video_brand_safety_suitability (được thay thế bằng customer.video_brand_safety_suitability), segments.ad_sub_network_type trên campaign_budget và segments.click_type trên ad_group_asset, campaign_asset và customer_asset (chỉ có thể chọn trong phiên bản 23).
Mã lỗi giai đoạn xem lại ngày chi tiết: Các truy vấn phân đoạn theo segments.date, segments.week hoặc segments.hour (hoặc lọc theo phạm vi ngày dưới một tháng) ngoài giai đoạn xem lại 37 tháng sẽ trả về DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED trong phiên bản 24 trở lên (hoặc DateRangeError.UNKNOWN trong phiên bản 23). Hãy xem bài viết Phạm vi ngày để biết thông tin chi tiết.

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 của Google Ads trong GoogleAdsService. Thư mục basic operations (thao tác cơ bản) có các ví dụ như GetCampaigns, GetKeywords và SearchForGoogleAdsFields.

Tiếp

Ngữ pháp truy vấn