Sürüm notları

23 sürümü (28.01.2026)

v23'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

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

Öğeler

Faturalandırma

Kampanyalar

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

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ş "Kendin Seç" (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 kaynak, GoogleAdsService.Search ve GoogleAdsService.SearchStream aracılığıyla sorgulanabilir. Kullanılan teşviklerle ilgili ayrıntıları (ör. durum, tamamlanma ilerleme durumu, ödül tutarları ve ilgili tarihler) gösterir.
    • 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ı bir şekilde 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

Öneriler

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

Raporlar

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çi metrikleri 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.
  • AdGroupCriterion öğesine vertical_ads_item_group_rule_list ölçüt türü eklendi. SharedCriterion listesine vertical_ads_item_group_rule 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 reklam veri feed'ini, yapay zeka destekli Maksimum Yapay Zeka'nın kullanıldığı bir arama ağı kampanyasına bağlayarak mülk tanıtımı ve rezervasyon bağlantısı 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 reklam verileri feed'indeki öğelerinizin bir alt kümesini hedeflemek için bir dizi öğe grubu kuralı tanımlayabilirsiniz. Ayrıca, raporlama artık hem AdFormatType'a hem de dikey reklamlar veri feed'indeki boyutlara göre segmentlere ayrılabilir.

Video

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 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

Talep Yaratma

Genel

  • AddBatchJobOperations isteği başına 10.000 işlem sınırı eklendi.
  • ListBatchJobResultsRequest hizmetinde page_size alanı için güncellenen işleme:
    • page_size ayarlanmamışsa veya 0 ise artık varsayılan olarak en fazla 1.000 (önceden INVALID_PAGE_SIZE döndürülüyordu) olur.
    • 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).
  • Ödeme profili etkinleştirme oranları sınırı aşıldığında bunu belirtmek için yeni bir hata kodu ( QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED) eklendi.

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 reklamın video öğesi kullanıp kullanmadığını gösterir.

Planlama

Raporlar

Birleştirilmiş hedefler

  • Mevcut müşterilerle yeniden etkileşim kurmak için optimizasyon yapmaya yönelik müşteri elde tutma hedefleri desteği eklendi.

Video

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ında Maksimum Yapay Zeka'yı etkinleştirmek için Campaign öğesinin ai_max_setting.enable_ai_max alanını kullanabilirsiniz. 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 etmeye olanak tanır. Önceki sürüm isteklerinde ayarlanan metin öğesi otomasyonu ve marka listesi kontrolleri, Arama Ağı kampanyaları için Maksimum Yapay Zeka 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ında Maksimum Yapay Zeka'nın 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 Kampanyaları İçin Maksimum Yapay Zeka 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'yı 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 eklendi. Bu görünüm, reklamlarınızı hangi arama sorgularının tetiklediğini ve bu belirli kombinasyonların nasıl performans gösterdiğini gösterir. 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

Kampanyalar

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 CLICK_NOT_FOUND hatasını potansiyel müşteriler için gelişmiş dönüşüm içe aktarma işlemlerinde SUCCESS hatasından ayırt etmek için kullanılıyordu.

Talep Yaratma

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

AB siyasi reklamcılığı ile 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, kampanya veya reklam grubu düzeyinde yakınlık, konum ya da konum grubu hedeflemeyi 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.

  • Denemeler ve denemeler, denemeye ait kampanyalarda Avrupa Birliği'ni hedefleyen siyasi reklamlar olup olmadığı beyan edilmediyse 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 toplanan 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

Raporlar

Video

20.1 sürümü (06.08.2025)

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

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

  • 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.

    Mevcut kampanyalarda, kampanya veya reklam grubu düzeyinde yakınlık, konum ya da konum grubu hedeflemeyi 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.

  • Denemeler ve denemeler, denemeye ait kampanyalarda Avrupa Birliği'ni hedefleyen siyasi reklamlar olup olmadığı beyan edilmediyse ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION hatası verir.

v20 (2025-06-04)

v20'ye 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.

Öğeler

asset_group raporu için birkaç yeni metrik ve segment sütunu eklendi.

Metrik sütunları

Segment sütunları

Kampanyalar

Dönüşümler

  • Artık hesaplar arası dönüşüm izlemeyi etkinleştirmek veya mevcut dönüşüm izleme üst hesabını farklı bir yönetici hesabıyla değiştirmek için mevcut bir müşterideki google_ads_conversion_customer alanını güncelleyebilirsiniz.

  • ClickConversion.user_ip_address alanı eklendi. Google Ads, Avrupa Ekonomik Alanı (AEA), Birleşik Krallık (UK) veya İsviçre'deki (CH) son kullanıcılar için IP adresi eşleştirmeyi desteklemez. Lütfen bu bölgelerdeki kullanıcıların paylaşılan IP adreslerini koşullu olarak hariç tutacak bir mantık ekleyin. Kullanıcılara sitelerinizde, uygulamalarınızda ve diğer mülklerinizde topladığınız verilerle ilgili açık ve kapsamlı bilgiler sağladığınızdan ve yasalar veya geçerli Google politikaları uyarınca gerekli olduğu yerlerde izin aldığınızdan emin olun. Daha fazla bilgi için Çevrimdışı dönüşümlerin içe aktarılması hakkında başlıklı sayfayı inceleyin.

Talep Yaratma

Öneriler

  • GenerateRecommendationsRequest kullanılırken kampanya oluşturma sırasında ShoppingSetting için destek eklendi.
    • Önerilerin standart Maksimum Performans kampanyaları yerine perakende için ne zaman oluşturulması gerektiğini belirtmek üzere GenerateRecommendationsRequest öğesine merchant_center_account_id alanı eklendi.

Planlama

  • AudienceInsightsDimension.YOUTUBE_LINEUP, AudienceInsightsService ve ContentCreatorInsightsService içinde AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP yerine kullanılmak üzere eklendi. Bu yeni boyut, YouTube Select (YTS) kanal listeleriyle ilgili analizleri ve meta verileri almanıza olanak tanır. YOUTUBE_DYNAMIC_LINEUP ile ilişkili nesneler (ör. DynamicLineupAttributeMetadata ve AudienceInsightsDynamicLineup), Google Ads'de dinamik sıralamaların daha kapsamlı bir şekilde kaldırılmasıyla uyumlu olacak şekilde değiştirildi. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.
  • AudienceInsightsService, ContentCreatorInsightsService ve ReachPlanService bölümlerine AdditionalApplicationInfo ve ApplicationInstance eklendi. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.
  • Daha ayrıntılı analizler sunmak için AudienceInsightsService ve ContentCreatorInsightsService güncellendi. Artık her iki hizmette de yeni AudienceInsightsDimension.DEVICE ve AudienceInsightsAttribute.device kullanarak içerik üreticisi verilerini cihaza göre segmentlere ayırabilirsiniz. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.
  • Daha kapsamlı içerik üretici analizi için GenerateCreatorInsightsResponse'ye ek toplu video metrikleri eklendi: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count, ve is_brand_connect_creator. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.
  • sub_country_locations, ContentCreatorInsightsService için GenerateCreatorInsightsRequest'a eklendi. Bu sayede, içerik üreticilere dair analizler için aramaları hassaslaştırmak üzere ülke altı coğrafi konumlar belirtilebilir. sub_country_locations alanı yalnızca criteria alanında search_attributes oneof kullanılırken desteklenir. sub_country_locations diğer ölçüt türleriyle birlikte sağlanırsa istek geçersiz olur. Bu sayede, içerik üreticilerin analizleri için daha ayrıntılı coğrafi hedefleme ve analiz yapılabilir. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.
  • Müşteriye ait birinci taraf kullanıcı listelerini döndüren ReachPlanService.ListPlannableUserLists eklendi ve GenerateReachForecastRequest'daki kitle hedefleme seçeneklerine UserListInfo eklendi. Bu sayede, belirli bir müşteri için planlanabilir kullanıcı listelerini alabilir ve ardından bu belirli kitleleri hedefleyen kampanyalar için erişim tahminleri oluşturabilirsiniz. Bu geliştirmeler, birinci taraf kitle verilerinizi doğrudan tahmine dahil ederek özelleştirilmiş erişim planlamasını iyileştirir. Erişim tahmini yalnızca izin verilenler listesindeki hesaplar tarafından kullanılabilir.

Videolar

  • TV ekranlarındaki organik YouTube videolarında yayınlanan AdFormatType.PAUSE reklamları eklendi. Bu reklamlar raporlamaya dahil edilir. Bu reklamlar, duraklatma ekranındaki statik video karesinin hemen yanında gösterilir. Bu, duraklatılmış bir organik videonun altındaki veya üstündeki reklam panelinde gösterilen ve AdFormatType.INFEED altında raporlanan Talep Yaratma video reklamlarını içermez.

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.