Sürüm Notları

v19.1 (16.04.2025)

19.1 sürümüne aşağıdaki özellikler ve değişiklikler eklendi.

Öğeler

• AssetGroup için öğe grubunuzdaki boşluklar hakkında bilgi döndüren bir asset_coverage alanı eklendi.
  • Bir reklamverenin öğe grubunun reklam gücünü artırmak için yapabileceği işlemlerin listesini döndüren bir alt alan ad_strength_action_items içerir.

Kampanyalar

• Artık yerel hizmet kampanyalarındaki hizmet talepleri için puan verebilir veya geri bildirimde bulunabilirsiniz. Bu değişiklik kapsamında, 19.1 sürümü
  • LocalServicesLeadService adlı yeni bir hizmet eklendi. Potansiyel müşteriler için puan ve geri bildirim yüklemek üzere ProvideLeadFeedback yöntemini kullanabilirsiniz.
  • Bir potansiyel müşteriye geri bildirim gönderilip gönderilmediğini belirlemeye yardımcı olmak için LocalServicesLead alanına lead_feedback_submitted adlı yeni bir alan eklendi.
• Uygulama kampanyaları için yeni bir metrik sütunu biddable_cohort_app_post_install_conversions eklendi.

Talep Yaratma

• Talep Yaratma'yı desteklemek için planlama hizmetlerine ek yöntemler eklendi.

• Reklam grubu düzeyinde Talep Yaratma kampanyaları için kanal kontrolleri desteği eklendi. demand_gen_ad_group_settings alanını kullanarak önceden tanımlanmış genel bir kanal grubunu veya kanalların bir alt kümesini seçebilirsiniz. Mevcut sürümde aşağıdaki kanallar desteklenir:

  • YouTube Yayın İçi
  • YouTube Feed İçi
  • YouTube Shorts
  • Keşfet
  • Gmail
  • Görüntülü Reklam Ağı

• TALL_PORTRAIT_MARKETING_IMAGE için yeni bir öğe türü kullanıma sunuldu. Bu öğe türü, Talep Yaratma Çoklu Öğe Reklam biçiminin tall_portrait_marketing_images alanıyla ilgilidir.

Değişiklik Geçmişi

• ChangeStatusResourceType işlevine üç kaynak türü daha eklendi:
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• Bu üç ayrıntılı türü change_status raporundan alabilirsiniz.

Dönüşümler

• Artık Google Ads API'yi kullanarak yeni bir müşteri oluştururken google_ads_conversion_customer alanını ayarlayabilirsiniz. Bu alan daha önce salt okunurdu.
• Artık çevrimdışı dönüşümleri yüklerken dönüşümle ilişkili müşterinin türünü belirtebilirsiniz.
• ClickConversion için yeni bir session_attributes alanı kullanıma sunuldu.

Yerel Hizmet Reklamları

• LocalServicesLead kalitesiyle ilgili geri bildirim sağlamak için LocalServicesLeadService'e yeni bir RPC ProvideLeadFeedback eklendi.
• LocalServicesLead kaynağına, belirli bir kaynak için geri bildirim sağlanıp sağlanmadığını doğrulayan yeni bir lead_feedback_submitted alanı eklendi.

Planlama hizmetleri

• ReachPlanService.GenerateReachForecast sürümünde hedef sıklık aylık tahminleri için destek eklendi.
  • Geliştiriciler, TARGET_FREQUENCY planlanabilir ürün kodunu kullanırken TargetFrequencySettings içinde TargetFrequencyTimeUnit.MONTHLY ayarlayarak aylık hedef sıklık erişimi tahmini oluşturabilir.
• Reklamverenlerin, desteklenen planlanabilir ürünler için önerilen dönüşüm oranlarını istemelerine olanak tanıyan yeni bir yöntem ReachPlanService.GenerateConversionRates eklendi.
• ReachPlanService.GenerateReachForecast'te Talep Yaratma öngörüsü:
  • Geliştiriciler artık Talep Yaratma kampanyaları için erişim tahminleri isteyebilir. Geliştiriciler, Talep Yaratma erişim tahminleri oluşturmak için yeni DEMAND_GEN_MAX_CONVERSIONS planlanabilir ürün kodunu kullanabilir.
  • Talep Yaratma erişim tahminleri isteyen geliştiricilerin dönüşüm oranı sağlamasına olanak tanıyan yeni bir conversion_rate alanı eklendi. Önerilen dönüşüm oranları yeni ReachPlanService.GenerateConversionRates yöntemi kullanılarak alınabilir. Bu alan, Talep Yaratma öngörüsü istekleri için gereklidir. Diğer planlanabilir ürünler için desteklenmez.
  • Döndürülen tahminlere yeni bir conversions alanı eklendi. Bu alan, erişim eğrisinin belirli bir noktasındaki dönüşüm sayısını içerir. Dönüşümler yalnızca planlanabilir DEMAND_GEN_MAX_CONVERSIONS ürün için desteklenir.

Öneriler

• Yeni ad_strength alanı, ImprovePerformanceMaxAdStrengthRecommendation için kullanılabilir. Bu alan, öneriyle ilişkili öğe grubunun mevcut reklam gücü puanını döndürür.

Alışveriş

• Artık Maksimum Performans kampanyalarındaki Alışveriş reklamları için marka hariç tutmalarını geçersiz kılabilirsiniz. Bu özellik, kampanya düzeyinde yeni bir pmax_campaign_settings alanı aracılığıyla sunulur ve yalnızca perakende için PMax kampanyalarında çalışır. Bu alanı uyumlu olmayan bir kampanya türü için ayarlamaya çalışırsanız yeni bir CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED hata mesajı gösterilir.

Videolar

• Sesli reklamlar için salt okuma desteği eklendi. Bu özellik hakkında bilgi edinmek için Google Ads Yardım Merkezi'ni inceleyin. Bu değişiklikle aşağıdakiler gösterilir:
  • YOUTUBE_AUDIO adlı yeni bir AdvertisingChannelSubType.
  • YOUTUBE_AUDIO adlı yeni bir AdGroupType.
  • YOUTUBE_AUDIO_AD adlı yeni bir reklam biçimi dizilimi ve buna karşılık gelen YouTubeAudioAdInfo alanları.
• Demografik grup ayarlamasıyla sorgu erişim metrikleri'ne yeni metrikler ve segmentler eklendi. Bu değişiklikler kapsamında,
  • coviewed_impressions ve primary_impressions adlı iki yeni metrik sütunu kullanıma sunuldu.
  • adjusted_age_range ve adjusted_gender adlı iki yeni segment kullanıma sunuldu.
  • İki yeni segmentten biri bir erişim metriği alanıyla (coviewed_impressions, primary_impressions, unique_users veya average_impression_frequency_per_user) birlikte seçilirse bu sütunlar için geçerli istatistikler almak üzere diğer segmentin de seçilmesi gerekir.
  • Bu özellik şu anda yalnızca izin verilenler listesindeki müşteriler tarafından kullanılabilir.

v19 (26.02.2025)

19. sürüme aşağıdaki özellikler ve değişiklikler eklendi.

Hesap Yönetimi

• Yaklaşan değişiklikleri hesaba katmak için CustomerError alanına aşağıdaki değerler eklendi:
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

Reklamlar

• Talep Yaratma reklamlarında 9:16 en boy oranına sahip dikey resim öğelerini desteklemek için DemandGenMultiAssetAdInfo.tall_portrait_marketing_images eklendi.

Öğeler

• (Yalnızca izin verilenler listesine eklenen hesaplar için) Asset.business_message_asset, BusinessMessageAsset ve aşağıdaki enumlar ve hatalar aracılığıyla mesaj öğeleri için destek eklendi.
  • Enums:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • Hatalar:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• Açılış sayfası önizlemesinin otomatik olarak oluşturulmasını desteklemek için AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW eklendi.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS, Talep Yaratma video duyarlı reklamları için artık varsayılan olarak etkinleştirilmiştir.
• (Yalnızca izin verilenler listesindeki hesaplar için; izin verilenler listesi şu anda kapalıdır) Asset.app_deep_link_asset ve AppDeepLinkAsset eklendi.

Dönüşümler

• Dönüşüm hedefleri
  • LifecycleGoalValueSettings.high_lifetime_value artık beta sürümünden çıkmış ve değiştirilebilir durumdadır.
  • Müşteri yaşam döngüsü hedefine sahip müşterinin kaynak adını göstermek için CustomerLifecycleGoal.owner_customer eklendi.
• ConversionActionType.SALESFORCE özelliği kullanımdan kaldırıldı.

Feed'ler

• Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view gibi feed ile ilgili tüm öğeler kaldırıldı. Kullanıcılar artık aynı amaca ulaşmak için assets öğesini kullanmalıdır. Kaldırılan tüm öğelerin listesi için Taşıma Notları sayfasını ziyaret edin.

Otel ve Seyahat

• Değer olarak 0 değerinin belirtilmesine izin vermek için optional alanından ValueRuleItineraryAdvanceBookingWindow min_days ve max_days oluşturuldu. Bu, şu anda yapılan seyahat aramaları için hedeflemeyi destekler.

Maksimum Performans

• (Yalnızca izin verilenler listesine eklenen hesaplar için) Marka kuralları
  • Campaign.brand_guidelines_enabled yalnızca Maksimum Performans kampanyası oluştururken değiştirilebilir hale getirildi.
  • Bu özellik, seyahat hedefleri için Maksimum Performans ile uyumlu değildir.
  • Mevcut Maksimum Performans kampanyaları için marka kurallarını etkinleştirmek üzere yeni eklenen bir CampaignService.EnablePMaxBrandGuidelines kullanın. Marka kurallarının devre dışı bırakılması desteklenmez.
  • Markanın renklerini ve yazı tipi ailesini ayarlamanıza olanak tanımak için Campaign.brand_guidelines ve BrandGuidelines eklendi.
  • Yeni hata değerleri:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
    • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
    • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
    • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
    • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
    • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
    • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• Maksimum Performans kampanyaları için geliştirilmiş video öğelerinin otomatik olarak oluşturulmasını desteklemek amacıyla AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS eklendi.

Planlama

• (Yalnızca izin verilenler listesinde yer alan hesaplar için) Kullanıcıların belirli kitle tanımları için YouTube'da trend olan içerik konularını görmesine olanak tanıyan ContentCreatorInsightsService.GenerateTrendingInsights özelliği eklendi.
• Belirtilen ölçütlere göre aranacak ülkeleri belirtmek için GenerateCreatorInsightsRequest.country_locations[] eklendi
• İçerik üretici aramak için bir marka belirtmek üzere GenerateCreatorInsightsRequest.search_brand eklendi
• search_channels isteklerine yönelik ek kanal bilgileri sağlamak için YouTubeChannelInsights alanına yeni alanlar eklendi:
  • channel_url
  • channel_description
  • top_videos
• AudienceInsightsAttributeMetadata alanına yeni meta veri alanları eklendi:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

Videolar

• DataLinkService.CreateDataLink sürümünün kullanıma sunulmasının ardından, daha önce oluşturulmuş veri bağlantılarının değiştirilmesine olanak tanımak için aşağıdaki yöntemleri ekledik:
  • Google Ads hesabındaki veri bağlantılarını kaldırmak için RemoveDataLink
  • Google Ads hesabındaki veri bağlantılarını kabul etmek, reddetmek ve iptal etmek için UpdateDataLink
• Aşağıdaki enum'lardan VIDEO_OUTSTREAM desteği kaldırıldı:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

v18 (16.10.2024)

18. sürüme aşağıdaki yeni özellikler ve güncellemeler eklendi.

Hesap Yönetimi

• (Yalnızca izin verilenler listesine eklenen hesaplar için) Bir Google Ads hesabının, içerik üreticinin YouTube kanalında barındırılan içerik üretici videolarına bağlanmasına olanak tanıyan DataLinkService.CreateDataLink eklendi. Video bağlama, Google Ads hesabının içerik üretici videolarını kullanarak iş ortağı reklamları yayınlamasına olanak tanır.

Reklam Grupları

• optimized_targeting_enabled true olduğunda demografinin genişletilmesini hariç tutmanıza olanak tanıyan AdGroup.exclude_demographic_expansion özelliği eklendi. Bu özellik daha önce yalnızca Talep Yaratma kampanyalarında destekleniyordu.

Reklamlar

• Reklamların otomatik öğe oluşturmayı etkinleştirmesine veya devre dışı bırakmasına olanak tanıyan AdGroupAd.ad_group_ad_asset_automation_settings özelliği eklendi.
• AssetAutomationType alanına aşağıdaki değerler eklendi:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• YouTube, Gmail ve Keşfet feed'i gibi Google'a ait kanallarda yayınlanan reklamlar tarafından kullanılan AdNetworkType.GOOGLE_OWNED_CHANNELS eklendi.

Öğeler

• AssetType.DISCOVERY_CAROUSEL_CARD, AssetType.DEMAND_GEN_CAROUSEL_CARD olarak yeniden adlandırıldı.

Kampanyalar

• Bir kampanyanın son tıklama modeliyle ilişkilendirilen mağaza ziyareti sayısını döndüren metrics.store_visits_last_click_model_attributed_conversions eklendi.
• Bir kampanya için video görüntülemeyle ilgili aşağıdaki metrikler eklendi:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• Bir kampanyanın birleşik hedefleri sonuçları için dönüşüm satın alma işlemlerini döndüren metrics.results_conversions_purchase eklendi.
• DemandGenCampaignSettings.upgraded_targeting için varsayılan değer false yerine true olarak değiştirildi.

Ölçüt

• Görüntülü Reklam Ağı, Talep Yaratma ve video kampanyaları için hedeflenen içeriklerin (ör. anahtar kelimeler, yerleşimler ve konular) performans metriklerini döndüren content_criterion_view eklendi.

Otel ve Seyahat

• Arama Ağı Reklamlarındaki Seyahat Feed'leri için destek
  • Arama Ağı Reklamlarındaki Seyahat Feed'leri metriklerini segmentlere ayırmaya olanak tanımak için ClickType.TRAVEL_ASSETS eklendi.
  • Arama Ağı reklamlarında Seyahat feed'ini etkinleştirmek ve devre dışı bırakmak için kullanılabilen AssetSetType.TRAVEL_FEED eklendi.
• (Yalnızca izin verilenler listesindeki hesaplar için) Seyahat planı, aşağıdaki yeni alanlar ve değerlerle yeni bir dönüşüm değeri kuralı olarak eklendi:
  • ConversionValueRule.itinerary_condition ValueRuleItineraryCondition ile birlikte, erken rezervasyon aralığı, seyahat planı uzunluğu ve seyahatin başlangıç günü (haftanın günü) belirtebilirsiniz.
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• Otel ve Arama Ağı kampanyaları için performans verilerini belirli hedeflere (şehirler, ülkeler ve bölgeler) göre segmentlere ayırmaya olanak tanımak amacıyla campaign ve ad_group raporları için aşağıdaki segmentler eklendi:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

Yerel Hizmetler

• Belirli bir Yerel Hizmetler potansiyel müşterisi sohbeti için arama kaydı yoksa PhoneCallDetails.call_recording_url, geçersiz bir URL yerine boş olur.
• Campaign.local_services_campaign_settings aracılığıyla bir kategori için hedef EBM'nin ayarlanmasına olanak tanıyan CategoryBid.target_cpa_bid_micro eklendi.

Maksimum Performans

• Marka kurallarıyla ilgili destek
  • Belirli bir Maksimum Performans kampanyasında marka kurallarının etkin olup olmadığını gösteren Campaign.brand_guidelines_enabled eklendi. Bu özellik etkinleştirilirse field_type değeri BUSINESS_NAME, LOGO veya LANDSCAPE_LOGO olarak ayarlanmış öğeler AssetGroupAsset kaynağı yerine CampaignAsset kaynağı olarak bağlanmalıdır.
  • Marka yönergelerinin etkin olduğu Maksimum Performans kampanyalarında kampanyaya bağlı gerekli CampaignAssetkaynaklar bulunmadığını belirten CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED ve CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED hataları eklendi.
  • Marka yönergeleri etkinleştirildiğinde, field_type değeri BUSINESS_NAME olarak ayarlanmış en az bir öğe ve LOGO değeri CampaignAsset olarak ayarlanmış en az bir öğe kampanyaya kaynak olarak bağlanmalıdır. Ürün feed'i olan online satışlar için Maksimum Performans kampanyaları bu koşulu yalnızca kampanyanın öğe gruplarına bağlı öğeler olduğunda karşılamalıdır.
  • AssetLinkError alanına aşağıdaki değerler eklendi:
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, etkinleştirilmemiş marka yönergelerine sahip Maksimum Performans kampanyalarında marka öğelerini kampanyalara AssetGroupAsset kaynağı yerine CampaignAsset kaynağı olarak bağlamaya çalışırken ortaya çıkar.
    • Marka kurallarının etkin olduğu Maksimum Performans kampanyalarında marka öğelerini kampanyalara CampaignAsset kaynakları yerine AssetGroupAsset kaynakları olarak bağlamaya çalışırken ortaya çıkan BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL hatası.
• Maksimum Performans reklamlarının yayınlandığı yerleşimlerin gösterimlerini döndüren performance_max_placement_view eklendi.
• AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION eklendi

Planlama

• (Yalnızca izin verilenler listesine eklenen hesaplar için) Kullanıcıların en popüler YouTube içerik üreticileriyle ilgili analizleri keşfetmesine olanak tanıyan ContentCreatorInsightsService.GenerateCreatorInsights yöntemiyle yeni bir hizmet eklendi. Bu sayede müşteriler, kitle hedefleme ve içerik hedefleme kombinasyonuyla içerik üreticileri arayabilir veya YouTube kanalı kimliklerinin listesi ile içerik üretici analizlerini arayabilir.
• AudienceInsightsService.GenerateSuggestedTargetingInsights ile ilgili güncellemeler:
  • audience, baseline_audience ve data_month, audience_definition klasörüne taşındı.
  • Üretken yapay zeka kullanarak serbest biçimli metin açıklamasından hedefleme önerileri oluşturmak için audience_description eklendi.
• Belirli kitle hedefleme kombinasyonları için potansiyel erişim metriklerini döndüren AudienceInsightsService.GenerateTargetingSuggestionMetrics işlevi eklendi.

Öneriler

• RecommendationService.GenerateRecommendations, artık GenerateRecommendationsRequest.recommendation_types[]'a CAMPAIGN_BUDGET öneri türünü ekleyerek kampanya oluşturma sırasında optimize edilmiş bütçe önerileri hakkında öneriler oluşturmak için kullanılabilir. Bu özellik, Maksimum Performans ve Arama Ağı kampanyalarında kullanılabilir.

Raporlama

• SearchGoogleAdsRequest öğesinin summary_row_setting ve return_total_results_count alanlarını, SearchSettings türündeki search_settings alanıyla aşağıdaki alanlarla değiştirdi:
  • omit_results
  • return_summary_row
  • return_total_results_count
• Botlar veya tarayıcılar tarafından oluşturulan, düzensiz kalıplara sahip olanlar gibi genel geçersiz tıklamalarla ilgili aşağıdaki yeni metrikler eklendi. Bu raporlar campaign raporuyla sorgulanabilir.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• QuotaError alanına aşağıdaki değerler eklendi:
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (07.08.2024)

17_1 sürümüne aşağıdaki yeni özellikler ve güncellemeler eklendi.

Öğeler

• AdGroupAdService.RemoveAutomaticallyCreatedAssets(), Duyarlı Arama Ağı reklamlarına bağlı belirli otomatik olarak oluşturulmuş öğeleri kaldırmanıza olanak tanır.

Kitleler

• UserListCustomerTypeCategory alanındaki yeni enum değerleri:
  • LOYALTY_TIER_1_MEMBERS
  • LOYALTY_TIER_2_MEMBERS
  • LOYALTY_TIER_3_MEMBERS
  • LOYALTY_TIER_4_MEMBERS
  • LOYALTY_TIER_5_MEMBERS
  • LOYALTY_TIER_6_MEMBERS
  • LOYALTY_TIER_7_MEMBERS

Kampanyalar

• ShareablePreviewService.GenerateShareablePreviews(), etkin ve duraklatılmış öğe grupları için paylaşılabilir reklam önizlemelerinin yanıtında URL'leri shareable_preview_url oluşturur.
  • expiration_date_time alanı, yanıttaki URL'lerin geçerlilik bitiş tarihini belirtir.
  • Hata meydana gelirse yöntem, URL'ler yerine partial_failure_error döndürür.

Değişiklik Geçmişi

• Yeni durum değişikliği kaynağı türü: ASSET_GROUP.

Dönüşümler

• SKAdNetwork sürümü için yeni segment alanı: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, dönüşüm yükleme teşhislerini dönüşüm işlemi düzeyinde gösterir.
• Yüklenen ve hâlâ işlenmekte olan dönüşümlerin sayısını iletmek için çevrimdışı teşhis raporlarına aşağıdaki metrikler eklenir:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

Planlama

• AudienceInsights.GenerateAudienceOverlapInsights(), bir giriş birincil özelliğini ve bir kitle özelliği koleksiyonunu kabul eder ve birincil özellik ile kitle özellikleri arasındaki potansiyel YouTube erişiminin çakışma tahminlerini döndürür.

Raporlama

• segments.date'e göre per_store_view segmentlerine ayırma desteği

Videolar

• ad_group, campaign gibi raporları kullanan video kampanyaları için aşağıdaki standart teklif stratejileriyle ilgili bilgileri alma desteği:
  • Campaign.fixed_cpm (Sabit BGBM (bin gösterim başına maliyet))
  • Campaign.target_cpv (Hedef GBM (görüntüleme başına maliyet))
• Campaign.video_campaign_settings Aşağıdaki rapor alanlarını kullanarak video reklamların hangi envanterde gösterilebileceğini belirlemenize olanak tanır:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type, aşağıdaki raporları video reklam biçimi türüne göre segmentlere ayırmanıza olanak tanır:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (05.06.2024)

17. sürüme aşağıdaki özellikler ve değişiklikler eklendi.

Reklamlar

• AdService.getAd kaldırıldı. Bu sayede AdService, Google Ads API'deki diğer hizmetlerle uyumlu hale getirilir. Reklamları ve diğer kaynak türlerini getirmenin önerilen yolu için Öğeleri getirme bölümüne bakın.
• Boyutlar ve biçimle ilgili olarak ImageAdInfo.image_asset için daha fazla doğrulama eklendi. Görüntü geçersizse aşağıdaki hatalar oluşabilir:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Öğeler

• Yeni bir enum eklendi: ClickType.AD_IMAGE
• Maksimum Performans ve Arama Ağı kampanyaları için yeni metrikler içeren aşağıdaki yeni raporlar eklendi:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Kitleler

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED eklendi

Toplu İşler

• Gönderilen AddBatchJobOperationsRequest 10484504 bayttan büyük olduğunda BatchJobError.REQUEST_TOO_LARGE eklendi.
• BatchJobService kullanılırken MutateOperation.asset_group_operation ayarlama desteği eklendi. Bu sayede, Maksimum Performans kampanyalarının tamamını oluşturmak ve yönetmek için toplu işleme özelliğini kullanabilirsiniz. Yeni özel kılavuzumuza göz atın.

Kampanyalar

• Google Ads API'deki tüm kaynakların (ör. kampanyalar, reklamlar ve öğeler) tüm alanlarında, listelerinde ve hatalarında Discovery, Talep Yaratma olarak yeniden adlandırıldı. Örneğin, AdvertisingChannelType.DISCOVERY artık AdvertisingChannelType.DEMAND_GEN.
• Bir kampanyadaki tüm anahtar kelimeler için anahtar kelime eşleme türünü ayarlamanıza olanak tanımak amacıyla Campaign.keyword_match_type eklendi.

Dönüşümler

• SKAdNetwork dönüşümleri için:
  • segments.sk_ad_network_conversion_value, segments.sk_ad_network_fine_conversion_value olarak yeniden adlandırıldı.
  • segments.sk_ad_network_redistributed_fine_conversion_value eklendi.
• Aşağıdaki metrikler artık sıfır olsa bile yanıtla birlikte döndürülür. Bu sayede diğer metriklerle tutarlı olurlar.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

Ölçütler

• Reklam grubu ölçütünün yayınlanıp yayınlanmadığını veya yayınlanmamasının nedenlerini göstermek için aşağıdaki alanlara eklendi: AdGroupCriterion
  • primary_status
  • primary_status_reasons
• gender_view için metrics.search_impression_share desteği eklendi
• keyword_view için metrics.phone_calls desteği eklendi

Yerel Hizmetler

• EklendiLocalServicesLeadService.AppendLeadConversation() LocalServicesLead'a yeni bir LocalServicesLeadConversation eklemek için kullanılır. Bu LocalServicesLeadConversation, potansiyel müşterinin nasıl oluşturulduğuna bağlı olarak mesajları SMS gibi uygun kanallar aracılığıyla kullanıcılara gönderir.
  • AppendLeadConversationRequest.conversations boyutu 1.000 ile sınırlıdır.
  • Conversation.local_services_lead içinde yalnızca lead_type değeri LeadType.MESSAGE olarak ayarlanmış LocalServicesLead belirtilebilir.
• ConversationType alanına yeni enum değerleri eklendi:
  • WhatsApp üzerinden başlatılan bir görüşmeyi temsil etmek için WHATSAPP.
  • ADS_API, yeni LocalServicesLeadService.AppendLeadConversation() yöntemi kullanılarak tanıtılan bir ileti dizisini temsil eder.
• local_services_verification_artifact alanına aşağıdaki yeni alanlar eklendi:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Raporlama

• Artık product_link sorgusu yaparken yalnızca bağlı bir ürünle ilgili alanları seçebilirsiniz. Birden fazla bağlı ürünün birden fazla alanını seçerseniz QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE hatası alırsınız. Örneğin, aynı sorguda product_link.advertising_partner.customer ve product_link.data_partner.data_partner_id seçilemez.
• GoogleAdsService.Search alanına page_size göndermek RequestError.PAGE_SIZE_NOT_SUPPORTED hatasıyla sonuçlanır.

Alışveriş

• Google Ads kullanıcı arayüzünün Ürünler sayfasına karşılık gelen yeni bir rapor shopping_product eklendi. Bir Google Ads hesabına bağlı Google Merchant Center hesaplarındaki ürünlerin mevcut durumuyla ilgili verilerin döndürülmesini destekler.
  • GoogleAdsService.Search veya GoogleAdsService.SearchStream'yi kullanırken segments.date'i kullanarak shopping_product raporundaki metrikleri filtreleyebilirsiniz. Tarihe göre segmentasyona izin verilmez ve bu işlem ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION hatası döndürür.

Birleştirilmiş Hedefler

• Kitle müşteri türlerini yapılandırmak için UserListCustomerTypeService.MutateUserListCustomerTypes() eklendi.
• CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings kaldırıldı. Müşteri yaşam döngüsü hedeflerinin kitle ayarlarını yapılandırmak için bunun yerine UserListCustomerTypeService.MutateUserListCustomerTypes() kullanın.
  • Müşteri yaşam döngüsü hedefleri için bir kullanıcı listesini mevcut bir müşteri tanımına dahil etmek veya mevcut müşteri tanımından hariç tutmak üzere UserListCustomerType.customer_type_category değerini UserListCustomerTypeCategory.PURCHASERS olarak ayarlayarak kullanıcı listesini ekleyin veya kaldırın. Daha fazla bilgi için kitlelerinizi segmentlere ayırma başlıklı makaleyi inceleyin.

Videolar

• ContentLabelType alanına aşağıdaki değerler eklendi. Müşteri düzeyinde aşağıdaki ContentLabelTypes öğelerini hariç tutabilirsiniz:
  • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
  • BRAND_SUITABILITY_GAMES_FIGHTING
  • BRAND_SUITABILITY_GAMES_MATURE
  • BRAND_SUITABILITY_HEALTH_SENSITIVE
  • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
  • BRAND_SUITABILITY_NEWS_RECENT
  • BRAND_SUITABILITY_NEWS_SENSITIVE
  • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
  • BRAND_SUITABILITY_POLITICS
  • BRAND_SUITABILITY_RELIGION
• DemandGenVideoResponsiveAdInfo oluştururken video öğeleri için envanter tercihlerini desteklemek amacıyla AdVideoAsset.ad_video_asset_info eklendi.
• (Yalnızca izin verilenler listesindeki hesaplar) Değiştirilebilir hale getirilir.Campaign.video_brand_safety_suitability

Arşivlenmiş sürüm notları

Arşivlenmiş sürüm notları için Desteği sonlandırılan sürümler bölümüne bakın.