Google Ads API'nin 24. sürümü kullanıma sunuldu

22 Nisan 2026, Çarşamba

Bugün, Google Ads API'nin 24. sürümünü duyuruyoruz. Yeni v24 özelliklerini kullanmak için istemci kitaplıklarınızı ve istemci kodunuzu yükseltmeniz gerekir. Güncellenen tüm istemci kitaplıkları ve kod örnekleri yayınlandı.

Yarın (23 Nisan, 10:00 ET) Discord'daki "Google Ads API Sürümünde Öne Çıkanlar" etkinliğimizde, Ads Developers YouTube Live yayınımızda veya LinkedIn Live etkinliğimizde bu sürümün canlı tanıtımına katılın. Canlı etkinliklere katılamayanlar için bu etkinlikler kaydedilip YouTube'da yayınlanacak. Sorularınız varsa veya bu yayın hakkında görüşmek isterseniz Discord'daki #ads-api kanalından bize ulaşabilirsiniz.

Yeni özellikler

Alışveriş sepeti verileriyle dönüşüm desteği: Alışveriş sepeti verileriyle dönüşüm, web sitenizdeki veya uygulamanızdaki dönüşüm izlemenin bir uzantısıdır. Alışveriş sepeti verileriyle dönüşüm özelliğini kullanarak her işlem için satılan ürünlerin ayrıntılarını sağlayabilirsiniz. Bu sayede Google Ads hesabınız ve kampanyalarınız için gelişmiş satış, kâr raporlama ve analizlerden (ör. sipariş sayısı, ortalama alışveriş sepeti boyutu, gelir ve brüt kâr) yararlanmaya başlayabilirsiniz.

Google Ads API v24, bu özellik için aşağıdaki şekilde destek ekler:

  • Dönüşüm metriklerini yalnızca ürün tıklamasına göre değil, aynı zamanda satılan ürüne göre de segmentlere ayırmanıza olanak tanıyan yeni bir kaynak (CartDataSalesView) eklendi. Bu kaynak, product_sold_brand gibi segmentler içerir. Bu sayede reklamverenler, reklam farklı bir ürün için olsa bile müşterilerin reklamları tıkladıktan sonra satın aldığı ürünlerle ilgili istatistikleri görüntüleyebilir.
  • Kampanyalarınızın aktif olarak optimize edilmediği dönüşümleri de içeren birkaç "tüm" teklif verilemeyen metrik (ör. all_cost_of_goods_sold_micros) eklendi. Yeni metrikler, ilgili teklif verilebilir metrikleri destekleyen tüm kaynaklara eklenir.
  • conversion_attribution_event_type segmenti ShoppingPerformanceView kaynağına eklendi. Böylece alışveriş sepeti verileri ve diğer dönüşüm metrikleriyle seçilebilir hale geldi. Bu segment, dönüşümün bir tıklamayla mı yoksa görüntülemeyle mi ilişkilendirildiğini belirtir ve görüntüleme dönüşümleri tarafından oluşturulan alışveriş sepeti verileri istatistiklerini tanımak için gereklidir.

Güncellenen özellikler

v24 sürümü, yükseltme sırasında kod değişiklikleri gerektiren mevcut özelliklerde güncellemeler içerir. Burada en önemli değişiklikleri ele alıyoruz. Değişikliklerin tam listesi için sürüm notlarına göz atın.

Kampanyalarda video içeriği hariç tutma ayarları: Ayrı ayrı kampanyalarda video içeriği hariç tutma ayarlarını belirleme sürecini basitleştirdik. Bu ayar müşteri düzeyinde kullanılabilir ve tüm kampanyalar için geçerlidir. Bu içerik hariç tutma ayarları, size daha fazla kontrol olanağı sunmayı ve politikalarımıza uysa bile markanıza veya işletmenize uygun olmayabilecek içerik türlerini hariç tutmanızı sağlamayı amaçlar. Video içeriği hariç tutma ayarları hakkında daha fazla bilgi edinmek için https://support.google.com/google-ads/answer/7515513 adresini ziyaret edin.

AudienceInsightsService'te yapılan değişiklikler: Kodun yeniden düzenlenmesi kapsamında, InsightsAudience.topic_audience_combinations istek alanını common ad alanına taşıdık. Bazı programlama dillerinde içe aktarma yönergelerinizi güncellemeniz gerekebilir.

ReachPlanService'te yapılan değişiklikler: Kodun yeniden düzenlenmesi kapsamında, youtube_select_lineups alanını ReachPlanService.ListPlannableProducts hizmetinden taşıdık. Kanal listeleri artık youtube_select_lineup_targeting alanında kullanılabilir. YouTube Select kanal listeleri uygun müşterilerin, YouTube'da yer alan ve belirli pazarlardaki en tutkulu kitlelere sahip en popüler %1'lik dilimde bulunan kanalları hedeflemesini sağlayan, rezervasyona dayalı ürünlerdir. Daha fazla bilgi edinin.

ContentCreatorInsightsService'te yapılan değişiklikler: Kodun yeniden düzenlenmesi kapsamında, ContentCreatorInsightsService.GenerateCreatorInsights ve ContentCreatorInsightsService.GenerateTrendingInsights hizmetlerinden is_brand_connect_creator alanını kaldırdık.
Kullanıcılar bunun yerine partnership_opportunities içinde CREATOR_PARTNERSHIPS seçeneğinin kullanılabilir olduğu bir içerik üretici aramalıdır. Google Ads'deki YouTube İçerik Üretici İş Ortaklıkları, sponsorlu içerik konusunda iş ortaklığı yapabileceğiniz YouTube içerik üreticilerinin bulunabileceği ve içerik üretici iş ortaklıklarınızı verimli bir şekilde yönetebileceğiniz bir alandır. Daha fazla bilgi edinin.

KeywordPlanIdeaService'te yapılan değişiklikler: Daha akıcı ve güvenilir bir deneyim sunmak için öngörme altyapımızı birleştirdik. Google Ads API v24, performansınızı en doğrudan etkileyen metriklere odaklanarak planlama sürecini basitleştiren güncellenmiş bir GenerateKeywordForecastMetrics yöntemi sunar. Önümüzdeki günlerde bu değişiklikle ilgili daha ayrıntılı bir blog yayını paylaşacağız.

campaign_budget kaynağında yapılan değişiklikler: Bu görünümle uyumlu olmadığı için campaign_budget kaynağının ad_sub_network_type segmentini kaldırdık.

Öğe görünümlerinde yapılan değişiklikler: click_type segmentini ad_group_asset, campaign_asset ve customer_asset görünümlerinden kaldırdık. Bu değişiklik, verilerin yanlış beyan edilmesini önlemek için bu segmenti Google Ads'den kaldıran yeni bir ürün değişikliğiyle uyumludur. Reklam performansı ve reklamın yayınlandığı öğe hakkında ayrıntılı bilgi edinmek için ad_group_ad kaynağından click_type segmentasyonunu kullanabilirsiniz.

Video duyarlı reklamda yapılan değişiklikler: VideoResponsiveAdInfo artık sessize alınabilir. Bu değişiklik kapsamında, hem DemandGenVideoResponsiveAdInfo hem de VideoResponsiveAdInfo nesnelerinde videos, business_name ve logo_images alanlarını zorunlu olarak işaretledik.

ShareablePreviewService'te yapılan değişiklikler: ShareablePreviewService.GenerateShareablePreviews, artık kısmi hatayı kullanmayacak şekilde güncellendi. Herhangi bir kimlik için başarısız olan istekler hata verir. Daha fazla bilgi edinin.

Aşağıdaki kaynaklar, başlangıç aşamasında yardımcı olabilir:

Teknik destek sorunları için https://support.google.com/google-ads/contact/google_ads_api adresinden bize ulaşın.

Yazarın portresi - Oommen, Google Ads API Ekibi

Etiketler: google-ads-api, release