Nesne alma

GoogleAdsService, Google Ads API'nin birleştirilmiş nesne alma ve raporlama hizmetidir. Hizmetin şu yöntemleri vardır:

• Nesnelerin belirli özelliklerini alma
• Nesnelerin performans metriklerini bir tarih aralığına göre alma.
• Nesneleri özelliklerine göre sıralama
• Yanıtta hangi nesnelerin döndürülmesini istediğinizi belirtmek için koşulları kullanın.
• Döndürülen nesne sayısını sınırlayın.

GoogleAdsService, sonuçları iki şekilde döndürebilir:

• GoogleAdsService.SearchStream 10.000'den fazla satır içeren büyük sonuç kümeleri için daha verimli olan tek bir akış yanıtında tüm satırları döndürür. Bu yöntem, toplu uygulamanızın mümkün olduğunca hızlı bir şekilde olabildiğince fazla veri indirmesini istiyorsanız daha uygun olabilir.
• GoogleAdsService.Search, büyük yanıtları yönetilebilir sonuç sayfalarına böler. Etkileşimli uygulamanız sonuçları tek tek gösteriyorsa bu daha uygun olabilir.

Sayfalama ve akış hakkında daha fazla bilgi edinin.

İstekte bulunun

Arama yöntemi, aşağıdaki özelliklerden oluşan bir SearchGoogleAdsRequest gerektirir:

• customer_id
• Hangi kaynağın sorgulanacağını, alınacak özellikleri, segmentleri ve metrikleri ve hangi nesnelerin döndürüleceğini kısıtlamak için kullanılacak koşulları belirten bir Google Ads Sorgu Dili query
• (Yalnızca GoogleAdsService.Search) Sayfalama kullanılırken sonraki sonuç grubunu almak için isteğe bağlı page_token.

Google Ads Sorgu Dili hakkında daha fazla bilgi için Google Ads Sorgu Dili kılavuzunu inceleyin.

Yanıt işleme

GoogleAdsService, GoogleAdsRow nesnelerinin listesini döndürür.

Her GoogleAdsRow, bir sorgu tarafından döndürülen bir nesneyi temsil eder ve SELECT ifadesinde istenen alanlara göre doldurulan bir dizi özellikten oluşur. SELECT ifadesine dahil edilmeyen özellikler, yanıttaki GoogleAdsRow nesnelerinde doldurulmaz.

Örneğin, bir ad_group_criterion öğesinin status özelliği olmasına rağmen, SELECT ifadesinin ad_group_criterion.status öğesini içermediği bir sorguya verilen yanıtta satırın ad_group_criterion özelliğinin status alanı doldurulmaz. Benzer şekilde, SELECT ifadesi campaign kaynağındaki herhangi bir alanı içermiyorsa satırın campaign özelliği doldurulmaz.

Aynı sonuç kümesindeki her GoogleAdsRow, başka bir satırdan farklı özelliklere ve metriklere sahip olabilir. Bu nedenle satırlar, tablonun sabit satırları yerine nesneler olarak görüntülenmelidir.

UNKNOWN sıralama türleri

UNKNOWN türüyle döndürülen kaynaklar, söz konusu API sürümünde tam olarak desteklenmez. Bu kaynaklar, Google Ads kullanıcı arayüzü gibi diğer arayüzler aracılığıyla oluşturulmuş olabilir. Bir kaynağın türü UNKNOWN olduğunda metrikleri seçebilirsiniz ancak kaynağı API üzerinden değiştiremezsiniz. Buna örnek olarak, kullanıcı arayüzünde kullanıma sunulan ancak sorguladığınız API sürümünde desteklenmeyen yeni bir kampanya veya reklam verilebilir.

Aşağıda dikkat edilmesi gereken noktalardan bazılarını görebilirsiniz:

• UNKNOWN türündeki bir kaynak daha sonra desteklenebilir veya süresiz olarak UNKNOWN kalabilir.
• UNKNOWN türündeki yeni nesneler herhangi bir zamanda görünebilir. Numaralandırma değeri zaten mevcut olduğundan bu nesneler geriye dönük olarak uyumludur. Bu değişiklikle birlikte, hesabınızla ilgili doğru bir görünüm elde edebilmeniz için kaynaklar kullanıma sunulur. UNKNOWN kaynağı, hesabınızda diğer arayüzler üzerinden yapılan yeni işlemler nedeniyle veya bir kaynak artık desteklenmediğinde görünebilir.
• UNKNOWN kaynaklarına, sorgulanabilir ayrıntılı metrikler eklenebilir.
• UNKNOWN kaynakları genellikle Google Ads kullanıcı arayüzünde tamamen görünür.
• UNKNOWN kaynakları genellikle değiştirilemez.

Segmentasyon

Yanıtta, aşağıdakilerin her bir kombinasyonu için bir GoogleAdsRow bulunur:

• FROM ifadesinde belirtilen ana kaynağın örneği
• Seçilen her segment alanın değeri

Örneğin, FROM campaign öğesini seçen ve SELECT ifadesinde segments.ad_network_type ile segments.date öğelerini içeren bir sorgunun yanıtı, aşağıdakilerin her kombinasyonu için bir satır içerir:

• campaign
• segments.ad_network_type
• segments.date

Sonuçlar, seçilen alanların değerlerine göre değil, ana kaynağın her bir örneğine göre örtülü olarak segmentlere ayrılır. Örneğin,

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

campaign.status alanının her farklı değeri için bir satır yerine kampanya başına bir satırla sonuçlanır.