Contoh Kasus Penggunaan Umum

Kasus penggunaan ini merangkum performa akun selama 30 hari terakhir menurut kampanye, yang dikelompokkan 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 Google Ads Query Language ini ke antarmuka GoogleAdsService.SearchStream.

URL permintaan HTTP

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

https://googleads.googleapis.com/v24/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 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"
}

Contoh kode

Tonton video panduan 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