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 của 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/v24/customers/{customer_id}/googleAds:searchStream

Thay thế {customer_id} bằng mã nhận dạng của tài khoản Google Ads cụ thể mà bạn muốn truy vấn. Không thêm dấu gạch ngang vào mã nhận dạng. Nếu muốn truy xuất dữ liệu cho một tài khoản phụ, bạn phải sử dụng mã nhận dạng của tài khoản phụ đó. Chỉ truy vấn bằng mã tài khoản người quản lý mới trả về dữ liệu thuộc sở hữu trực tiếp của tài khoản người quản lý đó và không bao gồm dữ liệu từ tài khoản phụ.

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 /v24/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ã mẫu 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ữ.