我們現在來看看常見的用途:按廣告活動和裝置區隔,匯總帳戶過去 30 天的成效。這份報表的查詢如下:
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
如要提出這項要求,請將上述 Google Ads 查詢語言陳述式傳遞至 GoogleAdsService.SearchStream
介面。
HTTP 要求網址
這項要求包含 HTTP POST,可將要求傳送至下列網址的 Google Ads API 伺服器:
https://googleads.googleapis.com/v19/customers/{customer_id}/googleAds:searchStream
完整 HTTP 要求範例
以下是上述報表定義的完整範例,已封裝在 HTTP POST 要求中。
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" }
程式碼範例
觀看影片,瞭解如何使用程式碼範例搜尋過去 7 天內含有指標的廣告活動。影片中的程式碼範例是以 Java 編寫,但所有語言的處理程序都類似。