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

Trường hợp sử dụng này 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 này đến giao diện GoogleAdsService.SearchStream.

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/v20/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 này, được đưa vào yêu cầu POST HTTP.

POST /v20/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 này được viết bằng Java, nhưng quy trình này tương tự đối với tất cả các ngôn ngữ.