Trong Google Ads, việc truy xuất các đối tượng và số liệu thống kê hiệu suất là chìa khóa giúp tối ưu hóa chiến dịch quảng cáo của bạn. GoogleAdsService, với các phương thức mạnh mẽ như Search và SearchStream, giúp bạn dễ dàng truy vấn thông tin chi tiết và theo dõi hiệu suất quảng cáo. Từ việc sắp xếp đối tượng, giới hạn kết quả trả về đến việc phân đoạn dữ liệu, GoogleAdsService cung cấp tất cả các công cụ cần thiết để bạn kiểm soát và tối ưu chiến dịch. Trong bài viết này, chúng ta sẽ tìm hiểu cách sử dụng dịch vụ này để truy xuất các thuộc tính đối tượng và chỉ số hiệu suất, cũng như xử lý các phản hồi theo cách hiệu quả nhất.
Mục tiêu: Hiểu cách truy xuất đối tượng và số liệu thống kê hiệu suất bằng GoogleAdsService. Đối với chi tiết về báo cáo, hãy xem hướng dẫn báo cáo của Google Ads.
GoogleAdsService là dịch vụ hợp nhất dành cho việc truy xuất dữ liệu và báo cáo trong Google Ads API. Dịch vụ này cung cấp các phương thức chính bao gồm:
- Truy xuất các thuộc tính cụ thể của đối tượng.
- Truy xuất chỉ số hiệu suất dựa trên phạm vi ngày.
- Sắp xếp đối tượng dựa trên các thuộc tính của chúng.
- Sử dụng các điều kiện để lọc và xác định đối tượng nào sẽ được trả về trong phản hồi.
- Giới hạn số lượng đối tượng được trả về.
GoogleAdsService có hai cách để trả về kết quả:
- GoogleAdsService.SearchStream: Trả về tất cả các hàng dữ liệu trong một phản hồi truyền trực tuyến duy nhất. Phương thức này đặc biệt hiệu quả khi cần xử lý lượng lớn dữ liệu (hơn 10.000 hàng), phù hợp với các ứng dụng hàng loạt cần tải xuống nhiều dữ liệu nhanh chóng.
- GoogleAdsService.Search: Chia nhỏ các phản hồi lớn thành các trang kết quả có thể quản lý. Phương pháp này phù hợp với các ứng dụng tương tác, hiển thị dữ liệu theo từng trang, giúp việc phân trang dễ dàng hơn.
Để tìm hiểu thêm về cách phân trang và truyền trực tuyến dữ liệu, hãy tham khảo tài liệu hướng dẫn của Google Ads.
Tạo yêu cầu
Phương thức tìm kiếm SearchGoogleAdsRequest bao gồm các thuộc tính chính sau:
- customer_id: Mã nhận dạng khách hàng.
- Ngôn ngữ truy vấn Google Ads (query): Xác định tài nguyên cần truy vấn, các thuộc tính phân đoạn và chỉ số cần lấy, cũng như điều kiện để giới hạn đối tượng trả về trong phản hồi.
- page_size (chỉ dành cho GoogleAdsService.Search): Số lượng đối tượng sẽ trả về trong một phản hồi khi sử dụng tính năng phân trang.
- page_token (không bắt buộc, chỉ dành cho GoogleAdsService.Search): Dùng để truy xuất lô kết quả tiếp theo khi sử dụng phân trang.
Để biết thêm chi tiết về ngôn ngữ truy vấn của Google Ads, hãy tham khảo hướng dẫn về Ngôn ngữ truy vấn Google Ads.
Xử lý câu trả lời
GoogleAdsService trả về kết quả dưới dạng danh sách GoogleAdsRow.
Mỗi GoogleAdsRow đại diện cho một đối tượng được truy vấn và chứa các thuộc tính đã được điền dựa trên các trường được yêu cầu trong mệnh đề SELECT. Các thuộc tính không được chỉ định trong SELECT sẽ không có trong phản hồi.
Ví dụ, mặc dù ad_group_criterion có thuộc tính status, nhưng nếu mệnh đề SELECT không bao gồm ad_group_criterion.status, thì thuộc tính này sẽ không được điền vào phản hồi. Tương tự, các thuộc tính của campaign sẽ không có sẵn nếu SELECT không yêu cầu bất kỳ trường nào từ tài nguyên campaign.
Các hàng trong GoogleAdsRow có thể chứa các thuộc tính và chỉ số khác nhau, vì vậy các hàng này được xem như đối tượng thay vì các hàng cố định trong một bảng dữ liệu truyền thống.
Loại enum UNKNOWN
Các tài nguyên trả về có loại UNKNOWN không được hỗ trợ đầy đủ trong phiên bản API hiện tại. Những tài nguyên này thường được tạo thông qua giao diện người dùng Google Ads, và mặc dù bạn có thể truy xuất chỉ số liên quan đến chúng, bạn không thể thay đổi các tài nguyên này thông qua API. Ví dụ điển hình là một chiến dịch hoặc quảng cáo mới được tạo trong giao diện người dùng nhưng chưa được hỗ trợ trong phiên bản API mà bạn đang sử dụng.
Một số điểm cần lưu ý:
- Tài nguyên thuộc loại UNKNOWN có thể sẽ được hỗ trợ trong các phiên bản API tương lai hoặc có thể vẫn giữ trạng thái UNKNOWN mãi mãi.
- Các đối tượng UNKNOWN có thể xuất hiện bất kỳ lúc nào. Những đối tượng này tương thích ngược nhờ vào giá trị enum đã tồn tại. Khi tài liệu được cập nhật, bạn có thể kiểm tra chính xác trạng thái của tài khoản.
- Tài nguyên UNKNOWN có thể xuất hiện khi có các hoạt động mới trong tài khoản từ các giao diện khác hoặc khi một tài nguyên không còn được hỗ trợ trong API.
- Mặc dù có thể truy vấn chỉ số cho các tài nguyên UNKNOWN, chúng không thể được thay đổi qua API.
- Tài nguyên UNKNOWN vẫn hiển thị đầy đủ trong giao diện người dùng Google Ads.
Phân đoạn
Phản hồi từ API sẽ chứa một GoogleAdsRow cho mỗi tổ hợp sau:
- Thực thể của tài nguyên chính được chỉ định trong mệnh đề FROM.
- Giá trị của từng trường segment được chọn.
Ví dụ, nếu bạn truy vấn từ campaign và chọn các phân đoạn như segments.ad_network_type và segments.date trong mệnh đề SELECT, phản hồi sẽ chứa một hàng cho mỗi tổ hợp các giá trị sau:
- campaign
- segments.ad_network_type
- segments.date
Kết quả sẽ được tự động phân đoạn theo từng phiên bản của tài nguyên chính, thay vì dựa trên giá trị của từng trường cụ thể. Ví dụ:
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
Kết quả sẽ trả về một hàng cho mỗi chiến dịch, thay vì một hàng cho mỗi giá trị riêng lẻ của trường campaign.status.
Sử dụng GoogleAdsService không chỉ giúp bạn truy xuất các đối tượng và số liệu thống kê mà còn tối ưu hóa quy trình quản lý dữ liệu của bạn trong Google Ads. Dù bạn đang sử dụng Search để phân trang hoặc SearchStream để truy xuất hàng loạt dữ liệu, việc nắm vững cách thức hoạt động của dịch vụ này sẽ giúp cải thiện hiệu suất quảng cáo và đưa ra những quyết định chính xác hơn. Hãy chắc chắn rằng bạn tận dụng tối đa các tính năng của GoogleAdsService để theo dõi và quản lý chiến dịch một cách hiệu quả.
