Sürüm Notları

17. sürüm (05.06.2024)

17 sürümünde 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 gelir. Reklamları ve diğer kaynak türlerini getirmenin önerilen yöntemi için Nesneleri alma bölümüne bakın.
• ImageAdInfo.image_asset için boyutlar ve biçimle ilgili daha fazla doğrulama eklendi. Resim geçersizse aşağıdaki hatalar oluşabilir:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Öğeler

• Yeni sıralama 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 atanan BatchJobError.REQUEST_TOO_LARGE eklendi.
• BatchJobService kullanılırken MutateOperation.asset_group_operation ayarı için destek eklendi. Bu, Maksimum Performans kampanyalarının tamamını oluşturmak ve yönetmek için toplu işlemeyi kullanmanıza olanak tanır. Yeni özel kılavuzumuzu inceleyin.

Kampanyalar

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

Dönüşüm sayısı

• SKAdNetwork dönüşümleri için:
  • segments.sk_ad_network_conversion_value adlı dosya 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 olduklarında bile yanıtla birlikte döndürülür. Bu, bu metrikleri diğer metriklerle tutarlı hale getirir.
  • 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ınlanmama nedenlerini göstermek için AdGroupCriterion öğesine aşağıdaki alanlara eklendi:
  • 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

• LocalServicesLead öğesine yeni bir LocalServicesLeadConversation eklemek için kullanılan LocalServicesLeadService.AppendLeadConversation() eklendi. Bu kimlik, potansiyel müşterinin nasıl oluşturulduğuna bağlı olarak SMS gibi uygun kanallar üzerinden kullanıcılara mesajlar gönderir.
  • AppendLeadConversationRequest.conversations boyutu 1.000 ile sınırlıdır.
  • Conversation.local_services_lead içinde yalnızca lead_type öğesinin LeadType.MESSAGE olarak ayarlandığı LocalServicesLead belirtilebilir.
• ConversationType öğesine yeni enum değerleri eklendi:
  • WhatsApp üzerinden başlatılan bir görüşmeyi temsil eden WHATSAPP.
  • ADS_API, yeni LocalServicesLeadService.AppendLeadConversation() yöntemi kullanılarak başlatılan bir görüşmeyi 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 sorguları için yalnızca tek bağlı ürün ile ilgili alanları seçebilirsiniz. Birden fazla bağlı ürün için birden fazla alan seçildiğinde QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE hatası verilir. Örneğin, product_link.advertising_partner.customer ve product_link.data_partner.data_partner_id aynı sorguda seçilemez.
• GoogleAdsService.Search öğesine page_size iletmek RequestError.PAGE_SIZE_NOT_SUPPORTED hatasına neden olur.

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 kullanırken segments.date kullanarak shopping_product raporundaki metrikleri filtreleyebilirsiniz. Tarihe göre segmentlere ayırmaya izin verilmez ve bu tür segmentler 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 UserListCustomerTypeService.MutateUserListCustomerTypes() işlevini kullanın.
  • Bir kullanıcı listesini, müşteri yaşam döngüsü hedeflerine yönelik mevcut bir müşteri tanımına dahil etmek veya hariç tutmak için UserListCustomerType.customer_type_category öğesini UserListCustomerTypeCategory.PURCHASERS olarak ayarlayarak kullanıcı listesi ekleyin ya da listeden çıkarabilirsiniz. Daha fazla ayrıntı için kitlelerinizi segmentlere ayırma bölümünü ziyaret edin.

Videolar

• Aşağıdaki değerler ContentLabelType etiketine eklendi. Bu ContentLabelTypes öğesini müşteri düzeyinde 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 öğeleriyle ilgili envanter tercihlerini desteklemek için AdVideoAsset.ad_video_asset_info eklendi.
• (Yalnızca izin verilenler listesindeki hesaplar) Campaign.video_brand_safety_suitability değişebilir hale getirildi.

16.1.0 sürümü (24.04.2024)

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

Hesap Yönetimi

• CustomerNegativeCriterion.ip_block Bu API, bir IP'nin müşteri düzeyinde negatif ölçüt olarak eklenmesini destekler.
• Yeni sıralama değeri: ProductLinkError.LINK_EXISTS.
• Yeni sıralama değeri: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

Öğeler

• ad_group_ad_asset_view ve asset_field_type_view ile ilgili Talep Yaratma ile ilgili öğeler için destek.
• Yeni sıralama değeri: AssetFieldType.DISCOVERY_CAROUSEL_CARD.

Kitleler

• Yeni sıralama değeri: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER Bu değer, müşterilerin sahip olabileceği benzer kullanıcı listelerinin sayısını 1.000 ile sınırlandırır.

Kampanyalar

• campaign_simulation raporu aracılığıyla uygulama kampanyaları için Hedef ROAS kampanya teklif simülasyonlarını döndürme desteği.
• Yeni sıralama değeri: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN.
• Yeni sıralama değeri: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY.
• Yeni sıralama değeri: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS.

Dönüşüm sayısı

• SKAdNetwork 4.0 özelliklerini destekleyen SkAdNetworkConversionValueSchema.postback_mappings.
• MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings olarak CustomerSkAdNetworkConversionValueSchemaService için uyarılar için destek eklendi. true olarak ayarlandığında, işlem hatalarıyla ilgili engellemeyen tüm hatalar MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning olarak döndürülür.
• CustomerSkAdNetworkConversionValueSchemaError içindeki yeni enum değerleri:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Ölçütler

• BrandInfo alanındaki yeni alanlar:
  • display_name
  • primary_url
  • rejection_reason
  • status
• Yeni sıralama: BrandRequestRejectionReason.
• Yeni sıralama değeri: CriterionType.LIFE_EVENT.

Denemeler

• Yeni sıralama değeri: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

Yerel Hizmetler

• local_services_lead.credit_details.credit_state ve local_services_lead.credit_details.credit_state_last_update_date_time, sırasıyla kredi durumunu ve kredi durumu güncellendiğinde zaman damgasını döndürür.
• local_services_lead_conversation.message_details.attachment_urls, ekin içeriklerini indirmek için kullanılabilecek URL'leri döndürür.

Videolar

• Müşteri düzeyinde video marka güvenliği uygunluğu almayı destekleyen customer.video_brand_safety_suitability ve BrandSafetySuitability.
• Yeni sıralama değeri: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

16. sürüm (21.02.2024)

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

Hesap Yönetimi

• advertising_partner, AccountLink kaynağından ProductLink ve ProductLinkInvitation sürümlerine taşındı.
• data_partner ve google_ads, AccountLink reklam grubundan kaldırıldı.
• Reklamveren doğrulamasını yönetmek için IdentityVerificationService eklendi.
  • Sağlanan verification_program ile doğrulama oturumu başlatmak için StartIdentityVerification() kullanılır. Yeni bir doğrulama oturumu oluşturur ve başarıyla oluşturulmuş bir doğrulama için boş bir yanıt döndürür.
    • IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION eklendi.
  • GetIdentityVerification(), IdentityVerification öğesinin birkaç nesnesini döndüren doğrulama bilgilerini almak için kullanılabilir. Her IdentityVerification şunları içerir:
    • verification_program, kimlik doğrulama programı türüdür.
    • Reklamverenin doğrulamayı tamamlaması gereken son tarihle ilgili ayrıntıları içeren identity_verification_requirement
    • Aşağıdakiler dahil olmak üzere doğrulama oturumuyla ilgili ayrıntıları içeren verification_progress:
      • program_status, doğrulama oturumunun mevcut durumunu temsil eder.
      • action_url, doğrulamayı tamamlaması için müşteriyi bir URL'ye yönlendirir.
      • invitation_link_expiration_time, action_url için son kullanma tarihini
  • Sıralamalar:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Hatalar:
    • IdentityVerificationError
• AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT eklendi.

Öğeler

• asset_group'te yapılan değişiklikler:
  • segments.year ve segments.month gibi zamanla ilgili segmentler için destek eklendi.
  • Kaynağı segmentlere ayırmak yerine campaign ilişkilendirilen kaynak yapıldı.

Kampanyalar

• Talep Yaratma kampanyalarında yapılan değişiklikler:
  • Mevcut Talep Yaratma kampanyasına Campaign.shopping_setting ayarlama desteği eklendi.
  • Talep Yaratma kampanyalarının isteğe bağlı ürün feed'ini devre dışı bırakmak için ShoppingSetting.disable_product_feed eklendi.
  • Ad.demand_gen_product_ad ve karşılık gelen DemandGenProductAdInfo eklendi. Bunlar, boş olmayan bir Campaign.shopping_setting değeriyle Talep Yaratma kampanyalarında kullanılabilir.
• Reklam grubunun yayınlanıp yayınlanmadığını veya yayınlanmama nedenlerini göstermek için AdGroup öğesine aşağıdaki alanlara eklendi:
  • primary_status
  • primary_status_reasons
• Reklam grubu reklamının yayınlanıp yayınlanmadığını veya yayınlanmama nedenlerini göstermek için AdGroupAd öğesine aşağıdaki alanlara eklendi:
  • primary_status
  • primary_status_reasons
• Aşağıdaki değerler AdGroupError öğesine eklendi:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

Deneme

• Denemede senkronizasyonun etkinleştirilip etkinleştirilmeyeceğini belirtmek için Experiment.sync_enabled eklendi. Senkronizasyon etkinken, denemeniz çalışırken orijinal kampanyada yapılan değişiklikler otomatik olarak deneme kampanyasına kopyalanır.
• ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE eklendi.
• CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL eklendi.

Otel ve Seyahat

• Seyahat etkinliğinin bulunduğu eyalete ve şehre dayalı listeleme grupları oluşturabilmek amacıyla Aktivite Önerileri reklamı için ListingDimensionInfo öğesine aşağıdaki alanlar eklendi:
  • activity_state
  • activity_city
• travel_activity_performance_view'e aşağıdaki segmentler için destek eklendi:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Yerel Hizmetler

• Reklamverenlerin işletme kaydı doğrulama işleminin ilerlemesini izlemesine olanak tanımak için LocalServicesVerificationArtifact.business_registration_check_verification_artifact ve BusinessRegistrationCheckArtifact eklendi.
• Reklamverenlerin ekledikleri çalışan bilgilerini alabilmesi için yeni bir kaynak local_services_employee eklendi.

Planlama

• score, AudienceInsightsAttributeMetadata adlı alandan kaldırıldı.

Öneriler

• Öneri türleri ve reklam kanalı türleri gibi belirtilen ayarlara göre öneriler döndüren RecommendationService.GenerateRecommendations() eklendi. Bu özellikle kampanya oluşturma sırasında yararlı olur.
• RecommendationMetrics.conversions_value eklendi.
• Anahtar kelime eşleme türü ayarlanmamış olan önerilen anahtar kelimelerde artık UNKNOWN yerine recommended_match_type değeri UNSPECIFIED olarak ayarlandı.
• Aşağıdaki öneri türleri eklendi:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN, dönüşüm değerini artırma teklif stratejisini etkinleştirmenizi önerir.
  • IMPROVE_GOOGLE_TAG_COVERAGE, Google etiketini daha fazla sayfaya dağıtmanızı önerir
  • Maksimum Performans kampanyalarınızda nihai URL genişletmesini etkinleştirmenizi öneren PERFORMANCE_MAX_FINAL_URL_OPT_IN
  • Son 90 gün içinde güncellenmemiş bir müşteri listesini güncellemenizi öneren REFRESH_CUSTOMER_MATCH_LIST
  • CUSTOM_AUDIENCE_OPT_IN: Özel kitle oluşturmanızı önerir
  • LEAD_FORM_ASSET, potansiyel müşteri formu öğelerini kampanya veya müşteri düzeyinde eklemenizi önerir
  • IMPROVE_DEMAND_GEN_AD_STRENGTH, Talep Yaratma kampanyalarında reklam gücünü iyileştirmenizi önerir.

Alışveriş

• Comparison Shopping Service Center hesabına bağlı Alışveriş kampanyalarında daha ayrıntılı hatalar sağlamak için CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT ve CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS eklendi.
• Aşağıdaki değerler AssetGroupListingGroupFilterError öğesine eklendi:
  • DIMENSION_TYPE_NOT_ALLOWED
  • DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
  • FILTER_EXCLUSION_NOT_ALLOWED
  • LISTING_SOURCE_NOT_ALLOWED
  • MULTIPLE_LISTING_SOURCES
  • MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
  • MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
  • PAGE_FEED_FILTER_HAS_PARENT

Yaşam Döngüsü Hedefleri

• Bu işlem türlerini API'deki diğer işlem türleriyle tutarlı hale getirmek için CustomerLifecycleGoalOperation ve CampaignLifecycleGoalOperation bölümlerine update eklendi.

15. sürüm (18.10.2023)

15. sürümde aşağıdaki yeni özellikler ve güncellemeler kullanıma sunulmuştur.

Hesap Yönetimi

• Hesabınız yetkisiz hesap etkinliği nedeniyle askıya alınırsa customer.status ve customer_client.status SUSPENDED olarak döndürülür. Daha önce ENABLED olarak döndürülüyorlardı.
• Google Ads hesabı ile Merchant Center hesabı arasındaki bağlantıyı ekleme ve kaldırma desteği eklendi:
  • ProductLink.merchant_center ve MerchantCenterIdentifier eklendi.
  • LinkedProductType.MERCHANT_CENTER eklendi.
• Hotel Center ve Merchant Center hesaplarında kullanılabilen diğer ürünlerden gönderilen bağlantı davetlerinin güncellenmesini desteklemek için ProductLinkInvitationService ve ProductLinkInvitation eklendi.
• MerchantCenterLinkService kaldırıldı.
  • Google Ads hesaplarını Merchant Center hesaplarına bağlamak için ProductLinkInvitationService ve ProductLinkService tuşlarını kullanın.
• AccountLink.hotel_center ve AccountLinkService kullanarak Hotel Center hesaplarından bağlantı davetiyelerini güncelleme desteği kaldırıldı.
  • Hotel Center hesabından bağlantı davetiyesini güncellemek için ProductLinkInvitationService kullanın.

Öğeler

• Öğeleri kullanarak resim ekleme ve kaldırma işlemlerinin desteklenmesi için ImageAdInfo.media_file, ImageAdInfo.image_asset ile değiştirildi. Bunun sonucunda, artık gerekli olmayan MediaFileService dosyasını da kaldırdık.
• Özel etiketlere ve URL alt dizelerine dayalı listeleme grubu filtresi oluşturmayı desteklemek için ListingGroupFilterDimension.webpage eklendi.
  • Ayrıca AssetGroupListingGroupFilter.vertical yerine AssetGroupListingGroupFilter.listing_source ve ListingGroupFilterListingSource
• Öğe grubu öğesinin kaynağını göstermek için asset_group_asset.source eklendi.
• Reklam grubu reklam öğesinin kaynağını göstermek için ad_group_ad_asset_view.source eklendi.

Kitleler

• Müşteri Eşleştirme için rıza alınmasını desteklemek amacıyla CustomerMatchUserListMetadata.consent eklendi. 6 Mart 2024'ten itibaren, AEA kullanıcıları için izin bilgisi eksikse rıza değeri, izin verilmedi olarak belirlenecektir. İzin vermeyen AEA kullanıcılarına ait veriler işlenmez ve Müşteri Eşleştirme ile reklam kişiselleştirme için kullanılamaz. Daha fazla bilgi için Müşteri Eşleştirme rehberimize göz atın.
• Mağaza Satışları için izin verilmesini desteklemek amacıyla UserData.consent eklendi. Daha fazla bilgi için Mağaza Satışları kılavuzumuzu inceleyin. Mağaza satışlarıyla Müşteri Eşleştirme'yi kullanıyorsanız daha fazla bilgi için SSS bölümünü inceleyin.
• Sağlanan mevcut başlangıç noktası kitleye göre oluşturulan bir kitle olan Benzer segment oluşturmayı desteklemek için UserList.lookalike_user_list eklendi. Benzer segmentler yalnızca Talep Yaratma kampanyasında kullanılabilir.

Kampanyalar

• Maksimum Performans kampanyalarında yapılan güncellemeler:

  • AssetGroupSignal artık geliştirilmiş hedefleme için bir öğe grubuna eklenebilecek iki sinyal türünü desteklemektedir:
    • AssetGroupSignal.audience
      • Kitle kullanımını belirli bir öğe grubuyla sınırlamak için Audience.scope ve Audience.asset_group eklendi. Audience.asset_group, yalnızca Audience.scope ASSET_GROUP değerine ayarlanmışsa ayarlanmalıdır.
    • AssetGroupSignal.search_theme
      • Bu yeni ölçüt türünü desteklemek için CriterionType.SEARCH_THEME eklendi. Bu yeni ölçüt türü yalnızca Maksimum Performans kampanyalarında AssetGroupSignal oluşturmak için kullanılabilir. Bunun için AssetGroupSignal.search_theme alanı bir SearchThemeInfo ölçütüyle doldurulur.
  • Öğe grubu sinyalleri eklerken muafiyet isteğinde bulunmayı desteklemek için AssetGroupSignalOperation.exempt_policy_violation_keys eklendi.
  • En iyi performans gösteren öğeleri öğe grubu düzeyinde bildirmek için yeni bir asset_group_top_combination_view eklendi.
  • asset_group, Maksimum Performans kampanyasının performansının alınmasını desteklemek için artık metrik alanlarıyla sorgulanabilir.
  • PerformanceMaxUpgradeStatus öğesindeki UPGRADE_ELIGIBLE, UPGRADE_ELIGIBLE olarak yeniden adlandırıldı.

• Talep Yaratma ve Discovery hedef EBM kampanyalarında, kampanya düzeyindeki hedef EBM teklifi simülasyonları (campaign_simulation.target_cpa_point_list.points) artık TargetCpaSimulationPoint.clicks yerine TargetCpaSimulationPoint.interactions değerini döndürüyor.

• Sağlanan marka önekine ve hariç tutulan marka listesine göre marka önerebilen BrandSuggestionService eklendi. Bu markalar bir BRAND ölçütü oluşturmak, BRANDS paylaşılan kümeye eklemek ve daha sonra brand_list paylaşılan kümeye ayarlanmış bir CampaignCriterion oluşturmak suretiyle bir kampanyaya eklemek için kullanılabilir. Kampanya ölçütleri, sırasıyla Arama Ağı kampanyalarında hedeflenebilir ve Maksimum Performans kampanyalarında hariç tutulabilir.

  • Alanlar:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Sıralamalar:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• Her öğe türünün otomasyon durumunu göstermek için Campaign.asset_automation_settings[] eklendi.

• CampaignPrimaryStatusReason sıralamasına aşağıdaki değerler eklendi:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Dönüşüm sayısı

• İzin alma sürecini desteklemek için CallConversion.consent ve ClickConversion.consent eklendi. Daha fazla bilgi için arama dönüşümleri kılavuzumuzu ve tıklama dönüşümleri kılavuzumuzu inceleyin.
• SKAdNetwork dönüşümleriyle ilgili olan ve customer veya campaign ile sorgulandığında kullanılabilen aşağıdaki alanlar eklendi:
  • Segmentler:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • Metrikler:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• metrics.sk_ad_network_conversions, metrics.sk_ad_network_installs ile değiştirildi.
• Çevrimdışı dönüşüm yüklemesini teşhis etme desteği eklendi
  • offline_conversion_upload_client_summary, customer kaynağındaki bir alandan üst düzey rapora taşındı. Dönüşüm yükleme durumuyla ilgili başarılı etkinlik sayısı, başarı oranı ve hata yüzdesi gibi faydalı ayrıntıları elde etmek için bu raporu kullanın.
    • Uyarı: Yüklenen ancak ConversionUploadError.CLICK_NOT_FOUND hatasıyla sonuçlanan bir dönüşüm başarılı olarak sayılmaya devam eder ancak OfflineConversionAlert olarak da işaretlenir.
  • Aşağıdaki istek türleri için isteğe bağlı parametre olarak job_id eklendi. Böylece, birden fazla yükleme isteğini mantıksal olarak tek bir kavramsal iş altında gruplandırabilirsiniz:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • INVALID_JOB_ID özelliği aşağıdaki hatalara eklendi:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • Aşağıdaki hatalarda INVALID_CONVERSION_ACTION, NO_CONVERSION_ACTION_FOUND ve INVALID_CONVERSION_ACTION_TYPE ile değiştirildi:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Android Özel Korumalı Alan'ın ağlar arası yönlendirmesiz ilişkilendirmesini desteklemek için üç rapor eklendi:
  • android_privacy_shared_key_google_campaign içinde shared_campaign_key ve anahtarın kodlanmasına yardımcı olan bazı alanlar bulunur.
  • android_privacy_shared_key_google_ad_group içinde shared_ad_group_key ve anahtarın kodlanmasına yardımcı olan bazı alanlar bulunur.
  • android_privacy_shared_key_google_network_type içinde shared_network_type_key ve anahtarın kodlanmasına yardımcı olan bazı alanlar bulunur.
• ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS eklendi. Desteği sonlandırılan kural tabanlı ilişkilendirme modellerinden birini kullanmaya çalışan bir ConversionActionOperation artık bu hatayla başarısız oluyor. Daha önce işlem UNKNOWN hatasıyla başarısız oluyordu.

Otel ve Seyahat

• travel_activity_group_view ve travel_activity_performance_view'te aşağıdaki alanlar için destek eklendi:
  • Segmentler:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • Metrikler:
    • metrics.search_absolute_top_impression_share
    • metrics.search_budget_lost_absolute_top_impression_share
    • metrics.search_budget_lost_impression_share
    • metrics.search_budget_lost_top_impression_share
    • metrics.search_impression_share
    • metrics.search_rank_lost_absolute_top_impression_share
    • metrics.search_rank_lost_impression_share
    • metrics.search_rank_lost_top_impression_share
    • metrics.search_top_impression_share

Yerel Hizmet Reklamları

• Yerel Hizmetler reklamvereninin ayrıntılı lisans ve sigorta durumlarını döndürmek için LocalServicesSettings ve alanları customer raporuna eklendi.
• Yerel Hizmetler için aşağıdaki yeni raporlar eklendi:
  • local_services_lead, Yerel Hizmet Reklamları hizmet talepleriyle ilgili tüm ayrıntıları (ör. lead_charged, lead_type, lead_status) içerir.
    • Sıralamalar:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation conversation_channel, call_duration_millis, call_recording_url gibi mesaj ve telefon görüşmesi ayrıntılarını içerir.
    • Telefon aramasını kaydetme URL'sinin kimliği, hedef müşteri hesabına ve yönetici hesaplarına göre doğrulanır.
  • local_services_verification_artifact; Yerel Hizmetler reklamvereninin geçmiş kontrolü, işletme lisansları ve işletme sigortası verileri gibi yapılarını döndürür. Lisans ve sigorta ile ilgili tüm belgelere URL üzerinden erişilebilir.
    • Sıralamalar:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Planlama

• Uygun ürün türleri için ReachPlanService.ListPlannableProducts için Forecast.views ve PlannedProductForecast.views iade etme desteği eklendi.
• Bir ürünün kullanılabildiği yüzeyleri açıklayan ReachPlanService.ListPlannableProducts için PlannableTargeting.surface_targeting iade desteği eklendi.
• Yeni bir ReachPlanSurface sıralaması eklendi.
• PlannedProductForecast.average_frequency döndüren AdvancedProductTargeting.target_frequency_settings ile Hedef sıklık hedefleme desteği eklendi.
• Önerilen hedeflenebilir kitleleri döndürmek için AudienceInsightsService.GenerateSuggestedTargetingInsights eklendi.
• Aşağıdaki değerler ReachPlanError öğesine eklendi:
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Öneriler

• Öneri aboneliklerini yöneten RecommendationSubscriptionService eklendi:
  • Kaynak: RecommendationSubscription
  • Alan: MutateOperation.recommendation_subscription_operation
  • Sıralama: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Hatalar:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• Aşağıdaki öneri türleri eklendi:
  • FORECASTING_SET_TARGET_CPA, trafiği artıracağı tahmin edilen sezonluk bir etkinlikten önce, belirtilmemiş kampanyalar için bir hedef EBM ayarlanmasını önerir.
  • SET_TARGET_CPA, belirtilmemiş kampanyalar için bir hedef EBM ayarlamanızı önerir.
  • SET_TARGET_ROAS, belirtilmemiş kampanyalar için bir hedef ROAS belirlemenizi önerir.

Raporlama

• campaign (Görüntülü Reklam Ağı, Video, Discovery ve uygulama kampanyalarında kullanılabilir) ve segments.device ile sorgulanabilecek aşağıdaki yeni metrikler eklendi:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Alışveriş

• Değerleri artık ShoppingSetting.feed_label olarak döndürülen ShoppingSetting.sales_country kaldırıldı.
  • ShoppingSetting.feed_label alanını kullanarak, bir kampanya için belirli bir Merchant Center feed'ini kullanmaya devam edebilirsiniz. Bu değer, feed etiketi değerine veya daha önce ShoppingSetting.sales_country için kullanılan iki harfli ülke koduna ayarlanmalıdır. Daha fazla bilgi için feed etiketleri ile ilgili destek makalesine bakın.
• Raporlamada ürün kategorilerinin ülke koduna bağımlılığı kaldırıldı. Desteklenen kategori kimlikleri grubu değişmedi.
  • shopping_performance_view ürününde kullanılan aşağıdaki alanlar değiştirildi:
    • segments.product_category_level1 ile segments.product_bidding_category_level1
    • segments.product_category_level2 ile segments.product_bidding_category_level2
    • segments.product_category_level3 ile segments.product_bidding_category_level3
    • segments.product_category_level4 ile segments.product_bidding_category_level4
    • segments.product_category_level5 ile segments.product_bidding_category_level5
  • product_bidding_category_constant, bir kategorinin mevcut tüm yerelleştirmelerini yinelenen bir alanda döndüren product_category_constant ile değiştirildi.
  • ListingDimensionInfo.product_bidding_category, ListingDimensionInfo.product_category ile değiştirildi.
  • ListingGroupFilterDimension.product_bidding_category, ListingGroupFilterDimension.product_category ile değiştirildi.
• Arama Ağı kampanyalarına Campaign.shopping_setting ekleme desteği kaldırıldı. Campaign.shopping_setting ile bir Arama Ağı kampanyası oluşturmaya veya mevcut bir Arama Ağı kampanyasına Campaign.shopping_setting eklemeye çalıştığınızda sonuç OPERATION_NOT_PERMITTED_FOR_CONTEXT elde ediliyor.
• Arama Ağı kampanyalarına CampaignCriterion.listing_scope ekleme desteği kaldırıldı. Mevcut bir Arama Ağı kampanyasına CampaignCriterion.listing_scope eklenmeye çalışıldığında OPERATION_NOT_PERMITTED_FOR_CONTEXT ile sonuçlanıyor.
• Aşağıdaki alışveriş sepeti verileriyle dönüşüm dönüşümleri metrikleri eklendi:
  • metrics.orders
  • metrics.average_order_value_micros
  • metrics.average_cart_size
  • metrics.cost_of_goods_sold_micros
  • metrics.gross_profit_micros
  • metrics.gross_profit_margin
  • metrics.revenue_micros
  • metrics.units_sold
  • metrics.cross_sell_cost_of_goods_sold_micros
  • metrics.cross_sell_gross_profit_micros
  • metrics.cross_sell_revenue_micros
  • metrics.cross_sell_units_sold
  • metrics.lead_cost_of_goods_sold_micros
  • metrics.lead_gross_profit_micros
  • metrics.lead_revenue_micros
  • metrics.lead_units_sold
  • Bu metriklerin tümü aşağıdaki raporlarda seçilebilir:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Birleştirilmiş Hedefler

• Müşteri edinme hedeflerini müşteri düzeyinde yapılandırmak için CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals eklendi.
  • Bildirin: customer_lifecycle_goal
• Kampanya düzeyinde müşteri edinme hedeflerini yapılandırmak için CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals eklendi.
  • Bildirin: campaign_lifecycle_goal
• CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN eklendi.
• Aşağıdaki değerler ConversionGoalCampaignConfigError öğesine eklendi:
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

Videolar

• Google TV'yi kampanya düzeyinde hedefleme desteği eklendi:
  • NetworkSettings.target_google_tv_network eklendi
  • AdNetworkType.GOOGLE_TV eklendi.
• YouTube'u kampanya düzeyinde hedefleme desteği eklendi:
  • NetworkSettings.target_youtube eklendi
  • AdNetworkType alanında YOUTUBE_WATCH ve YOUTUBE_SEARCH, YOUTUBE olarak birleştirildi.
  • CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE eklendi.

Arşivlenmiş sürüm notları

Arşivlenmiş sürüm notları için Kullanımdan kaldırılan sürümler başlıklı makaleye göz atın.