Yaygın Kullanım Örneği

Bu kullanım alanında, bir hesabın son 30 gün içindeki performansı kampanyaya göre ve cihaza göre segmentlere ayrılarak özetlenmiştir. Bu raporun sorgusu ş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 bu Google Ads sorgu dili ifadesini GoogleAdsService.SearchStream arayüzüne iletin.

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

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/v20/customers/{customer_id}/googleAds:searchStream

Tam HTTP isteği örneği

Aşağıda, bir HTTP POST isteğine yerleştirilmiş bu rapor tanımının tam örneği verilmiştir.

POST /v20/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. Bu kod örneği Java'da yazılmıştır ancak süreç tüm diller için benzerdir.