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

Bây giờ, chúng ta hãy xem một trường hợp sử dụng phổ biến: tóm tắt hiệu suất của 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 chuyển câu lệnh Ngôn ngữ truy vấn Google Ads ở trên đến giao diện GoogleAdsService.SearchStream.

URL yêu cầu HTTP

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

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

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

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

POST /v17/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

Hãy xem video hướng dẫn từng bước về mã mẫu tìm kiếm các chiến dịch theo cá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ự như đối với tất cả các ngôn ngữ.