Contoh Kasus Penggunaan Umum

Sekarang, mari kita lihat kasus penggunaan umum: meringkas performa akun selama 30 hari terakhir menurut 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 di atas ke antarmuka GoogleAdsService.SearchStream.

Poin Penting: Contoh ini menunjukkan permintaan HTTP yang mendasarinya hanya sebagai metode pengajaran; sebaiknya gunakan salah satu library klien untuk mengirimkan permintaan di aplikasi Anda sendiri.

URL permintaan HTTP

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

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

Contoh permintaan HTTP lengkap

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

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"
}

Contoh kode

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