Ngôn ngữ truy vấn google ads (Google Ads Query Language – GAQL) là công cụ mạnh mẽ hỗ trợ nhà quảng cáo khai thác dữ liệu từ API Google Ads. Với GAQL, bạn có thể truy vấn chi tiết về tài nguyên, thuộc tính, chỉ số và phân khúc liên quan để tối ưu hóa chiến dịch quảng cáo. Bài viết này sẽ hướng dẫn bạn cách sử dụng ngôn ngữ truy vấn google ads hiệu quả, từ cơ bản đến nâng cao, để đạt được kết quả tốt nhất trong các chiến dịch của mình.
Ngôn ngữ truy vấn Google Ads cho phép truy vấn API Google Ads để lấy thông tin chi tiết về tài nguyên, thuộc tính, phân khúc và chỉ số bằng cách sử dụng GoogleAdsService thông qua phương thức Search hoặc SearchStream.
Khi thực hiện truy vấn bằng GoogleAdsService, kết quả trả về 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 cụ thể. Nếu truy vấn yêu cầu thuộc tính hoặc chỉ số, các trường tương ứng sẽ được bao gồm trong hàng dữ liệu. Đối với các truy vấn có yêu cầu phân đoạn, hệ thống sẽ trả về một hàng riêng biệt cho mỗi bộ dữ liệu kết hợp giữa phân đoạn và tài nguyên.
Thông tin chi tiết về các trường và tài nguyên có thể truy vấn được cung cấp bởi GoogleAdsFieldService. Dịch vụ này cung cấp một danh mục đầy đủ các trường có thể sử dụng trong truy vấn, bao gồm khả năng tương thích với các loại tài nguyên và thông tin chi tiết về loại dữ liệu.
Kết quả từ truy vấn GoogleAdsFieldService sẽ 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, bao gồm mô tả, định dạng và khả năng tương thích với các ngữ cảnh truy vấn khác nhau.
Truy vấn thuộc tính của tài nguyên
Dưới đây là ví dụ truy vấn cơ bản để lấy thông tin các thuộc tính của tài nguyên chiến dịch. Truy vấn này trả về mã chiến dịch, tên chiến dịch và trạng thái chiến dịch:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
Truy vấn trên sắp xếp kết quả theo mã chiến dịch. Mỗi thực thể GoogleAdsRow thu được sẽ đại diện cho một đối tượng chiến dịch (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 thêm thông tin về các trường có thể truy vấn liên quan đến chiến dịch, bạn có thể tham khảo tài liệu tham khảo về Campaign.
Truy vấn chỉ số (Metrics)
Ngoài các thuộc tính của tài nguyên, bạn cũng có thể truy vấn các chỉ số liên quan. Ví dụ:
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ên chỉ trả về các chiến dịch có trạng thái là PAUSED và có hơn 1.000 lượt hiển thị (impressions). Kết quả sẽ được sắp xếp theo mã chiến dịch. Mỗi GoogleAdsRow thu được sẽ có trường metrics chứa các chỉ số được yêu cầu.
Để xem danh sách các chỉ số có thể truy vấn, bạn có thể tham khảo tài liệu về Metrics.
Truy vấn phân khúc (Segments)
Ngoài thuộc tính và chỉ số, bạn cũng có thể truy vấn các phân đoạn liên quan. Ví dụ:
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ên chỉ lọc ra các chiến dịch có trạng thái PAUSED, có hơn 1.000 lượt hiển thị, đồng thời phân đoạn dữ liệu theo ngày (segments.date). Kết quả sẽ bao gồm mỗi GoogleAdsRow đại diện cho một bộ dữ liệu tương ứng với một chiến dịch và một ngày trong khoảng thời gian 30 ngày gần nhất.
Quan trọng cần lưu ý: Khi sử dụng phân đoạn, các chỉ số trong truy vấn sẽ được chia nhỏ theo từng giá trị phân đoạn, tức là các chỉ số sẽ được nhóm theo từng giá trị trong mệnh đề SELECT.
Để biết thêm chi tiết về các phân đoạn có thể truy vấn, bạn có thể tham khảo tài liệu về Segments.
Truy vấn các thuộc tính của tài nguyên liên quan
Trong các truy vấn dành cho một tài nguyên cụ thể, bạn có thể tích hợp các thuộc tính từ các tài nguyên liên quan (nếu có). Những tài nguyên liên quan này thường được gọi là “tài nguyên được phân bổ”. Việc kết nối với các tài nguyên phân bổ có thể được thực hiện một cách ngầm định bằng cách chọn các thuộc tính liên quan trong truy vấn.
Ví dụ:
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
Truy vấn trên không chỉ lấy thông tin từ tài nguyên chiến dịch (campaign) mà còn trả về thông tin từ tài nguyên liên quan, cụ thể là tên chiến lược đặt giá thầu (bidding_strategy.name). Kết quả là mỗi GoogleAdsRow đại diện cho một đối tượng campaign bao gồm các thuộc tính của chiến dịch và thuộc tính được phân bổ từ chiến lược đặt giá thầu.
Để tìm hiểu thêm về các tài nguyên được phân bổ có thể tích hợp trong truy vấn chiến dịch, bạn có thể tham khảo tài liệu tham khảo về Campaign.
Biến đổi dữ liệu dựa trên kết quả truy vấn
Khi truy vấn một tài nguyên cụ thể, bạn có thể trực tiếp sửa đổi các đối tượng thu được từ phản hồi và gửi lại để cập nhật chúng thông qua các dịch vụ tương ứng. Dưới đây là quy trình minh họa:
- Thực thi một truy vấn để lấy tất cả các chiến dịch hiện có trạng thái
PAUSEDvà có hơn 1.000 lượt hiển thị. - Lấy đối tượng Campaign từ trường
campaigntrong từng GoogleAdsRow của phản hồi. - Cập nhật trạng thái của mỗi chiến dịch từ
PAUSEDthànhENABLED. - Sử dụng phương thức
CampaignService.MutateCampaignsđể áp dụng thay đổi cho các chiến dịch đã cập nhật.
Truy vấn siêu dữ liệu trường
Để hiểu rõ hơn về cách sử dụng các trường trong truy vấn, bạn có thể sử dụng GoogleAdsFieldService để truy xuất siêu dữ liệu của chúng. API này cung cấp thông tin chi tiết về các trường như tính khả dụng, khả năng lọc, sắp xếp, và khả năng kết hợp với các trường khác. Ví dụ truy vấn siêu dữ liệu:
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"
Trong truy vấn trên, bạn cần thay thế <INSERT_RESOURCE_OR_FIELD> bằng một tài nguyên (như customer, campaign) hoặc trường cụ thể (như campaign.id, metrics.impressions, hoặc ad_group.id).
Lưu ý: Truy vấn siêu dữ liệu không có mệnh đề FROM.
Để xem danh sách các trường có thể truy vấn, tham khảo tài liệu về GoogleAdsField.
Ví dụ mã nguồn
Google cung cấp thư viện ứng dụng với các ví dụ cụ thể về cách sử dụng ngôn ngữ truy vấn Google Ads với GoogleAdsService. Một số ví dụ phổ biến bao gồm:
GetCampaigns: Truy vấn và lấy danh sách chiến dịch.GetKeywords: Lấy danh sách từ khóa.SearchForGoogleAdsFields: Truy vấn các trường khả dụng từ GoogleAdsFieldService.
Những ví dụ này giúp bạn nhanh chóng làm quen với cách xây dựng và sử dụng ngôn ngữ truy vấn trong Google Ads API.
Ngôn ngữ truy vấn google ads là công cụ không thể thiếu đối với các nhà quảng cáo muốn khai thác tối đa tiềm năng của Google Ads API. Từ việc truy vấn tài nguyên, thuộc tính đến phân tích chỉ số và phân khúc, GAQL giúp bạn kiểm soát và tối ưu hóa chiến dịch quảng cáo dễ dàng hơn. Hãy áp dụng các hướng dẫn trong bài viết để cải thiện hiệu suất quảng cáo và đạt được mục tiêu kinh doanh hiệu quả. Nếu bạn cần hỗ trợ chuyên sâu về quảng cáo google ads, hãy liên hệ với các chuyên gia để được tư vấn tốt nhất.
