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

Để đưa ra yêu cầu này, hãy truyền câu lệnh Ngôn ngữ truy vấn Google Ads ở trên vào 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 hướng dẫn; 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 ứng dụng của riêng 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 đến máy chủ API Google Ads tại URL sau:

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

Mẫu yêu cầu HTTP hoàn chỉnh

Dưới đây là ví dụ đầy đủ về định nghĩa báo cáo ở trên, được đưa vào yêu cầu POST HTTP.

POST /v19/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ột 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 tương tự đối với tất cả ngôn ngữ.