Son sürüme yükseltme

Belli aralıklarla, Chrome Tarayıcı'nın eski bir ana sürümünden yeni bir Google Ads API'yi daha yeni bir ana sürüme geçirmelisiniz. Bunun nedeni, bir sürümün kullanımdan kaldırılması veya yeni bir özelliği kullanmak istemeniz olabilir. Her zaman en yeni sürüme geçmenizi öneririz.

Planlarınızı planlamak için kullanımdan kaldırma programımıza göz atın yükseltmeleri gerekir. Nasıl yapılacağını öğrenmek için sürüm oluşturma kılavuzumuza bakın. nasıl çalışır?

Yükseltme işlemine başlamanıza yardımcı olacak bir yapılacaklar listesi aşağıda verilmiştir:

  1. Büyük sürümleri değiştirdiğinizde uç noktanız değişir. Güncelleme istemci kitaplıklarını kullanın.
  2. Sürüm notlarını inceleyerek her sürümde tanıtıldı.
  3. Yükselttiğiniz sürümde odaklanmanız gereken alanlar için aşağıdaki tablolara göz atın.

Şuradaki protolar arasındaki farka dayalı değişikliklere kapsamlı bir genel bakış için: fark tablosuna bakın.

v17 ila v18

Hizmetlerde ve bileşenlerinde yapılan değişiklikler
GoogleAdsService Search ve SearchStream istekleri

Çok pahalı olduğu için isteğiniz kısıtlandığında hata QuotaError.RESOURCE_EXHAUSTED yerine QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION veya QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION olur. Daha fazla bilgi için blog yayınını inceleyin.

GoogleAdsService SearchGoogleAdsRequest içindeki summary_row_setting ve return_total_results_count alanları artık yeni SearchSettings nesnesinin bir parçasıdır.
AssetType DISCOVERY_CAROUSEL_CARD enum değeri DEMAND_GEN_CAROUSEL_CARD olarak yeniden adlandırıldı. Bu, Discovery kampanyalarının adının Talep Yaratma kampanyaları olarak değiştirilmesiyle ilgili önceki bir değişiklikle aynı doğrultudadır.
AudienceInsightsService.GenerateSuggestedTargetingInsights audience, baseline_audience ve data_month alan audience_definition alanı için geçerlidir.
DemandGenCampaignSettings upgraded_targeting alanı için varsayılan değer artık şu şekilde: false yerine true.
LocalServicesLeadConversation phone_call_details.call_recording_url alanı kullanımdan kaldırılacak doldurulacağından emin olun.

v16 ila v17

Hizmetlerde ve bileşenlerinde yapılan değişiklikler
GoogleAdsService Search ve SearchStream istekleri

Sorgu çok pahalıysa isteğiniz sınırlandırılabilir. Eğer öyleyse, QuotaError.RESOURCE_EXHAUSTED hata mesajı alırsınız. Daha fazla bilgi için blog yayınını inceleyin.

GoogleAdsService Search istek.

GoogleAdsService.Search adlı çocuğa page_size verilir RequestError.PAGE_SIZE_NOT_SUPPORTED hatasıyla sonuçlanacak.

Campaign ve Ad

AdvertisingChannelType of DISCOVERY olan kampanyalar artık AdvertisingChannelType of DEMAND_GEN olacak.

Ayrıca, bazı reklamların raporlama türü ve alan adları değişecek:

  • DISCOVERY_MULTI_ASSET_ADD, DEMAND_GEN_MULTI_ASSET_ADD olur ve karşılık gelen raporlama alanı ad_group_ad.ad.discovery_multi_asset_ad, ad_group_ad.ad.demand_gen_multi_asset_ad olur.
  • DISCOVERY_CAROUSEL_AD şuna dönüşecek: DEMAND_GEN_CAROUSEL_AD ve ilgili raporlama alanı ad_group_ad.ad.discovery_carousel_ad şuna dönüşecek: ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD şuna dönüşecek: DEMAND_GEN_VIDEO_RESPONSIVE_AD ve ilgili raporlama alanı ad_group_ad.ad.discovery_video_responsive_ad şuna dönüşecek: ad_group_ad.ad.demand_gen_video_responsive_ad

AdService GetAd uç noktası kaldırılır. 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 nesneleri getirme konulu kılavuzumuza göz atın.
CustomerLifecycleGoal ve CampaignLifecycleGoal Yaşam döngüsü hedefleri için segmentleri yönetme şekliniz yeniden düzenlendi. İlgili segmenti görüntüleyin. hakkında daha kapsamlı bilgi edinmek için yaşam döngüsü hedefleri genel bakış.
ProductLink product_link için GoogleAdsService arama veya arama akışı isteği gönderirken artık yalnızca bir bağlı ürünle ilgili alanları seçebilirsiniz. Farklı bağlı ürünlerden birden fazla alan seçerseniz QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE hatası alırsınız.
Raporlama metrics.sk_ad_network_conversion_value alanının adı metrics.sk_ad_network_fine_conversion_value olarak değiştirildi.