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 sayedeAdService
, 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:
Öğ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:
Kitleler
Toplu İşler
- Gönderilen
AddBatchJobOperationsRequest
10484504 bayttan büyük olduğunda atananBatchJobError.REQUEST_TOO_LARGE
eklendi. BatchJobService
kullanılırkenMutateOperation.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ıkAdvertisingChannelType.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ı dosyasegments.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.
Ö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çinmetrics.search_impression_share
desteği eklendikeyword_view
içinmetrics.phone_calls
desteği eklendi
Yerel Hizmetler
LocalServicesLead
öğesine yeni birLocalServicesLeadConversation
eklemek için kullanılanLocalServicesLeadService.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ızcalead_type
öğesininLeadType.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
, yeniLocalServicesLeadService.AppendLeadConversation()
yöntemi kullanılarak başlatılan bir görüşmeyi temsil eder.
- WhatsApp üzerinden başlatılan bir görüşmeyi temsil eden
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ğindeQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
hatası verilir. Örneğin,product_link.advertising_partner.customer
veproduct_link.data_partner.data_partner_id
aynı sorguda seçilemez. GoogleAdsService.Search
öğesinepage_size
iletmekRequestError.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
veyaGoogleAdsService.SearchStream
kullanırkensegments.date
kullanarakshopping_product
raporundaki metrikleri filtreleyebilirsiniz. Tarihe göre segmentlere ayırmaya izin verilmez ve bu tür segmentlerShoppingProductError.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çinUserListCustomerTypeService.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
öğesiniUserListCustomerTypeCategory.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.
- 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
Videolar
- Aşağıdaki değerler
ContentLabelType
etiketine eklendi. BuContentLabelTypes
öğ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çinAdVideoAsset.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
veasset_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
olarakCustomerSkAdNetworkConversionValueSchemaService
için uyarılar için destek eklendi.true
olarak ayarlandığında, işlem hatalarıyla ilgili engellemeyen tüm hatalarMutateCustomerSkAdNetworkConversionValueSchemaResponse.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
velocal_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
veBrandSafetySuitability
. - 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ğındanProductLink
veProductLinkInvitation
sürümlerine taşındı.data_partner
vegoogle_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çinStartIdentityVerification()
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. GetIdentityVerification()
,IdentityVerification
öğesinin birkaç nesnesini döndüren doğrulama bilgilerini almak için kullanılabilir. HerIdentityVerification
ş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:
- Hatalar:
- Sağlanan
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
eklendi.
Öğeler
asset_group
'te yapılan değişiklikler:segments.year
vesegments.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 gelenDemandGenProductAdInfo
eklendi. Bunlar, boş olmayan birCampaign.shopping_setting
değeriyle Talep Yaratma kampanyalarında kullanılabilir.
- Mevcut Talep Yaratma kampanyasına
- 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: travel_activity_performance_view
'e aşağıdaki segmentler için destek eklendi:
Yerel Hizmetler
- Reklamverenlerin işletme kaydı doğrulama işleminin ilerlemesini izlemesine olanak tanımak için
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
veBusinessRegistrationCheckArtifact
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
yerinerecommended_match_type
değeriUNSPECIFIED
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ı önerirLEAD_FORM_ASSET
, potansiyel müşteri formu öğelerini kampanya veya müşteri düzeyinde eklemenizi önerirIMPROVE_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
veCampaignError.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
veCampaignLifecycleGoalOperation
bölümlerineupdate
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
vecustomer_client.status
SUSPENDED
olarak döndürülür. Daha önceENABLED
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
veMerchantCenterIdentifier
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
veProductLinkInvitation
eklendi. MerchantCenterLinkService
kaldırıldı.- Google Ads hesaplarını Merchant Center hesaplarına bağlamak için
ProductLinkInvitationService
veProductLinkService
tuşlarını kullanın.
- Google Ads hesaplarını Merchant Center hesaplarına bağlamak için
AccountLink.hotel_center
veAccountLinkService
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.
- Hotel Center hesabından bağlantı davetiyesini güncellemek için
Öğ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 olmayanMediaFileService
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
yerineAssetGroupListingGroupFilter.listing_source
veListingGroupFilterListingSource
- Ayrıca
- Öğ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
veAudience.asset_group
eklendi.Audience.asset_group
, yalnızcaAudience.scope
ASSET_GROUP
değerine ayarlanmışsa ayarlanmalıdır.
- Kitle kullanımını belirli bir öğe grubuyla sınırlamak için
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ındaAssetGroupSignal
oluşturmak için kullanılabilir. Bunun içinAssetGroupSignal.search_theme
alanı birSearchThemeInfo
ölçütüyle doldurulur.
- Bu yeni ölçüt türünü desteklemek için
- Öğ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
öğesindekiUPGRADE_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ıkTargetCpaSimulationPoint.clicks
yerineTargetCpaSimulationPoint.interactions
değerini döndürüyor.Sağlanan marka önekine ve hariç tutulan marka listesine göre marka önerebilen
BrandSuggestionService
eklendi. Bu markalar birBRAND
ölçütü oluşturmak,BRANDS
paylaşılan kümeye eklemek ve daha sonrabrand_list
paylaşılan kümeye ayarlanmış birCampaignCriterion
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:
- Sıralamalar:
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
veClickConversion.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
veyacampaign
ile sorgulandığında kullanılabilen aşağıdaki alanlar eklendi: 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 ancakOfflineConversionAlert
olarak da işaretlenir.
- Uyarı: Yüklenen ancak
- 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: INVALID_JOB_ID
özelliği aşağıdaki hatalara eklendi:- Aşağıdaki hatalarda
INVALID_CONVERSION_ACTION
,NO_CONVERSION_ACTION_FOUND
veINVALID_CONVERSION_ACTION_TYPE
ile değiştirildi:
- Android Özel Korumalı Alan'ın ağlar arası yönlendirmesiz ilişkilendirmesini desteklemek için üç rapor eklendi:
android_privacy_shared_key_google_campaign
içindeshared_campaign_key
ve anahtarın kodlanmasına yardımcı olan bazı alanlar bulunur.android_privacy_shared_key_google_ad_group
içindeshared_ad_group_key
ve anahtarın kodlanmasına yardımcı olan bazı alanlar bulunur.android_privacy_shared_key_google_network_type
içindeshared_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 birConversionActionOperation
artık bu hatayla başarısız oluyor. Daha önce işlemUNKNOWN
hatasıyla başarısız oluyordu.
Otel ve Seyahat
travel_activity_group_view
vetravel_activity_performance_view
'te aşağıdaki alanlar için destek eklendi:- Segmentler:
- 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:
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.
Planlama
- Uygun ürün türleri için
ReachPlanService.ListPlannableProducts
içinForecast.views
vePlannedProductForecast.views
iade etme desteği eklendi. - Bir ürünün kullanılabildiği yüzeyleri açıklayan
ReachPlanService.ListPlannableProducts
içinPlannableTargeting.surface_targeting
iade desteği eklendi. - Yeni bir
ReachPlanSurface
sıralaması eklendi. PlannedProductForecast.average_frequency
döndürenAdvancedProductTargeting.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: - 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) vesegments.device
ile sorgulanabilecek aşağıdaki yeni metrikler eklendi:
Alışveriş
- Değerleri artık
ShoppingSetting.feed_label
olarak döndürülenShoppingSetting.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 önceShoppingSetting.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
ilesegments.product_bidding_category_level1
segments.product_category_level2
ilesegments.product_bidding_category_level2
segments.product_category_level3
ilesegments.product_bidding_category_level3
segments.product_category_level4
ilesegments.product_bidding_category_level4
segments.product_category_level5
ilesegments.product_bidding_category_level5
product_bidding_category_constant
, bir kategorinin mevcut tüm yerelleştirmelerini yinelenen bir alanda döndürenproduct_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ınaCampaign.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ınaCampaignCriterion.listing_scope
eklenmeye çalışıldığındaOPERATION_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:
Birleştirilmiş Hedefler
- Müşteri edinme hedeflerini müşteri düzeyinde yapılandırmak için
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
eklendi.- Bildirin:
customer_lifecycle_goal
- Bildirin:
- Kampanya düzeyinde müşteri edinme hedeflerini yapılandırmak için
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
eklendi.- Bildirin:
campaign_lifecycle_goal
- Bildirin:
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
eklendiAdNetworkType.GOOGLE_TV
eklendi.
- YouTube'u kampanya düzeyinde hedefleme desteği eklendi:
NetworkSettings.target_youtube
eklendiAdNetworkType
alanındaYOUTUBE_WATCH
veYOUTUBE_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.