Contoh Kasus Penggunaan Umum

Studi kasus ini merangkum performa akun selama 30 hari terakhir berdasarkan kampanye, yang disegmentasikan menurut perangkat. Kueri untuk laporan ini adalah sebagai berikut:

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

Untuk mengeluarkan permintaan ini, teruskan pernyataan Bahasa Kueri Google Ads ini ke GoogleAdsService.SearchStream antarmuka.

URL permintaan HTTP

Permintaan terdiri dari POST HTTP ke server Google Ads API di URL berikut:

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

Ganti {customer_id} dengan ID akun Google Ads tertentu yang ingin Anda kueri. Jangan sertakan tanda hubung dalam ID. Jika ingin mengambil data untuk sub-akun, Anda harus menggunakan ID sub-akun tersebut. Mengirim kueri dengan ID akun pengelola hanya akan menampilkan data yang dimiliki langsung oleh akun pengelola tersebut dan tidak menyertakan data dari sub-akunnya.

Contoh permintaan HTTP lengkap

Berikut adalah contoh lengkap definisi laporan ini, yang disertakan dalam permintaan POST HTTP.

POST /v25/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"
}

Contoh kode

Tonton panduan video contoh kode yang menelusuri kampanye dengan metrik selama 7 hari terakhir. Contoh kode ini ditulis dalam Java, tetapi prosesnya serupa untuk semua bahasa.

Sebelumnya
Ringkasan
Berikutnya
Metrik kriteria