Nesne alma

GoogleAdsService, birleştirilmiş nesnedir alma ve raporlama hizmetine erişebilirsiniz. Hizmetin sunduğu yöntemler:

  • Nesnelerin belirli özelliklerini alın.
  • Tarih aralığına göre nesneler için performans metriklerini alın.
  • Nesneleri özelliklerine göre sıralayın.
  • 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ı şu şekilde döndürebilir: iki yol vardır:

  • GoogleAdsService.SearchStream tek bir akış yanıtında tüm satırları döndürür ve bu da büyük (10.000 satırdan fazla) sonuç kümelerinde yayınlanır. Bu daha uygun olabilir toplu uygulamanız mümkün olduğunca hızlı bir şekilde yapmasını sağlar.
  • GoogleAdsService.Search bölünüyor bunu yönetilebilir sonuç sayfalarına dönüştürmenize yardımcı olur. Bu daha iyi olabilir etkileşimli uygulamanız gerekir.

Sayfalara ayırma ve akış karşılaştırması hakkında daha fazla bilgi edinin.

İstekte bulunun

Arama yöntemi için Şunları içeren SearchGoogleAdsRequest şunlar olabilir:

  • customer_id
  • Hangi kaynağın sorgulanacağını, özellikleri vequery alınabilecek segmentler ve metrikler ile kısıtlama amacıyla kullanılacak koşullar hangi nesnelerin döndürüldüğüne
  • (yalnızca GoogleAdsService.Search) A page_size, tek bir yanıtta kaç nesne döndürüleceğini belirtmek için kullanılır. sayfalara ayırma işlevini kullanın.
  • (yalnızca GoogleAdsService.Search) An kullanırken bir sonraki sonuç grubunu almak için isteğe bağlı page_token sayfalama.

Google Ads Sorgu Dili hakkında daha fazla bilgi için Google Ads Sorgu Dili'ne göz atın. rehberini inceleyin.

Yanıtları işleme

GoogleAdsService, bir GoogleAdsRow nesne algılandı.

Her GoogleAdsRow, sorgu tarafından döndürülen bir nesneyi temsil eder ve Raporda istenen alanlara göre doldurulan bir özellik kümesi SELECT ifadesi. SELECT yan tümcesinde yer almayan özellikler dahil değildir yanıttaki GoogleAdsRow nesne için doldurulur.

Örneğin, ad_group_criterion bir status özelliğine sahip olsa da, Satırın ad_group_criterion özelliğinin status alanı, SELECT ifadesini içermeyen bir sorgu için yanıt ad_group_criterion.status. Benzer şekilde, satırın campaign özelliği de SELECT yan tümcesi campaign kaynak.

Her GoogleAdsRow başka bir satırdan farklı özelliklere ve metriklere sahip olabilir elde etmiş olursunuz. Bu nedenle, satırlar değil de nesneler olarak sabit satırlarda görüntülenebilir.

UNKNOWN sıralama türleri

UNKNOWN türüyle döndürülen kaynaklar şurada tam olarak desteklenmez: bu API sürümünü kullanın. Bu kaynaklar, diğer projelerde kullanılan Google Ads kullanıcı arayüzü gibi. Bir kaynakta mevcut olması durumunda UNKNOWN türünde, ancak kaynağı API aracılığıyla değiştiremezsiniz. Kullanıcı arayüzünde tanıtılan yeni bir kampanya veya reklam buna örnek olarak verilebilir. sorguladığınız API sürümünde desteklenmiyor.

Unutulmaması gereken bazı noktalar aşağıda belirtilmiştir:

  • UNKNOWN türündeki bir kaynak daha sonra desteklenebilir veya UNKNOWN olarak kalabilir koruyabilmelidir.
  • UNKNOWN türündeki yeni nesneler herhangi bir zamanda görünebilir. Bu nesneler enum değeri zaten mevcut olduğundan geriye dönük uyumludur. Kaynaklar kullanıma sunulduğunda bu değişiklikle birlikte kullanıma sunulmuştur. Böylece, doğru bir görünüm elde edersiniz. UNKNOWN kaynağı şu nedenlerle görünebilir: başka arayüzler üzerinden hesabınızdaki yeni etkinlikler veya bir kaynak artık desteklenmiyor.
  • UNKNOWN kaynağa, aşağıdaki koşulları karşılayan ayrıntılı metrikler eklenebilir: sorgulanabilir.
  • UNKNOWN kaynakları, Google Ads kullanıcı arayüzünde genellikle tamamen görünür durumdadır.
  • UNKNOWN kaynakları genellikle değiştirilemez.

Segmentasyon

Yanıt, her kombinasyon için bir GoogleAdsRow takip etmek için:

  • FROM yan tümcesinde belirtilen ana kaynağın örneği
  • Seçilen her segment alanının değeri

Örneğin, FROM campaign seçimini yapan ve SELECT yan tümcesindeki segments.ad_network_type ve segments.date şunların her kombinasyonu için bir satır içermelidir:

  • campaign
  • segments.ad_network_type
  • segments.date

Sonuçlar, örtülü bir şekilde ana kaynağın her örneğine göre segmentlere ayrılır. değerleri tek tek seçebilirsiniz. Örneğin,

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

kampanya başına bir satır olur, kampanya değeri başına bir satır değil campaign.status alanı için geçerlidir.

Önceki
Nesneleri değiştirme ve inceleme
Sonraki
Kaynak meta verileri