Sürüm notları

24.1 sürümü (13.05.2026)

v24.1'e aşağıdaki yeni özellikler ve güncellemeler eklendi.

Reklamlar

• classic_display_images alanı DemandGenMultiAssetAd'a eklendi. Bunlar, ek öğe gerektirmeden ve duyarlı reklam biçimlerinin bir parçası olmadan yayınlanan özel olarak yüklenmiş resimlerdir.

Genel

• CustomerUserAccess.passkey_enabled, CustomerUserAccess kaynağına eklendi. Bu salt okunur alan, kullanıcının geçiş anahtarı etkinleştirip etkinleştirmediğini gösterir.

Denemeler

• Aşağıdaki yeni ExperimentTypeEnum türleri için destek eklendi:
  • ADOPT_AI_MAX: AI Max'in Google AI ve geniş eşlemeli anahtar kelimeler aracılığıyla daha fazla müşteriyle etkileşim kurmanıza nasıl yardımcı olabileceğini test eden denemeler için.
  • ADOPT_BROAD_MATCH_KEYWORDS: Geniş eşlemeli anahtar kelimelerin, reklamlarınızın gösterildiği arama sayısını nasıl etkileyebileceğini test eden denemeler için.
  • OPTIMIZE_ASSETS: Öğeleri optimize etmeye yönelik özel denemeler için.
  • PMAX_REPLACEMENT_SHOPPING: Alışveriş kampanyalarınızın Maksimum Performans'a kıyasla nasıl performans gösterdiğini test eden denemeler için.
• Experiment'daki yeni video_experiment alanı kullanılarak video kampanyalarından oluşan mevcut YOUTUBE_CUSTOM denemeleri için yapılandırma desteği eklendi.
• Öğe testi, öğe grupları ve Maksimum Performans deneme ayarlarını desteklemek için ExperimentArm'ye aşağıdaki alanlar eklendi:
  • asset_testing_info: Reklamların deneysel kopyalarıyla ilişkili öğelerin ayrıntıları.
  • asset_groups: Optimize denemeleri için deneme kolundaki öğe gruplarının listesi.
  • performance_max_experiment_arm_info: PMAX_REPLACEMENT_SHOPPING denemelerindeki Maksimum Performans kampanyaları için ayarlar.

Raporlar

• Cihazın platformuna (ör. iOS veya Android) göre segmentlere ayrılmış raporlamaya olanak tanıyan mobile_device_platform segmenti için destek eklendi.

• REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED öğesini yayınlayın.

  Sorgudaki tarih aralığı için istenen zaman ayrıntı düzeyi desteklenmiyor. Günlük, saatlik veya haftalık segmentlere ayrılmış metrikler yalnızca son 37 ay için kullanılabilir.

• Dikey reklamlar için kullanılacak aşağıdaki segmentler eklendi:

  • vertical_ads_listing_user_rating
  • vertical_ads_listing_venue

• SharedCriterion kaynağı için VerticalAdsItemGroupRuleInfo'da user_rating, venue ve event_participant_display_name'ye göre filtreleme desteği eklendi.

• Yedi temel metrik ailesinde deneme metrikleri için destek eklendi:

  • Tıklamalar
  • Gösterimler
  • Maliyet
  • Dönüşümler
  • Dönüşüm başına maliyet
  • Dönüşüm değeri
  • Maliyet başına dönüşüm değeri

  Temel metrik ailelerinin her biri için aşağıdaki alanlar kullanılabilir:

  • control_metric (örneğin, Metrics.control_clicks): Kontrol kolundaki metrik değeri.
  • metric (ör. Metrics.clicks): Deney kolundaki metrik değeri.
  • metric_point_estimate (örneğin, Metrics.clicks_point_estimate): Kollar arasındaki farkın nokta tahmini.
  • metric_margin_of_error (örneğin, Metrics.clicks_margin_of_error): Farkın hata payı.
  • metric_p_value (örneğin, Metrics.clicks_p_value): Farkın p değeri. 0,05'e eşit veya daha düşük bir p değeri, %95 veya daha yüksek bir güven düzeyini gösterir.

• Metrics.conversions_absolute_change_point_estimate, Metrics.conversions_absolute_change_margin_of_error, ve Metrics.conversions_absolute_change_p_value için destek eklendi.

Hedefleme

• CANNOT_EXCLUDE_ALL_TARGETS, CriterionErrorEnum'a eklendi. Bu hata, izin verilmeyen bir işlem olan tüm demografik hedeflemeleri hariç tutmaya çalışıldığında döndürülür.

Videolar

• Üçüncü taraf görüntülenebilirlik entegrasyon iş ortağı olarak ZEFR yayınlayın.
• Veri bağlantısıyla ilişkili YouTube kanal kimliğini göstermek için DataLink kaynağındaki youtube_video alanına channel_id eklendi.

24 sürümü (22.04.2026)

v24'e aşağıdaki yeni özellikler ve güncellemeler eklendi.

Yardım için En yeni sürüme yükseltme başlıklı makaleyi inceleyin.

Reklamlar

Aşağıdaki alanlar artık zorunludur:

• DemandGenVideoResponsiveAdInfo nesnesinde:

  • videos
  • logo_images

• VideoResponsiveAdInfo nesnesinde:

  • videos
  • business_name
  • logo_images

  VideoResponsiveAdInfo artık değiştirilebilir.

Öğeler

• travel_feed_data alanı, AssetSet kaynağına eklendi. Bu yeni alan, seyahat feed'i öğe kümesinden seyahat feed'i verilerinin okunmasına olanak tanır. Ayrıca hotel_center_account_id, merchant_center_id, partner_center_id, subset_id ve travel_feed_vertical_type gibi salt okunur bilgileri kullanıma sunar.

Kampanyalar

• Campaign.video_brand_safety_suitability alanı kaldırıldı. Kontrol, müşteri düzeyinde kullanılmaya devam eder. Customer.video_brand_safety_suitability sayfasına göz atın.
• Talep Yaratma ve uygulama kampanyalarında GD (görüntüleme dönüşümü) optimizasyonunun etkinleştirilmesine olanak tanımak için varsayılan olarak false olan Campaign.view_through_conversion_optimization_enabled alanı eklendi.
• Maksimum Performans kampanyaları için cinsiyet hariç tutmaları etkinleştirildi. Bu hariç tutma artık tüm Google Ads API sürümlerindeki Maksimum Performans kampanyalarında kullanılabilir.

Dönüşümler

• Potansiyel müşteri kazanma dönüşümü türleri için destek eklendi. Bunlar, v24'teki yeni ConversionActionType. numaralandırmalarıdır:

  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD

• LOYALTY_SIGN_UPS kullanıcı listesi müşteri türü kategorisi kaldırıldı.

Genel

• Mevcut bir kitleye benzeyen ve onunla aynı olan bir kitle oluşturmaya çalışırken döndürülen UserListErrorEnum.DUPLICATE_LOOKALIKE eklendi.UserList

Planlama

• InsightsAudience.topic_audience_combinations tür tanımı InsightsAudienceAttributeGroup olarak değiştirildi. common.InsightsAudienceAttributeGroup. Türü belirlenmiş istemci kitaplıkları için bu, mevcut entegrasyonlarda değişiklik yapılması gereken bir hataya neden olan değişikliktir.

• youtube_select_lineups alanı, ReachPlanService.ListPlannableProducts hizmetinden kaldırıldı.

  Kullanıcılar, youtube_select_lineup_targeting'den derleme kullanmaya geçmelidir.

• is_brand_connect_creator alanı, ContentCreatorInsightsService.GenerateCreatorInsights ve ContentCreatorInsightsService.GenerateTrendingInsights hizmetlerinden kaldırıldı.

  Bunun yerine, kullanıcılar CREATOR_PARTNERSHIPS seçeneğinin partnership_opportunities içinde kullanılabilir olduğu bir içerik üretici bulmalıdır.

• Planlanabilir her ürün hakkında daha fazla ayrıntı eklemek için ReachPlanService.ListPlannableProducts yanıtına yeni alanlar eklendi. Bu alanların çoğu, ListPlannableProductsResponse içindeki yeni ProductCoreAttributes alanında döndürülür. Yeni yanıt alanları:

  • ProductMetadata.plannable_product_description
  • ProductCoreAttributes.marketing_objective
  • ProductCoreAttributes.cost_model
  • ProductCoreAttributes.buying_method

• KeywordPlanIdeaService.GenerateKeywordForecastMetrics alanından çeşitli alanlar kaldırıldı:

  • CampaignToForecast.geo_modifiers[], CampaignToForecast.geo_target_constants[] ile değiştirildi.
  • ForecastAdGroup.biddable_keywords[], ForecastAdGroup.keywords[] ile değiştirildi.
  • CampaignToForecast.keyword_plan_network
  • CampaignToForecast.negative_keywords
  • ForecastAdGroup.max_cpc_bid_micros
  • ForecastAdGroup.negative_keywords
  • BiddableKeyword
  • CriterionBidModifier
  • KeywordForecastMetrics.impressions
  • KeywordForecastMetrics.click_through_rate

Raporlar

• campaign_budget kaynağı için ad_sub_network_type segmenti kaldırıldı.
• click_type segmenti AdGroupAsset, CampaignAsset ve CustomerAsset görünümlerinden kaldırıldı.
• Yeni bir kaynak CartDataSalesView eklendi. Bu özellik, dönüşüm metriklerinin yalnızca tıklanan ürüne göre değil, aynı zamanda satılan ürüne göre de segmentlere ayrılmasına olanak tanır. Örneğin, product_sold_brand gibi segmentler kullanılabilir.
• Teklif verilebilir olmayan metrikler eklendi. Bu metrikler, kampanyalarınızın aktif olarak optimize etmediği dönüşümleri de içerir. Örneğin all_cost_of_goods_sold_micros. Yeni metrikler, ilgili teklif verilebilir metrikleri destekleyen tüm kaynaklara eklenir.
• conversion_attribution_event_type segmenti, ShoppingPerformanceView kaynağına eklendi.

Alışveriş

• ShoppingProduct kaynağında uygulama kampanyaları için destek eklendi. status ve issues alanlarının uygulama kampanyalarında desteklenmediğini unutmayın.
• Alışveriş kampanyaları için mantıksal ifadeler kullanılarak etiket tabanlı ürün filtreleme özelliği kullanıma sunuldu.
  • RETAIL_FILTER_BUNDLE ve RETAIL_FILTER ölçüt türleri eklendi.
  • RETAIL_FILTER, yeni bir SharedSetType olarak eklendi.
  • AdGroupCriterion artık retail_filter_bundle alanını kullanarak RETAIL_FILTER türünde bir SharedSet öğesine bağlantı verebilir.
  • SharedCriterion artık retail_filter alanını kullanarak SharedSet içinde ayrı etiket kuralları veya ifadeler tanımlayabilir.
  • ListingGroupFilterListingSource listesine RETAIL eklendi.
  • AssetGroupListingGroupFilter raporuna RetailFilter boyutu eklendi.
  • Doğrulama için CriterionError ve AssetGroupListingGroupFilterError'a yeni hata kodları eklendi.
  • Bu özellik yalnızca izin verilenler listesindeki kullanıcılar tarafından kullanılabilir.

Videolar

• ShareablePreviewService.GenerateShareablePreviews, artık kısmi hata kullanmayacak şekilde güncellendi. İstekler herhangi bir kimlik için başarısız olursa hata verir. Reklam grubu reklam hatalarıyla uyumlu olması için öğe gruplarıyla ilgili yeni hata kodları döndürülüyor:
  • MutateErrorEnum.RESOURCE_NOT_FOUND yerine ShareablePreviewError.ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER
  • ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST yerine ShareablePreviewError.TOO_MANY_ASSET_GROUPS_IN_REQUEST

23.2 sürümü (25.03.2026)

v23.2'ye aşağıdaki yeni özellikler ve güncellemeler eklendi.

Öğeler

• Geliştirmeye özel video reklam bilgileri (ör. Google tarafından oluşturulup oluşturulmadığı veya reklamveren tarafından sağlanıp sağlanmadığı) içeren VideoEnhancement kaynağı eklendi. Daha fazla bilgi edinmek için Video geliştirmeler hakkında bölümüne bakın.
• Uygulama kampanyalarındaki en iyi performansı gösteren öğe kombinasyonları hakkında analizler sunmak için AppTopCombinationView salt okunur kaynağı eklendi.
• CustomerAsset öğesinin field_type ile field_type alınması için destek eklendi.BUSINESS_LOGO

Kampanyalar

• Kampanya tarihlerinde daha ayrıntılı planlama kısıtlamaları sağlamak için AdGroupAd.start_date_time ve AdGroupAd.end_date_time alanları eklendi. Bu özellik yalnızca bazı reklam grubu türlerinde desteklenir.
• Talep Yaratma kampanyalarında otel feed'inin devre dışı bırakılmasına olanak tanıyan HotelSettingInfo.disable_hotel_setting eklendi.

Genel

• CustomerClientLinkError öğesine iki yeni hata kodu eklendi: MAX_CUSTOMER_LIMIT_REACHED ve ACCOUNT_CREATION_POLICY_VIOLATION.
• Artık kullanımdan kaldırılan LOYALTY_SIGN_UPS kullanıcı listesi müşteri türü kategorisi kullanılmaya çalışıldığında hata veriliyor.

Planlama

• GenerateTrendingInsights ve GenerateCreatorInsights'da varlıkların, konuların ve kitlelerin özel VE/VEYA kombinasyonları için destek eklendi.
• ReachPlanService.GenerateReachForecast'da AGE_RANGE_21_44 veya AGE_RANGE_21_49 gibi yeni hedeflenebilir yaş grupları eklendi.
• youtube_select_lineups yerine kullanılacak olan ReachPlanService.ListPlannableProducts listesine youtube_select_lineup_targeting eklendi. Her iki alan da şu anda doldurulmuş durumda.
• ReachPlanSurface konumuna yüzey seçeneği olarak IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS eklendi.
• ReachPlanService.GenerateReachForecast'da Talep Yaratma Maksimum Tıklama (TBM) için Forecast'ya clicks eklendi.
• partnership_opportunities, ContentCreatorInsightsService.GenerateCreatorInsights ve ContentCreatorInsightsService.GenerateTrendingInsights'a eklendi.

Raporlar

• Campaign, Customer ve AdGroup kaynaklarına biddable_indirect_install_first_in_app_conversion_micros metriği eklendi.

Videolar

• ShareablePreviewService, preview_type YOUTUBE_LIVE_PREVIEW olarak ayarlanarak YouTube canlı yayın önizlemelerini destekleyecek şekilde genişletildi. ShareablePreviewError'e UNSUPPORTED_AD_TYPE ve TOO_MANY_RESOURCES_IN_REQUEST eklendi. Bu özellik yalnızca bazı reklam türlerinde desteklenir.

23.1 sürümü (25.02.2026)

v23.1'e aşağıdaki yeni özellikler ve güncellemeler eklendi.

Yardım için En yeni sürüme yükseltme başlıklı makaleyi inceleyin.

Hesap yönetimi

• ProductLinkInvitation ve ProductLink kaynaklarına advertising_partner_properties.allowed_domain eklendi. Reklamcılık iş ortağı yalnızca bu alanda reklam yayınlayabilir.
• contains_eu_political_advertising alanı, Customer kaynağına eklendi. Bu alan, AB'yi hedefleyen siyasi reklamlar içerip içermediğine dair hesap düzeyindeki beyan durumunu alır ve EuPoliticalAdvertisingStatusEnum döndürür.

Kampanyalar

• Maksimum Performans ve Arama Ağı kampanyalarında kullanılabilen, yapay zeka tarafından oluşturulan metin öğelerini programatik olarak kontrol etmenizi sağlayan metin kuralları desteği eklendi.
  • Campaign.text_guidelines alanını Campaign kaynağına ekledi.
  • text_guidelines içinde term_exclusions ve messaging_restrictions tanımlayabilirsiniz.
• FIXED_CPM teklif stratejisine sahip kampanyalar için temel durum nedenleri sağlamak üzere CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED ve CampaignPrimaryStatusReason.BOOKING_CANCELLED eklendi.
• Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure ve Campaign.VideoCampaignSettings.booking_details(salt okunur) eklendi.
• AB'yi hedefleyen siyasi reklamlar içerip içermediğine dair beyanların eksik olduğu kampanyaların sorgulanmasını ve filtrelenmesini desteklemek için Campaign.missing_eu_political_advertising_declaration eklendi.

Dönüşümler

• Reklam izleyen ve daha sonra aynı kanaldan bir video izleyen kullanıcıların takibini desteklemek için ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS eklendi.

Genel

• CANNOT_TARGET_ONLY_UNDETERMINED, CriterionErrorEnum'e eklendi. Bu hata, demografi boyutlarında yalnızca belirlenmemiş kategoriyi hedeflemeye çalışırken döndürülür.

Teşvikler

• IncentiveErrorEnum'a iki yeni hata kodu eklendi: MAX_INCENTIVES_REDEEMED ve ACCOUNT_TOO_OLD. Bu hatalar, 11 Mart 2026'da veya sonrasında yapılan istekler için döndürülebilir.

Planlama

• GenerateBenchmarksMetrics içinde tarih dökümleri için destek eklendi. BreakdownDefinition kullanılarak.
• ReachPlanService.GenerateReachForecast'da Talep Yaratma kampanyalarında dönüşüm sayısını artırma hedefi için GOOGLE_DISPLAY_NETWORK hedeflenebilir platform olarak eklendi.
• Konuya göre arama yaparken TrendInsightDataPoint ile TrendInsights arasındaki GenerateTrendingInsights'daki geçmiş trend çizgisi bilgileri eklendi.

Raporlar

• Reklamınızı en az iki, üç, dört, beş veya on kez gören kullanıcı sayısını bildiren yeni metrikler eklendi: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus ve unique_users_ten_plus.
• Seyahat reklamları öğe hedefleme gibi dikey reklam verileri feed'lerini desteklemek için VERTICAL_ADS_DATA_FEED eklendi. SearchTermMatchSourceEnum eklendi.

YouTubeVideoUpload

• YouTube'da video yükleme ve yönetmeyi desteklemek için YouTubeVideoUpload hizmeti, yükleme durumu ve meta verileri getirmeyi desteklemek için YouTubeVideoUpload kaynağı eklendi. Bu özellik yalnızca REST ve Python istemci kitaplığı için desteklenir.

23 sürümü (28.01.2026)

v23'e aşağıdaki yeni özellikler ve güncellemeler eklendi.

Reklamlar

• AD_SHARING_NOT_ALLOWED, AdGroupAdErrorEnum'a eklendi. Bu hata, artık izin verilmeyen bir işlem olan reklamı birden fazla reklam grubu arasında paylaşmaya çalışırken döndürülür.
• AdFormatType'a yeni biçim türleri eklendi: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
• v23'te CallAd ve CallAdInfo için destek kaldırıldı. Daha fazla bilgi edinmek için Telefon araması reklamları hakkında başlıklı makaleyi inceleyin.

Öğeler

• asset_group raporuna ek metrikler eklendi:

  • metrics.engagements
  • metrics.engagement_rate
  • metrics.average_cpe

• asset_group_asset raporuna ek metrikler eklendi:

  • metrics.average_cpe
  • metrics.average_cpm
  • metrics.trueview_average_cpv
  • metrics.video_trueview_view_rate
  • metrics.video_trueview_views
  • metrics.interaction_event_types

• orientation adlı salt okunur alan, Asset içindeki resim ve video öğelerine eklendi.

• field_type HEADLINE ve DESCRIPTION ile CampaignAsset'ı alma desteği eklendi.

• Site bağlantısı olarak sunulan öğeler için ServedAssetFieldType'ye HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE ve DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO özellikleri eklendi.

• Güncellenen müşteri mesajı öğeleri:

  • BusinessMessageAsset'da sağlayıcı olarak Facebook Messenger ve Zalo desteği eklendi, FACEBOOK_MESSENGER ve ZALO BusinessMessageProviderEnum.BusinessMessageProvider'a eklendi ve BusinessMessageAsset'a yeni alanlar facebook_messenger_info ve zalo_info eklendi.
  • CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS, AssetErrorEnum listesine eklendi.

Faturalandırma

• InvoiceService.ListInvoices artık ListInvoicesRequest içinde include_granular_level_invoice_details ayarlanarak Invoice içinde daha ayrıntılı bilgiler döndürebilir. Bu bilgiler arasında kampanya düzeyinde maliyet dökümü, kalem kalem düzenleyici maliyetler ve ayarlama bilgileri yer alır.
• RegulatoryFeeTypeEnum ve UnitOfMeasureEnum eklendi.

Kampanyalar

• CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET ve CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET hata kodları eklendi.
• Campaign.start_date ve Campaign.end_date yerine Campaign.start_date_time ve Campaign.end_date_time eklendi. Bu sayede, belirli kampanya türleri için zaman bileşenleri belirtilebiliyor.

Dönüşümler

• Bir reklamı izledikten sonra aynı kanaldan bir video izleyen kullanıcıların izlenmesini desteklemek için YOUTUBE_FOLLOW_ON_VIEWS, ConversionActionCategory'ye eklendi.

Talep Yaratma

• DemandGenVideoResponsiveAdInfo.companion_banner alanı eklendi.
• DemandGenMultiAssetAdInfo alanından lead_form_only alanı kaldırıldı.

Teşvikler

• Kendi Ödülünüzü Seçin (CYO) teşvikleri için destek eklendi. Bu sayede iş ortakları, müşterileri için Google Ads teşviklerini programatik olarak getirebilir ve uygulayabilir:

  • IncentiveService eklendi:
    • FetchIncentive yöntemi, ülkeye, dile ve isteğe bağlı olarak kullanıcının e-posta adresine göre kullanıcının yararlanabileceği teşvikleri getirmeye olanak tanır. Bu, kişiselleştirilmiş "Kendi Seçiminizi Yapın" (CYO) teşvik seçenekleri döndürebilir.
    • ApplyIncentive yöntemi, kullanıcı tarafından seçilen bir teşviki belirli bir Google Ads müşteri hesabına uygulamaya olanak tanır.
  • AppliedIncentive salt okunur kaynağı eklendi. Bu kaynağa GoogleAdsService.Search ve GoogleAdsService.SearchStream üzerinden sorgu gönderilebilir. Kullanılan teşviklerle ilgili ayrıntılar (ör. durum, tamamlanma ilerleme durumu, ödül tutarları ve ilgili tarihler) gösterilir.
  • Teşvik getirme veya uygulama ile ilgili sorunları ele almak için IncentiveErrorEnum bölümüne yeni hata kodları eklendi.
  • INVALID_EMAIL_ADDRESS, AuthenticationErrorEnum listesine eklendi.

• Hataların daha ayrıntılı programatik olarak işlenmesini kolaylaştırmak için gelecekteki sürümlerde IncentivesService'ya ek hata kodları ekleyeceğiz. Uygulamalarınızın bu yeni hata modlarını yönetebildiğinden emin olmak için bu yeni hata kodlarıyla ilgili duyuruları ve sürüm notlarını takip etmenizi öneririz.

Planlama

• LIFE_EVENT_USER_INTEREST, AudienceInsightsDimension'a eklendi. Bu yeni boyut, kullanıcıların aşağıdaki yöntemlerle yaşamdaki önemli olayları kullanarak kitle oluşturmasına olanak tanır:

  • AudienceInsightsService.GenerateAudienceCompositionInsights
  • AudienceInsightsService.GenerateSuggestedTargetingInsights
  • AudienceInsightsService.GenerateInsightsFinderReport
  • ContentCreatorInsightsService.GenerateCreatorInsights

  Yaşamdaki önemli olaylar, AudienceInsightsService gibi diğer yöntemlerde (ör. AudienceInsightsService.GenerateAudienceOverlap ve AudienceInsightsService.GenerateTargetingSuggestionMetrics) desteklenmez.

• ReachPlanService.GenerateConversionRates yanıtı artık yüzeyleri içeriyor. Bu sayede, yüzey kontrollerine (ör. Gmail, Shorts) göre farklı dönüşüm oranı önerileri sunulabiliyor. Bu özellik yalnızca Talep Yaratma kampanyalarında desteklenir.

• YouTube kanalı içeriklerinde dil dağıtımı sağlayan YouTubeChannelInsights'a LanguageDistribution eklendi.

• YouTube reklam verilerini sektör karşılaştırmalarıyla karşılaştırmak için BenchmarksService eklendi.

• Hedef kitlenin serbest metin açıklamasını üretken yapay zekayı kullanarak eşleşen kitle özelliklerine çevirmek için AudienceInsightsService.GenerateAudienceDefinition eklendi.

• Görüntüleme sayısına göre ağırlıklandırılmış bir konunun içerik üretici için ne kadar alakalı olduğunu değerlendiren YouTubeChannelInsights.relevance_score eklendi.

• TrendInsightMetrics.trend_change_percent simgesi eklendi. Bu simge, karşılaştırma döneminde bir trendin değerindeki yüzde değişimini gösterir.

Öneriler

• GenerateRecommendationsRequest'a is_new_customer alanı eklendi. CAMPAIGN_BUDGET türündeki öneriler için true olarak ayarlandığında, yeni müşterilere yönelik bir model kullanılarak öneriler oluşturulur. Bu yalnızca kampanyası olmayan müşteriler için önerilir.

Raporlar

• Metrikler ve segmentasyon

  • AdGroupAdAssetView artık RESPONSIVE_DISPLAY_AD için gösterim, performans ve dönüşüm metriklerini destekliyor.
  • Bir reklam ağı içindeki performansı daha ayrıntılı bir şekilde incelemek için ad_sub_network_type segmenti eklendi. Bu özellik ilk olarak YouTube'daki (yayın içi, feed içi, Shorts) Talep Yaratma kampanyalarında kullanılabilir. Bu segment, ad_network_type ile birlikte seçilmelidir.
  • Maksimum Performans kampanyaları için etkinleştirilen reklam ağı türü dökümü.
  • UserLocationView ve GeographicView artık dönüşüm tarihine göre segmentlere ayrılmış metrikleri destekliyor:
    • conversions_by_conversion_date,
    • all_conversions_by_conversion_date,
    • conversions_value_by_conversion_date,
    • all_conversions_value_by_conversion_date,
    • value_per_conversions_by_conversion_date,
    • value_per_all_conversions_by_conversion_date,
    • cross_device_conversions_by_conversion_date,
    • cross_device_conversions_value_by_conversion_date.

• Dikey reklamlar için yeni segmentler

  • vertical_ads_event_participant_display_names
  • vertical_ads_hotel_class
  • vertical_ads_listing
  • vertical_ads_listing_brand
  • vertical_ads_listing_city
  • vertical_ads_listing_country
  • vertical_ads_listing_region
  • vertical_ads_partner_account
  • vertical_ads_vertical

• Yeni görünümler:

  • Mağaza konumu ayrıntılarını sorgulamak için PerStoreView eklendi.
  • Kullanıcıların ilgi gösterdiği coğrafi konumlara göre ayrılmış performans metrikleri sağlayan, yapay zeka Maksimum kampanyaları için MatchedLocationInterestView eklendi.

• Maksimum Performans:

  • Maksimum Performans kampanyaları için etkinleştirilen reklam ağı türü dökümü.

• Kaldırma:

  • Toplu öğe performansı etiketi metrikleri kaldırıldı. Performans etiketi numaralandırması artık Arama Ağı ve Görüntülü Reklam Ağı için döndürülmüyor.

Alışveriş

• ShoppingPerformanceView artık dönüşüm tarihine göre segmentlere ayrılmış aşağıdaki metrikleri destekliyor: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
• ShoppingPerformanceView artık şu rekabet metriklerini destekliyor: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.
• product_image_uri, ShoppingProduct listesine eklendi.

Dikey reklamlar

• Seyahat feed'lerinin kullanıldığı arama ağı kampanyalarında AdGroup'a vertical_ads_format_setting eklendi. Bu sayede, hangi reklam biçimlerinin yayınlanabileceği kontrol edilebilir.
• vertical_ads_item_group_rule_list ölçüt türü AdGroupCriterion'e eklendi. vertical_ads_item_group_rule, SharedCriterion'e eklendi. Bu ölçütler, seyahat feed'leri içeren arama ağı kampanyalarında öğe gruplarının hedeflenmesine olanak tanır.
• Artık bir dikey reklamlar veri feed'ini, AI Max'in kullanıldığı bir arama ağı kampanyasına bağlayarak mülk tanıtımı ve rezervasyon bağlantısı içeren seyahat reklamlarının metin reklamlarınızla birlikte gösterilmesini sağlayabilirsiniz. Reklam grubu düzeyinde, vertical_ads_format_setting ile hangi biçimlerin gösterileceğini kontrol edebilir ve dikey reklamlar veri feed'indeki öğelerinizin bir alt kümesini hedeflemek için bir dizi öğe grubu kuralı tanımlayabilirsiniz. Ayrıca, raporlama artık hem AdFormatType hem de dikey reklamlar veri feed'indeki boyutlara göre segmentlere ayrılabilir.

Video

• AdVideoAssetInfo.ad_video_asset_feature_control alanı eklendi.
• CampaignCriterionError.INVALID_VIDEO_LINEUP_ID hata kodu eklendi.
• YouTube'daki işitsel reklamlar için duyulabilirlik metrikleri eklendi. Bu metrikler, bir reklamın duyulabilir olup olmadığını ve kaç gösterimde duyulabilirliğin ölçülebileceğini raporlar.

22.1 sürümü (25.02.2026)

v22.1 sürümüne aşağıdaki yeni özellik eklendi.

Hesap yönetimi

• contains_eu_political_advertising alanı, Customer kaynağına eklendi. Bu alan, AB'yi hedefleyen siyasi reklamlar içerip içermediğine dair hesap düzeyindeki beyan durumunu alır ve EuPoliticalAdvertisingStatusEnum döndürür.

Kampanyalar

• AB'yi hedefleyen siyasi reklamlar içerip içermediğine dair beyanların eksik olduğu kampanyaların sorgulanmasını ve filtrelenmesini desteklemek için Campaign.missing_eu_political_advertising_declaration eklendi.

v22 (15.10.2025)

Sürüm 22'ye aşağıdaki yeni özellikler ve güncellemeler eklendi.

Öğeler

• LANDING_PAGE_PREVIEW, yeni bir resim öğesi alanı türü olarak eklendi.
• AssetGenerationService (Beta) kullanıma sunuldu:
  • Bu hizmet, üretken yapay zekayı kullanarak metin ve resim öğeleri oluşturmanıza olanak tanır. Bu hizmet, ilk olarak yalnızca sınırlı sayıda kapalı beta katılımcısı tarafından kullanılabilir.
  • GenerateText: Nihai URL, serbest biçimli istemler, anahtar kelimeler ve mevcut kampanya bağlamı gibi girişlere dayalı metinler oluşturur.
  • GenerateImages: Nihai URL, serbest biçimli istemler, mevcut kampanya bağlamı gibi girişlere göre veya mevcut ürün resimlerini yeniden bağlamsallaştırarak resimler oluşturur.
  • Öğe oluşturma sırasında oluşan hatalar, AssetGenerationErrorEnum kodlarıyla döndürülür.

Kampanyalar

• Yüklemelere yönelik uygulama kampanyaları (ACI) için hedef belirtmeden optimizasyon yapmaya olanak tanıyan yeni teklif hedefleri eklendi. Bu hedefler, hızlı ölçeklendirme veya doğru hedefi belirlemenin zor olduğu durumlarda kullanışlıdır. AppCampaignBiddingStrategyGoalType bölümünde: * OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Standart dönüşümleri artırma ile birlikte kullanın.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Standart dönüşüm değerini artırma ile birlikte kullanılır.
• Sabit görünürlük payı teklif stratejisi türü için destek eklendi.
• Bir kampanyaya eklenen feed türlerini gösteren Campaign.feed_types simgesi eklendi. Maksimum Performans kampanyalarında bu simge, perakende için MERCHANT_CENTER_FEED gibi iş kolunu gösterebilir.
• NEGATIVE_KEYWORDS paylaşılan kümelerinin MULTI_CHANNEL (uygulama kampanyaları için) ve LOCAL kampanyalarına eklenmesine izin verilir.

Talep Yaratma

• Talep Yaratma kampanyaları için hedef TBM teklif stratejisi eklendi. Bu strateji, yapılandırılan hedef tıklama başına maliyet (TBM) ile tıklamaları artırmak için teklifleri belirler.
  • Campaign.target_cpc kullanarak kampanya düzeyinde hedef TBM'yi ayarlayın.
  • AdGroup.target_cpc_micros kullanarak reklam grubu düzeyinde geçersiz kılın.
• Yeni bir AssetAutomationType eklendi: * GENERATE_DESIGN_VERSIONS_FOR_IMAGES: DemandGenMultiAssetAds için kullanılabilir. Etkinleştirilirse bu özellik, farklı en-boy oranlarına sahip yeni resim öğeleri oluşturmak için tasarım öğeleri ekler ve metin öğelerini resim öğelerine yerleştirir. Yeni DemandGenMultiAssetAds varsayılan olarak etkindir.
• Yeni bir AssetAutomationType eklendi: * GENERATE_VIDEOS_FROM_OTHER_ASSETS: DemandGenMultiAssetAds için kullanılabilir. Etkinleştirilirse resim ve metin gibi diğer öğeleri kullanarak videolar oluşturur. Bu videolar daha sonra yeni DemandGenVideoResponsiveAds oluşturmak için kullanılabilir. Yeni DemandGenMultiAssetAds varsayılan olarak etkindir.
• BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros alanının adını minimum_budget_amount_micros olarak değiştirdi.

Genel

• AddBatchJobOperations isteği başına 10.000 işlem sınırı eklendi.
• page_size alanının ListBatchJobResultsRequest içindeki işlenmesi güncellendi:
  • page_size ayarlanmamışsa veya 0 ise artık varsayılan olarak en fazla 1.000 olur (önceden INVALID_PAGE_SIZE döndürülüyordu).
  • page_size değeri 1.000'i aşarsa API artık INVALID_PAGE_SIZE hatası döndürüyor (daha önce 1.000 ile sınırlanıyordu).
• Yeni bir hata kodu eklendi: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED to ödeme profili etkinleştirme oranı sınırının aşıldığını belirtmek için.

Maksimum Performans

• Maksimum Performans kampanyaları için yeni AssetAutomationType değerleri eklendi:
  • GENERATE_IMAGE_ENHANCEMENT: Otomatik kırpma gibi gelişmiş resimlerin otomatik olarak oluşturulmasını sağlar. Varsayılan olarak etkindir.
  • GENERATE_IMAGE_EXTRACTION: Nihai URL'lerden otomatik olarak resim alınmasını sağlar. Varsayılan olarak hesap düzeyindeki dinamik resim uzantısı ayarı kullanılır.
• Maksimum Performans kampanyaları için AssetPerformanceLabel kaldırıldı.
• Kaldırılan Campaign.url_expansion_opt_out işlevinin yönetimi artık AssetAutomationSetting içinde AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION ayarlanarak yapılıyor.
• Maksimum Performans kampanyaları için yeni segmentler eklendi. Bu segmentlerin her biri yalnızca Maksimum Performans kampanyaları için kullanılabilir ve başka bir kampanya türü seçildiğinde veri döndürmez.
  • ad_using_product_data: Bir reklamın Google Merchant Center feed'indeki ürün verilerini kullanıp kullanmadığını gösterir.
  • ad_using_video: Bir reklamda video öğesi kullanılıp kullanılmadığını gösterir.

Planlama

• UserListCrmDataSourceType içinde THIRD_PARTY_PARTNER_DATA değerini ekleyin.
  • İş ortağı kitleleriyle ilgili yeni hata kodları eklendi:
  • PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • COMMERCE_PARTNER_NOT_ALLOWED
  • PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_MANAGER_ACCOUNT_DISALLOWED
  • PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ADVERTISER_TOS_NOT_ACCEPTED
  • ADVERTISER_PARTNER_LINK_MISSING
  • ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
  • INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
• YouTubeMetrics öğesine is_active_live_stream_creator eklendi. Bu değer, ContentCreatorInsightsService.GenerateCreatorInsights tarafından döndürülür ve içerik üreticinin son 90 gün içinde canlı yayın yapıp yapmadığını gösterir.

• PlannableUserList içinde UserListCrmDataSourceType içeren yeni bir PlannableUserListMetadata mesajı eklendi. Bu mesaj, "ReachPlanService.ListPlannableUserLists" tarafından bir CRM kullanıcı listesi veri kaynağının FIRST_PARTY veya THIRD_PARTY_PARTNER_DATA olup olmadığını göstermek için döndürülür.

• ReachPlanService bölümünde, views alanının yerini alan trueview_views alanı eklendi.

• TrendInsight sürümünde related_videos ve related_creators desteği eklendi. Ayrıca YouTubeVideoAttributeMetadata.video_properties ve YouTubeVideoAttributeMetadata.publish_date'e video özellikleri meta verileri ve yayınlanma tarihleri eklendi.

  • AudienceInsightsService.GenerateInsightsFinderReport artık parental_status ve income_ranges'ı ve daha karmaşık konular ile kitlelerin VE/VEYA kombinasyonlarını destekliyor.

Raporlar

• CLICK_TO_MESSAGE_THIRD_PARTY_CLICK ve CLICK_TO_MESSAGE_LANDING_PAGE_CLICK olmak üzere iki yeni tıklama türü eklendi.
• AssetGroupAsset artık device, conversion_action, conversion_action_name ve conversion_action_category kriterlerine göre segmentlere ayrılabilir.
• AdGroupAdAssetView artık RESPONSIVE_SEARCH_AD için performans ve dönüşüm metriklerini tam olarak destekliyor. Daha önce bu görünümde bu reklam türü için yalnızca gösterimler döndürülüyordu.
• Akıllı Teklif Araştırması'nı kolaylaştırmak için aşağıdaki metrikler artık tarih alanlarına (date, month, quarter, week, year) göre segmentlere ayrılabilir:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
• Yeni bir kaynak eklendi: TargetingExpansionView. Bu kaynak, Arama Ağı kampanyaları için Maksimum Yapay Zeka'da anahtar kelimesiz genişletme gibi manuel hedeflemeye göre genişletmelerle ilgili metrikleri raporlar.

• Maksimum Performans kampanyaları için yeni segmentler eklendi. Maksimum Performans güncellemeleri başlıklı makaleyi inceleyin.

  ### Alışveriş

• ShoppingProduct kaynağındaki metriklerin kampanya ve reklam grubu kapsamı düzeltildi.

Birleştirilmiş hedefler

• Mevcut müşterilerle yeniden etkileşim kurmaya yönelik optimizasyon için müşteri elde tutma hedefleri desteği eklendi.
  • CampaignRetentionGoalSettings.target_option kullanarak hedeflemeyi yapılandırın: * TARGET_SPECIFIC: Yalnızca kampanyayla ilişkili kullanıcı listelerindeki kullanıcıları kullanır. (Şu anda yalnızca izin verilenler listesi).
    • TARGET_ALL (Varsayılan): Yeniden etkileşim için tüm kullanıcıları hedefler.

Video

• Video görüntülemeyle ilgili çeşitli metriklerin adı değiştirildi:
  • average_cpv artık trueview_average_cpv
  • video_view_rate artık video_trueview_view_rate
  • video_views artık video_trueview_views
  • video_view_rate_in_feed artık video_trueview_view_rate_in_feed
  • video_view_rate_in_stream artık video_trueview_view_rate_in_stream
  • video_view_rate_shorts artık video_trueview_view_rate_shorts
• Video reklam izlenme süresi için eklenen metrikler:
  • video_watch_time_duration_millis: Toplam izlenme süresi.
  • average_video_watch_time_duration_millis: Gösterim başına ortalama izlenme süresi.

v21.1 (25.02.2026)

v21.1'e aşağıdaki yeni özellik eklendi.

Hesap yönetimi

• contains_eu_political_advertising alanı, Customer kaynağına eklendi. Bu alan, AB'yi hedefleyen siyasi reklamlar içerip içermediğine dair hesap düzeyindeki beyan durumunu alır ve EuPoliticalAdvertisingStatusEnum döndürür.

Kampanyalar

• AB'yi hedefleyen siyasi reklamlar içerip içermediğine dair beyanların eksik olduğu kampanyaların sorgulanmasını ve filtrelenmesini desteklemek için Campaign.missing_eu_political_advertising_declaration eklendi.

v21 (06.08.2025)

Yardım için En yeni sürüme yükseltme başlıklı makaleyi inceleyin.

Arama Kampanyaları için Maksimum Yapay Zeka

• Artık Arama Ağı kampanyaları için Arama Ağı Kampanyaları İçin AI Max'i etkinleştirmek üzere ai_max_setting.enable_ai_max alanını kullanabilirsiniz.Campaign Arama Ağı kampanyaları için Maksimum Yapay Zeka, arama terimi eşleştirme yoluyla bir Arama Ağı kampanyasının erişimini genişletir ve hedefleme ile reklam öğesi kontrollerinin ayarlandığında yayınlanıp yayınlanmayacağını kontrol etmenize olanak tanır. Önceki sürüm isteklerinde ayarlanan metin öğesi otomasyonu ve marka listesi kontrolleri, Arama Ağı kampanyaları için AI Max açıkça etkinleştirilip devre dışı bırakılana kadar geçerliliğini korur. Metin öğesi otomasyonu ve marka listesi kontrollerine uymak veya bunları değiştirmek için Arama Ağı kampanyaları için AI Max'in etkinleştirilmesi gerekip gerekmediğini belirlemek üzere Campaign.ai_max_setting.bundling_required kullanılabilir. AdGroup.ai_max_ad_group_setting.disable_search_term_matching, bir üst kampanyada Arama Ağı kampanyaları için Maksimum Yapay Zeka etkinleştirildiğinde arama terimi eşleştirmeyi devre dışı bırakmak için kullanılabilir. Arama Ağı Kampanyaları İçin AI Max ile performansınızı bir üst seviyeye taşıma başlıklı blog yayınımıza göz atın.

• Kampanyada Arama Kampanyaları İçin Maksimum Yapay Zeka'yı etkinleştirmeden FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION'ı etkinleştirdiğinizde Arama Ağı kampanyaları için oluşturulan CampaignError.AI_MAX_MUST_BE_ENABLED eklendi.

• Arama Ağı kampanyaları için Maksimum Yapay Zeka'da hedefleme kontrollerini reklam grubu düzeyinde uygulama desteği eklendi. Artık reklam gruplarına aşağıdaki ölçütleri ekleyebilirsiniz:

  • Marka listeleri
  • Konumlar
  • Web sayfaları (URL kuralları)

• Arama terimleri, başlıklar ve açılış sayfalarının kombinasyonlarının performansını raporlamak için ai_max_search_term_ad_combination_view simgesi eklendi. Bu görünümde, reklamlarınızı hangi arama sorgularının tetiklediği ve bu belirli kombinasyonların nasıl performans gösterdiği gösterilir. Gelecekteki bir sürümde, Maksimum Performans verilerini de içeren ek bir görünüm yer alacak. Maksimum Performans verilerini almak için uygulamanızı taşımak istemiyorsanız bu sürümün yayınlanmasını bekleyebilirsiniz.

• search_term_match_type segmenti için yeni değer olarak AI_MAX eklendi.

Öğeler

• PromotionAsset içinde terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info ve promotion_qr_code_info alanları eklendi. Barkod ve QR kodu alanları promotion_trigger oneof'unun içinde yer alır. Promosyon öğeleri hakkında başlıklı Yardım Merkezi makalesine bakın.

• FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION, AssetAutomationTypeEnum'e eklendi. Bu ayarla, arama ağı kampanyalarındaki nihai URL'den metin öğelerinin ve açılış sayfalarının otomatik olarak oluşturulmasını kontrol edebilirsiniz.

• AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset adlı yeni bir hizmet eklendi. Bu hizmet, otomatik olarak oluşturulmuş öğeleri Campaign'den kaldırmak için kullanılır. Bu hizmet yalnızca nihai URL genişletmesi öğesinin kaldırılmasını destekler.

• ServedAssetFieldType numaralandırılmış değerine DESCRIPTION_PREFIX eklendi. Bu değişiklik, açıklama öneki olarak sunulan öğeler için ad_group_ad_asset_combination_view içindeki served_asset_field_type değerinin UNKNOWN olmasına neden olan sorunu düzeltir.

Kampanyalar

• CampaignPrimaryStatusReason öğesine yeni bir enum değeri MISSING_LOCATION_TARGETING eklendi. Bu yeni durum nedeni yalnızca yer hedefleme belirtilmeyen ve konumla sınırlı kampanyalar için döndürülür. Konumla kısıtlanmış kampanyalarda, izin verilen alanın dışında konum hedefleme ekleme girişimleri LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN ölçüt hatasıyla sonuçlanır.

• VideoCustomer.third_party_integration_partners ve Campaign.third_party_integration_partners düzeylerinde üçüncü taraf entegrasyon iş ortakları için destek eklendi. Üçüncü taraf uygulama analiziyle uygulama dönüşümlerini izleme başlıklı Yardım Merkezi makalesini inceleyin.

• Artık mevcut bir advertising_partner_ids alanı ayarlayabilirsiniz. Campaign. Daha önce bu alan yalnızca yeni bir kampanyanın oluşturulması sırasında ayarlanabiliyordu. Alan, ayarlandıktan sonra değiştirilemez.

• Reklamverenler, yönetici hesabı düzeyinde tanımlanan NEGATIVE_PLACEMENTS türünde paylaşılan bir liste kullanarak artık CustomerNegativeCriterion ölçütlerini kullanarak yerleşim listesini tek tek reklamveren müşteri hesaplarında hariç tutabilir.

• ServedAssetFieldType enum'ına DESCRIPTION_PREFIX eklendi. Bu düzeltme, açıklama öneki olarak sunulan öğeler için ad_group_ad_asset_combination_view içindeki served_asset_field_type karakterinin UNKNOWN olmasına neden olan sorunu düzeltir.

• MaximizeConversionValue ve TargetRoas teklif stratejilerinde target_roas_tolerance_percent_millis alanı için destek eklendi. TargetRoas.target_roas_tolerance_percent_millis yalnızca portföy stratejileri için kullanılabilir ve bu stratejiler yalnızca Arama Ağı kampanyalarında kullanılabilir.

• ProductGroup hata kodunu değiştirdiyseniz Kısmi hata etkinleştirilmiş istekler için INVALID_LISTING_GROUP_HIERARCHY yerine LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION döndürülür.

• Reklam grubu konum ilgi alanı ölçütlerinin performansını özetleyen yeni bir kaynak LocationInterestView eklendi.

Dönüşümler

• ENGAGED_VIEW, conversion_attribution_event_type segmenti için yeni bir değer olarak eklendi.

• Müşteriler artık ConversionUploadService'da debug_enabled moduna erişemeyecek. Bu alan, TRUE olarak ayarlanırsa daha önce potansiyel müşteriler için gelişmiş dönüşüm içe aktarma işlemlerinde CLICK_NOT_FOUND hatasını SUCCESS'den ayırt etmek için kullanılıyordu.

Talep Yaratma

• CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM hata kodu eklendi. Gelecekte, Talep Yaratma kampanyası için çok düşük bir bütçe tutarı ayarlamaya çalışıldığında bu hata döndürülecektir. Gerekli minimum bütçeyle ilgili ayrıntıları yeni hata ayrıntıları alanında budgetDailyMinimumErrorDetails bulabilirsiniz.

AB siyasi reklamcılığı ile ilgili değişiklikler

AB siyasi reklamcılığıyla ilgili bu değişiklikler v19.2 ve v20.1 sürümlerinde de yapılmıştır.

• Campaign.contains_eu_political_advertising eklendi. Bu alan, kampanyanızın Avrupa Birliği'ni hedefleyen siyasi reklamcılık içeriği içerip içermediğini gösterir. Bu alan CONTAINS_EU_POLITICAL_ADVERTISING olarak ayarlanırsa kampanya 22 Eylül 2025'ten itibaren AB'de yayınlanmayacak. Bu alan ayarlanmazsa yeni kampanya oluşturmaya yönelik API çağrıları FieldError.REQUIRED hatasıyla başarısız olur.

  Mevcut kampanyalarda, yakınlık, konum veya konum grubu hedeflemeyi kampanya ya da reklam grubu düzeyinde değiştirmeye çalışmadan önce contains_eu_political_advertising alanını ayarlamanız gerekir. Mevcut kampanyalar için bu kampanya veya reklam grubu ölçütlerini oluşturmaya ya da güncellemeye yönelik API çağrıları, kampanya kendi beyanını tamamlamadıysa CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION hatasıyla başarısız olur.

  v19.x ve 20.x sürümlerinde bu alanın ayarlanması henüz zorunlu olmasa da gelecekte zorunlu olacaktır. Bu değişiklik önceden duyurulacak.

• Deneme kampanyalarında Avrupa Birliği'ni hedefleyen siyasi reklamlar olup olmadığı beyan edilmediyse denemeler ve deneme kampanyaları ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION hatası verir.

Maksimum Performans

• Yeni Maksimum Performans kampanyalarında Campaign.brand_guidelines_enabled için varsayılan değer artık true.

• campaign_search_term_view raporu eklendi. Bu görünüm, kampanya düzeyinde toplanmış arama terimi metriklerini sunar. Bu görünümde, arama terimleri için Maksimum Performans kampanyası desteği de sunulmaktadır.

• PERFORMANCE_MAX, search_term_match_type segmenti için yeni bir değer olarak eklendi.

Planlama

• Reklamverenlerin ReachPlanService.GenerateReachForecast tarafından desteklenen kullanıcı ilgi alanlarını (benzerlikler ve satın almaya hazır kitleler) keşfetmesine olanak tanıyan yeni bir yöntem ReachPlanService.ListPlannableUserInterests eklendi. Bu yöntem, belirli kullanıcı ilgi alanı türlerini aramayı ve adlar ile yollar için sorgu oluşturmayı destekler.

• AdditionalApplicationInfo, ReachPlanService.ListPlannableUserLists'a isteğe bağlı giriş alanı olarak eklendi.

• İsteği gönderen müşteri kimliği için kullanılabilir birinci taraf kullanıcı listelerini getirmek üzere AudienceInsightsService.ListAudienceInsightsAttributes için destek eklendi.

• Kullanıcı listesini hedefleyen kitlelerle ilgili analizleri getirmek için AudienceInsightsService.GenerateAudienceCompositionInsights'ye birinci taraf kullanıcı listeleri desteği eklendi. Kullanıcı listesini hedefleyen tüm istekler yalnızca kitle dizinini döndürür ve yalnızca aşağıdaki AudienceInsightsDimension için kullanılabilir: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST.

• InsightsAudience için kitle giriş türü AudienceInsightsService.GenerateTargetingSuggestionMetrics olarak güncellendi. Yeni kitle girişi, kullanıcı ilgi alanlarının OR'ların AND'si şeklinde bir kombinasyonuna olanak tanır ve daha özelleştirilmiş kitle tanımları için potansiyel erişim metriklerini destekler.

• Bir trendin kitle payını almak için TrendInsightMetrics'a kitle payı eklendi.

• KnowledgeGraphAttributeMetadata bölümüne yeni ilgili kategoriler eklendi. Böylece kullanıcılar, bilgi grafiği özelliklerini kategoriye göre filtreleyebilir.

Raporlar

• AssetGroupAsset, ChannelAggregateAssetView ve CampaignAggregateAssetView için artık çeşitli yeni metrikler kullanılabiliyor. Ayrıca, ChannelAggregateAssetView ve CampaignAggregateAssetView için daha önce Maksimum Performans kampanyalarında sıfırlanan impressions artık gerçek değerini raporlayacak.

• AssetSet kaynağı ChangeStatus ile seçilebilir hale getirdik. Böylece kullanıcılar tek bir sorguda AssetSet veya CampaignAssetSet türündeki kaynaklar hakkında daha fazla bilgi edinebilir.

• CampaignAssetSet kaynağını ChangeStatus ile seçilebilir hale getirdik. Böylece kullanıcılar, tek bir sorguda AssetSet veya CampaignAssetSet türündeki kaynak hakkında daha fazla bilgi edinebilir.

• Kampanya arama terimi görünümünde seçilebilen yeni bir segment search_term_targeting_status eklendi.

• Yeni bir final_url_expansion_asset_view eklendi.

• AssetGroup raporunda value_adjustment ve all_value_adjustment metrikleri için destek eklendi.

• AssetGroupAsset, ad_network_type tarafından segmentlere ayrılabilir hale getirildi.

• landing_page_source adlı yeni bir segment eklendi. Bu segment, landing_page_view kaynağıyla birlikte kullanılabilir.

• Arama terimi ve kampanya arama terimi görünümlerinde seçilebilen yeni bir segment search_term_match_source eklendi.

• Anahtar kelime görünümünden seçilebilen yeni bir segment match_type eklendi.

• Aşağıdaki özelliklere sahip benzersiz sorgu amacı kümeleri için metrik desteği eklendi:

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• Araç öğelerine özgü reklam biçimleriyle ilgili tıklamaları izlemek ve raporlamak için click_view segmentasyonuna yeni bir tıklama türü VEHICLE_ASSETS eklendi.

Arama Ağı'nda hedef ROAS teklif stratejileri için Akıllı Teklif Araştırması

• Artık MaximizeConversionValue ve TargetRoas teklif stratejilerinde target_roas_tolerance_percent_millis alanını 10.000 (%10) ile 30.000 (%30) arasında 1.000'e bölünebilen herhangi bir değere ayarlayarak Arama Ağı kampanyalarında Akıllı Teklif Araştırması'nı etkinleştirebilirsiniz. MaximizeConversionValue teklif stratejileri için target_roas alanının da ayarlanması gerekir. TargetRoas.target_roas_tolerance_percent_millis yalnızca portföy stratejilerinde kullanılabilir. Akıllı Teklif Araştırması ile ilgili blog yayınımıza ve Yardım Merkezi makalemize göz atın.

• Benzersiz sorgu amacı kümeleri için aşağıdaki metriklerde artık toplu çeşlilik raporlaması desteklenmektedir. Google Ads kullanıcı arayüzünde zamana göre segmentlere ayrılmış bir görünüm mevcuttur.

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

Video

• YouTubeVideoListAsset eklendi. Ayrıca, campaign ve YouTubeVideoListAsset türü arasında bağlantı oluşturmak için kullanılabilecek Asset#youtube_video_list_asset eklendi. İlgili videoları kullanma başlıklı Yardım Merkezi makalesine göz atın.

• YouTubeChannelInsights ve YouTubeVideoAttributeMetadata öğelerine yeni meta veri alanları eklendi.

• Yeni tıklama türleri kullanıma sunuldu: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK ve PRODUCT_ASSETS.

• Video duyarlı reklamların atlanamayan yayın içi reklamlar olarak yayınlanmasına olanak tanımak için VideoAdInventoryControl'a allow_non_skippable_in_stream alanı eklendi. Bu seçenek, atlanamayan biçimin diğer biçimlerle birlikte kullanılmasını destekleyen kampanyalarda kullanılabilir.

• Campaign.VideoCampaignSettings.video_ad_sequence ve AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting alanları (salt okunur) eklendi. Video reklam sıralama hakkında başlıklı Yardım Merkezi makalesine bakın.

• YouTubeChannelInsights ve YouTubeVideoAttributeMetadata öğelerine yeni meta veri alanları eklendi.

• CampaignCriterion ve AdGroupCriterion'ye VIDEO_LINEUP ölçüt türü ve video_lineup alanı eklendi. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir. Ayrıntılı bilgi için Google iş geliştirme temsilcinizle iletişime geçin.

• Hem ayrıntı hem de grup düzeyi için içerik uygunluğu raporu eklendi. "İçerik uygunluğu" raporu hakkında başlıklı Yardım Merkezi makalesine bakın.

Arşivlenmiş sürüm notları

Arşivlenmiş sürüm notları için Destek sonlandırılan sürümler başlıklı makaleye bakın.