Reklam Uzantısı Komut Dosyalarını Taşıma

Bu belgede, reklam uzantılarına erişen veya bunları yöneten komut dosyaları için taşıma süreci açıklanmaktadır. 28 Mart 2022'den itibaren, reklam uzantılarını güncelleyen komut dosyaları olan müşterilerin feed tabanlı uzantıları yeni öğe tabanlı uzantılara taşınacak. 13 Mayıs 2022'den itibaren, reklam uzantılarını getirirken komut dosyası kullanan (ve reklam uzantılarını güncelleyen komut dosyası olmayan) müşterilerin feed tabanlı uzantıları, öğe tabanlı yeni uzantılara taşınacak.

Genel Bakış

Mevcut feed tabanlı uzantı paradigması, öğe tabanlı uzantılar lehine kullanımdan kaldırıldı. Feed tabanlı uzantılar Google Ads kullanıcı arayüzünde "eski" uzantılar olarak adlandırılırken öğe tabanlı uzantılar Google Ads kullanıcı arayüzünde "yeni sürüme geçirilmiş" uzantılar olarak adlandırılır.

Feed tabanlı uzantılar, 28 Mart 2022'den itibaren yeni öğe tabanlı uzantılara taşınacak. Taşıma işlemi tamamlandıktan sonra feed tabanlı uzantılar yayınlanmayacaktır. Bu kılavuzda, Google Ads hesabınızda hem feed tabanlı hem de öğe tabanlı reklam uzantılarının mı, yoksa yalnızca feed tabanlı reklam uzantılarının mı bulunduğu, taşıma süreci açıklanmaktadır.

Taşıma ayrıntıları

Öğe tabanlı reklam uzantılarına erişmeye veya bunları güncellemeye başlamak için yeni Google Ads Komut Dosyaları deneyimini kullanmanız gerekir. Yeni Google Ads Komut Dosyaları deneyimi hakkında bilgi edinmek için Başlangıç kılavuzuna bakın.

Reklam uzantıları getiriliyor

Mevcut Reklam Uzantısı seçici grubu (örneğin, SitelinkSelector) feed tabanlı reklam uzantılarını veya öğe tabanlı reklam uzantılarını getirebilir. Bu seçiciler varsayılan olarak, şu anda yayınlanan reklam uzantısı türünü döndürür. Aşağıdaki tabloda, şu anda yayınlanan (ve dolayısıyla varsayılan olarak döndürülen) reklam uzantısı türü özetlenmiştir:

Hesaptaki reklam uzantılarının türü
Yalnızca feed tabanlı reklam uzantıları Feed tabanlı reklam uzantıları varsayılan olarak döndürülür
Yalnızca öğe tabanlı reklam uzantıları Öğe tabanlı reklam uzantıları varsayılan olarak döndürülür
Hem feed tabanlı hem de öğe tabanlı reklam uzantıları Öğe tabanlı reklam uzantıları varsayılan olarak döndürülür

Feed tabanlı tüm reklam uzantıları taşındıktan sonra, tüm reklam uzantısı seçiciler varsayılan olarak öğe tabanlı reklam uzantıları döndürür. Feed tabanlı reklam uzantılarını withOnlyLegacy yöntemiyle getirmeye devam edebilirsiniz. Bu, geçmiş metrikleri toplamak için kullanışlıdır.

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

Çoğu durumda, feed tabanlı reklam uzantılarının taşınmasından önce veya sonra kod değişikliği gerekmez. Bununla birlikte, kod değişikliklerinin gerekli olabileceği birkaç senaryo vardır.

Reklam uzantılarını kimliğe göre filtreleme

Feed tabanlı bir reklam uzantısı taşındığında, ilgili öğe tabanlı reklam uzantısının kimliği farklı olur. Bu, komut dosyanız şu anda reklam uzantılarını kimliğe göre filtreliyorsa öğeye dayalı reklam uzantılarını getiremez.

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

Bu sorunu gidermek için farklı bir özelliğe göre filtreleme yapmalı veya kodunuzu öğeye dayalı reklam uzantılarının kimliklerini kullanacak şekilde güncellemelisiniz.

Reklam uzantılarını istatistiklere göre filtreleme

Feed tabanlı bir reklam uzantısı taşındığında, ilgili öğe tabanlı reklam uzantısının istatistikleri sıfırlanır. Reklam uzantılarını istatistiklere göre filtrelerken bunu göz önünde bulundurmanız gerekir. Örneğin, LAST_MONTH içinde Clicks > 100 içeren site bağlantısı uzantıları isterseniz feed tabanlı reklam uzantılarınız kısa süre önce taşındıysa normalden daha az reklam uzantısı görebilirsiniz.

Reklam uzantılarınız için performans raporları oluştururken de bunu göz önünde bulundurmanız gerekir. Feed tabanlı reklam uzantılarınız taşındığında raporlarınızda önemli değişiklikler veya düşüşler görebilirsiniz.

Kullanımdan kaldırılan yöntemler

Taşıma işleminin bir parçası olarak, bazı alanlar artık desteklenmiyor. Örneğin, başlangıç tarihi ve bitiş tarihi snippet uzantılarında kullanımdan kaldırılmıştır. getStartDate() numaralı telefona yapılan aramalar null numaralı telefona yönlendirilir. Ayrıca bir uyarı mesajı günlüğe kaydedilir. Hangi yöntemlerin desteğinin sonlandırıldığını anlamak için aşağıdaki tabloya bakın:

Sınıf Desteği sonlandırılan yöntemler
Açıklama metni Desteği sonlandırılan yöntem yok
MobilUygulama getSchedules
Telefon Numarası getEndDate
getStartDate
Fiyat getEndDate
getSchedules
getStartDate
Site bağlantısı Kullanımdan kaldırılan yöntem yok
Snippet getEndDate
getSchedules
getStartDate

Reklam uzantıları güncelleniyor

Taşıma işleminin bir parçası olarak, bazı alanlar artık desteklenmiyor. Örneğin, başlangıç tarihi ve bitiş tarihi snippet uzantılarında kullanımdan kaldırılmıştır. setStartDate çağrılarının reklam uzantısını etkilemesi beklenmez. Ayrıca bir uyarı mesajı günlüğe kaydedilir. Hangi yöntemlerin desteğinin sonlandırıldığını anlamak için aşağıdaki tabloya bakın:

Sınıf Desteği sonlandırılan yöntemler
Açıklama metni Desteği sonlandırılan yöntem yok
MobilUygulama setSchedules
Telefon Numarası clearEndDate
clearStartDatesetEndDate
setStartDate
Fiyat clearEndDate
clearStartDatesetEndDate
setSchedules
setStartDate
Site bağlantısı Kullanımdan kaldırılan yöntem yok
Snippet clearEndDate
clearStartDatesetEndDate
setSchedules
setStartDate

Reklam uzantıları oluşturma

Mevcut Reklam Uzantısı oluşturucu grubu (örneğin, SitelinkBuilder, feed tabanlı reklam uzantıları veya öğe tabanlı reklam uzantıları oluşturabilir. Bu oluşturucular varsayılan olarak, şu anda yayınlanan reklam uzantısı türünü oluşturur. Aşağıdaki tabloda, şu anda yayınlanan (ve dolayısıyla varsayılan olarak oluşturulacak) reklam uzantısı türü özetlenmiştir:

Hesaptaki reklam uzantılarının türü
Yalnızca feed tabanlı reklam uzantıları Feed tabanlı reklam uzantıları varsayılan olarak oluşturulur
Yalnızca öğe tabanlı reklam uzantıları Öğe tabanlı reklam uzantıları varsayılan olarak oluşturulur
Hem feed tabanlı hem de öğe tabanlı reklam uzantıları Öğe tabanlı reklam uzantıları varsayılan olarak oluşturulur

Bir müşterinin uzantıları taşındıktan sonra tüm reklam uzantısı oluşturucular varsayılan olarak öğeye dayalı reklam uzantıları oluşturur. Feed tabanlı reklam uzantıları artık yayınlanmayacağından feed tabanlı reklam uzantılarının oluşturulması artık desteklenmeyecek.

Varsayılan davranışa güvenmek yerine feed tabanlı bir uzantı oluşturmak isterseniz build() yerine build(true) öğesini çağırarak bunu yapabilirsiniz. Örneğin:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

Öğe tabanlı bir uzantı oluşturmak istiyorsanız ve hesabınızda şu anda yalnızca feed tabanlı uzantılar varsa 28 Mart'a kadar bekleyebilir veya build(false) numaralı telefonu arayabilirsiniz.

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

Desteklenmeyen alanlar

Reklam uzantılarının taşınması kapsamında belirli alanlar kullanımdan kaldırılmıştır. Örneğin, snippet uzantılarında başlangıç tarihi ve bitiş tarihi desteği sonlandırıldı. withEndDate veya withStartDate adresine yapılan aramalar uzantıyı etkilemez. Bunun yerine bir uyarı mesajı kaydedilir. Her sınıf için hangi yöntemlerin desteğinin sonlandırıldığını anlamak üzere aşağıdaki tabloya bakın:

Sınıf Kullanımdan kaldırılan yöntemler
CalloutBuilder withMobilePreferred
MobileAppBuilder withMobilePreferred
withSchedules
PhoneNumberBuilder withEndDate
withMobilePreferred
withStartDate
PriceBuilder withEndDate
withMobilePreferred
withSchedules
withStartDate
SitelinkBuilder withMobilePreferred
SnippetBuilder withEndDate
withMobilePreferred
withSchedules
withStartDate