Yaygın Kullanım Örneği

Şimdi yaygın bir kullanım alanına bakalım: Bir hesabın son 30 gün içindeki performansını kampanyaya göre, cihaza göre segmentlere ayrılmış şekilde özetlemek. Bu rapor için sorgu aşağıdaki gibidir:

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

Bu isteği göndermek için yukarıdaki Google Ads Sorgu Dili ifadesini GoogleAdsService.SearchStream arayüzüne iletin.

Önemli Nokta: Bu örnekte, temel HTTP isteği yalnızca bir öğretim yöntemi olarak gösterilmektedir. Kendi uygulamanızda istek göndermek için istemci kitaplıklarından birini kullanmanızı önemle tavsiye ederiz.

HTTP istek URL'si

İstek, aşağıdaki URL'de Google Ads API sunucusuna giden bir HTTP POST'undan oluşur:

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

Tam HTTP isteği örneği

Yukarıdaki rapor tanımının tam örneğini bir HTTP POST isteği içinde bulabilirsiniz.

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

Kod örnekleri

Son 7 günde metrikler içeren kampanyalarda arama yapan bir kod örneğinin adım adım açıklamalı videosunu izleyin. Videodaki kod örneği Java'da yazılmıştır ancak süreç tüm dillerde benzerdir.