Trình tạo truy vấn của Google Ads là một công cụ tương tác được thiết kế để giúp bạn tạo và xác thực các truy vấn bằng Ngôn ngữ truy vấn của Google Ads (GAQL). Cho dù bạn mới làm quen với GAQL hay là người dùng có kinh nghiệm, Trình tạo truy vấn đều có thể đơn giản hoá quy trình tìm nạp chính xác dữ liệu bạn cần từ Google Ads API.
Lợi ích
- Dễ sử dụng: Đơn giản hoá quy trình viết truy vấn GAQL mà không cần làm quen với cú pháp cụ thể và các trường hiện có.
- Khả năng khám phá: Giúp khám phá và tìm các tài nguyên, trường, phân khúc và chỉ số hiện có trong mô hình dữ liệu Google Ads API.
- Giảm lỗi: Bằng cách cung cấp một giao diện có cấu trúc và các trình đơn thả xuống gồm các lựa chọn hợp lệ, công cụ này giúp ngăn ngừa lỗi cú pháp và lỗi chính tả, đảm bảo truy vấn được tạo là hợp lệ.
- Tạo truy vấn nhanh hơn: Đẩy nhanh quy trình phát triển bằng cách tự động hoá việc tạo chuỗi truy vấn.
- Xác thực: Công cụ này được liên kết với API Explorer và Trình xác thực truy vấn để kiểm tra các truy vấn theo quy tắc API trước khi thực thi.
Cách hoạt động
Trình tạo truy vấn của Google Ads cung cấp một giao diện thân thiện với người dùng để tập hợp các truy vấn GAQL một cách trực quan. Sau đây là quy trình làm việc cơ bản:
- Chọn một tài nguyên: Bắt đầu bằng cách chọn tài nguyên chính trên thẻ
Tài liệu tham khảo cho phiên bản
bạn muốn truy vấn. Tài nguyên này được đặt trong mệnh đề
FROM. Tài nguyên đại diện cho các thực thể trong Google Ads, chẳng hạn nhưcampaign,ad_grouphoặckeyword_view. Trình tạo liệt kê tất cả các tài nguyên hiện có. - Chọn trường: Sau khi bạn chọn một tài nguyên, công cụ này sẽ hiển thị tất cả các trường có thể chọn, bao gồm cả thuộc tính, phân khúc và chỉ số liên quan đến tài nguyên đó và các tài nguyên được phân bổ (có thể kết hợp ngầm ẩn). Bạn có thể đánh dấu vào các hộp kiểm để đưa trường vào mệnh đề
SELECT. Khi bạn chọn, công cụ này sẽ tự động tạo chuỗi truy vấn GAQL tương ứng, hiển thị mọi lỗi và lọc ra các tổ hợp trường không tương thích. - Áp dụng bộ lọc: Thêm các điều kiện trong mệnh đề
WHEREđể lọc kết quả. Trình tạo giúp bạn chọn trường, toán tử và giá trị, đảm bảo cú pháp chính xác. - Sắp xếp kết quả: Chỉ định thứ tự sắp xếp bằng mệnh đề
ORDER BY. - Đặt giới hạn: Thêm mệnh đề
LIMITđể kiểm soát số lượng kết quả được trả về. - Xác thực: Công cụ này vốn hướng dẫn bạn chọn các tổ hợp trường hợp lệ, đồng thời liên kết đến API Explorer để bạn có thể kiểm thử truy vấn theo dữ liệu tài khoản của mình. Ngoài ra, còn có một Trình xác thực truy vấn riêng biệt để bạn có thể dán và kiểm tra các truy vấn GAQL được viết thủ công.
- Xuất: Sau khi bạn hài lòng với truy vấn của mình, hãy sao chép và dán chuỗi GAQL đã kiểm thử và có cú pháp chính xác vào các yêu cầu của máy khách
GoogleAdsService.SearchhoặcSearchStream.
Trình tạo đảm bảo rằng các trường, phân khúc và chỉ số đã chọn tương thích và có thể được sử dụng cùng nhau trong một truy vấn, tham chiếu đến siêu dữ liệu cơ bản của Google Ads API.
Bắt đầu
Có hai cách để truy cập vào Trình tạo truy vấn: truy cập qua một trang cụ thể trong tài liệu tham khảo về báo cáo hoặc khám phá trên trang tổng quan về Trình tạo truy vấn.
Trong tài liệu tham khảo về báo cáo
- Bắt đầu bằng tài liệu tham khảo về báo cáo, rồi chọn một tài nguyên cụ thể để bắt đầu trong danh sách tất cả tài nguyên. Ngoài ra, hãy chuyển trực tiếp đến tài nguyên đó trên ngăn điều hướng bên trái.
- Nhấp vào Giúp tôi tạo truy vấn để chuyển đến Trình tạo truy vấn cho tài nguyên cụ thể đó.
Trên trang tổng quan về Trình tạo truy vấn
Chuyển đến phần Trình tạo truy vấn trong tài liệu tham khảo về báo cáo rồi chọn tài nguyên bạn muốn khám phá.
Tích hợp với các công cụ khác
Trình tạo truy vấn được tích hợp với các công cụ khác trong Bộ công cụ dành cho nhà phát triển Google Ads API. Bạn có thể lấy một truy vấn được tạo trong Trình tạo truy vấn rồi kiểm thử trong API Explorer hoặc xác thực bằng Trình xác thực truy vấn.
API Explorer
Sau khi bạn tạo truy vấn, hãy nhấp vào Dùng thử trong API Explorer để mở truy vấn đó trong API Explorer. Truy vấn của bạn sẽ tự động được điền vào nội dung yêu cầu, sau đó bạn có thể kiểm thử truy vấn bằng cách chạy truy vấn đó theo dữ liệu tài khoản của mình. Hãy xem API Explorer để biết thêm thông tin về công cụ đó.
Trình xác thực truy vấn
Khi bạn nhấp vào Nhập hoặc chỉnh sửa truy vấn, Trình xác thực truy vấn sẽ mở ra. Hãy sử dụng Trình xác thực truy vấn để xác thực cú pháp của truy vấn. Mọi truy vấn được tạo hoàn toàn thông qua Trình tạo truy vấn đều có cú pháp chính xác, nhưng nếu bạn đã quen thuộc với tài nguyên mà bạn đang truy vấn, thì Trình xác thực truy vấn sẽ cung cấp một cách nhanh chóng để nhập truy vấn và kiểm tra tính hợp lệ của truy vấn đó. Hãy xem Trình xác thực truy vấn để biết thêm thông tin về công cụ đó.