Nesne alma

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

• Nesnelerin belirli özelliklerini alma
• Nesnelerin performans metriklerini 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, tüm satırları tek bir akış yanıtında döndürür. Bu,büyük (10.000 satırdan fazla) sonuç kümeleri için daha verimlidir. Uygulamanız tam sonuç kümelerini indiriyorsa veya satırları akış olarak işliyorsa bu önerilir.
• GoogleAdsService.Search, büyük yanıtları yönetilebilir sonuç sayfalarına böler. Etkileşimli uygulamanız her seferinde bir sonuç sayfası gösteriyorsa bu yöntem yararlı olur.

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

İstekte bulunun

GoogleAdsService.SearchStream, SearchGoogleAdsStreamRequest ve GoogleAdsService.Search, SearchGoogleAdsRequest bekler. Her iki istek türü de şunları içerir:

• customer_id
• Sorgulanacak kaynağı, alınacak özellikleri, segmentleri ve metrikleri, döndürülen nesneleri kısıtlamak için kullanılacak koşulları belirten bir Google Ads Sorgu Dili query

Yönteme bağlı olarak istek, yönteme özgü alanları da destekler:

• SearchGoogleAdsStreamRequest (yalnızca SearchStream):
  • Toplu metrikleri içeren bir özet satırı istemek için isteğe bağlı summary_row_setting
• SearchGoogleAdsRequest (yalnızca Search):
  • Sayfalandırma kullanılırken bir sonraki sonuç grubunu almak için isteğe bağlı bir page_token (page_size, 10.000 satır olarak sabitlenmiştir; istekte page_size ayarlanması RequestError.PAGE_SIZE_NOT_SUPPORTED hatasına neden olur)
  • return_summary_row, return_total_results_count ve omit_results yapılandırmak için isteğe bağlı bir search_settings mesajı
  • Sorguyu yürütmeden doğrulamak için isteğe bağlı bir validate_only Boole değeri

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 bir listesini döndürür (akışlı SearchGoogleAdsStreamResponse grupları içinde veya sayfalı SearchGoogleAdsResponse içinde).

Her GoogleAdsRow, bir sorgu tarafından döndürülen nesneyi temsil eder ve SELECT yan tümcesinde istenen alanlara göre doldurulan bir özellik grubundan oluşur. SELECT yan tümcesine dahil edilmeyen özellikler, yanıttaki GoogleAdsRow nesnelerinde doldurulmaz.

Örneğin, bir ad_group_criterion öğesinin status özelliği olsa da satırın ad_group_criterion özelliğinin status alanı, SELECT ifadesinin ad_group_criterion.status öğesini içermediği bir sorgunun yanıtında doldurulmaz. Benzer şekilde, SELECT yan tümcesi campaign kaynağından herhangi bir alan içermiyorsa satırın campaign özelliği doldurulmaz.

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

UNKNOWN ve UNSPECIFIED enum türleri

UNKNOWN enum değeriyle döndürülen kaynaklar, ilgili API sürümünde tam olarak desteklenmez. UNSPECIFIED ise bir enum alanının ayarlanmadığını veya SELECT yan tümcesinde istenmediğini gösterir. UNKNOWN enum değerine sahip 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. Kullanıcı arayüzünde bulunan ancak sorguladığınız API sürümünde desteklenmeyen bir kampanya veya reklam türü buna örnek olarak verilebilir.

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

• UNKNOWN türüne sahip bir kaynak, sonraki bir API sürümünde desteklenebilir veya süresiz olarak UNKNOWN kalabilir.
• UNKNOWN türünde yeni nesneler her an görünebilir. Bu nesneler, API'deki her enum'da UNKNOWN enum değeri bulunduğu için geriye dönük uyumludur. Kaynaklar, hesabınızın genel performans metriklerini doğru bir şekilde görebilmeniz için UNKNOWN ile döndürülür.
• 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 API aracılığıyla değiştirilemez.

Segmentasyon

Yanıt, aşağıdakilerin her kombinasyonu için bir GoogleAdsRow içerir:

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

Örneğin, FROM campaign seçen ve SELECT yan tümcesinde segments.ad_network_type ile segments.date bulunan 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 her bir alanın değerlerine göre değil, ana kaynağın her bir örneğine göre örtük 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 bir farklı değeri için bir satır değil, her kampanya için bir satır döndürür.