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ủ Google Ads API tại URL sau:

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

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

Sau đây là ví dụ đầy đủ về định nghĩa báo cáo này, được đặt trong một yêu cầu HTTP POST.

POST /v21/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 về một mẫu mã tìm kiếm chiến dịch có cá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ự cho tất cả các ngôn ngữ.