Yaygın Kullanım Örneği

Şimdi yaygın bir kullanım alanına göz atalım: Bir hesabın son 30 gün içindeki performansını kampanyaya göre, cihaza göre segmentlere ayırarak özetleme. Bu rapor için sorgu şu şekildedir:

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.

HTTP istek URL'si

İstek, aşağıdaki URL'deki Google Ads API sunucusuna gönderilen bir HTTP POST'tan oluşur:

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

Tam HTTP isteği örneği

Aşağıda, yukarıdaki rapor tanımının HTTP POST isteğine dahil edilmiş tam örneği verilmiştir.

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

Kod örnekleri

Son 7 güne ait metriklerle kampanyaları arayan bir kod örneğinin videolu açıklamalı kılavuzunu izleyin. Videodaki kod örneği Java dilinde yazılmıştır ancak işlem tüm diller için benzerdir.