Ví dụ về trường hợp sử dụng phổ biến

Bây giờ, chúng ta hãy xem xét một trường hợp sử dụng phổ biến: tóm tắt hiệu suất của một tài khoản trong 30 ngày qua theo chiến dịch, được phân đoạn theo thiết bị. Truy vấn cho báo cáo này như sau:

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Để gửi yêu cầu này, hãy chuyển câu lệnh Ngôn ngữ truy vấn Google Ads ở trên sang giao diện GoogleAdsService.SearchStream.

Lưu ý quan trọng: Ví dụ này chỉ cho thấy yêu cầu HTTP cơ bản dưới dạng một phương thức giảng dạy. Bạn nên sử dụng một trong các thư viện ứng dụng để gửi yêu cầu trong chính ứng dụng của mình.

URL yêu cầu HTTP

Yêu cầu này bao gồm một yêu cầu POST qua HTTP gửi tới máy chủ API Google Ads tại URL sau:

https://googleads.googleapis.com/v16/customers/{customer_id}/googleAds:searchStream

Mẫu yêu cầu HTTP hoàn tất

Dưới đây là một ví dụ hoàn chỉnh về định nghĩa báo cáo ở trên, được đính kèm trong yêu cầu POST qua HTTP.

POST /v16/customers/{customer_id}/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]
developer-token: [Enter developerToken here]

Parameters:
{
  "query" : "SELECT campaign.name, campaign.status, segments.device,
                    metrics.impressions, metrics.clicks, metrics.ctr,
                    metrics.average_cpc, metrics.cost_micros
            FROM campaign
            WHERE segments.date DURING LAST_30_DAYS"
}

Mã mẫu

Xem video hướng dẫn từng bước về mã mẫu giúp tìm kiếm các chiến dịch có chỉ số trong 7 ngày qua. Mã mẫu trong video được viết bằng Java, nhưng quy trình này là tương tự cho tất cả ngôn ngữ.