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

Bu dokümanda, reklam uzantılarına erişen veya bunları yöneten komut dosyalarının taşıma süreci açıklanmaktadır. Komut dosyası güncelleyen ve reklam uzantılarını güncelleyen müşterilerin feed tabanlı uzantıları, 28 Mart 2022'den itibaren yeni öğe tabanlı uzantılara taşınacak. 13 Mayıs 2022'den itibaren, komut dosyası aracılığıyla reklam uzantılarını getiren (ve reklam uzantılarını güncelleyen komut dosyası bulunmayan) müşterilerin feed tabanlı uzantıları, yeni öğe tabanlı uzantılara taşınacaktır.

Genel bakış

Mevcut feed tabanlı uzantılar paradigması kullanımdan kaldırılarak yerine öğe tabanlı uzantılar kullanıma sunulmuştur. Feed tabanlı uzantılar Google Ads kullanıcı arayüzünde "Eski" uzantı olarak adlandırılırken öğe tabanlı uzantılar Google Ads kullanıcı arayüzünde "Yeni sürüme geçirilmiş" olarak adlandırılır.

28 Mart 2022'den itibaren feed tabanlı uzantılar, yeni öğe tabanlı uzantılara taşınacak. Bu uzantılar taşındıktan sonra feed tabanlı uzantılar yayından kaldırılacak. Bu kılavuzda, Google Ads hesabınızda hem feed tabanlı hem de öğe tabanlı reklam uzantıları veya hesabınızda yalnızca feed tabanlı reklam uzantıları olup olmadığına bakılmaksızın geçiş süreci açıklanmaktadır.

Taşıma ayrıntıları

Öğe tabanlı reklam uzantılarına erişmeye veya bu uzantıları 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. Varsayılan olarak bu seçiciler, o anda yayınlanan reklam uzantısı türünü döndürür. Aşağıdaki tabloda, şu anda sunulmakta olan (ve dolayısıyla varsayılan olarak döndürülecek) reklam uzantısının 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

Tüm feed tabanlı 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. Yine de withOnlyLegacy yöntemiyle feed tabanlı reklam uzantıları getirilebilir. Bu, geçmiş metrikleri toplamak için yararlı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ı taşınmadan önce veya taşındıktan sonra kod değişikliği yapılması gerekmez. Bununla birlikte, kod değişikliklerinin gerekli olabileceği birkaç senaryo da 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ı farklı bir kimliğe sahip olur. Bu, komut dosyanızın şu anda reklam uzantılarını kimliğe göre filtrelediği durumlarda öğe tabanlı reklam uzantılarını getiremeyeceği anlamına gelir.

// 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 yapmanız veya kodunuzu, bunun yerine öğe tabanlı reklam uzantılarının kimliklerini kullanacak şekilde güncellemeniz gerekir.

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 dikkate almalısınız. Örneğin, LAST_MONTH içinde Clicks > 100 ile site bağlantısı uzantıları isteğinde bulunursanız feed tabanlı reklam uzantılarınız yakın zamanda taşınmışsa normalden daha az reklam uzantısı görebilirsiniz.

Reklam uzantılarınız için performans raporları oluştururken de bunu aklınızda 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şlemi kapsamında, bazı alanlar artık desteklenmiyor. Örneğin, başlangıç tarihi ve bitiş tarihi Snippet uzantılarından kullanımdan kaldırılmıştır. getStartDate() numarasına yapılan aramalar null sonucunu döndürür. Ayrıca, bir uyarı mesajı kaydedilir. Hangi yöntemlerin kullanımdan kaldırıldığını anlamak için aşağıdaki tabloya bakın:

Sınıf Kullanımdan kaldırılan yöntemler
Açıklama metni Kullanımdan kaldırılmış yöntem yok
MobileApp getSchedules
PhoneNumber getEndDate
getStartDate
Fiyat getEndDate
getSchedules
getStartDate
Site bağlantısı Kullanımdan kaldırılmış yöntem yok
Snippet getEndDate
getSchedules
getStartDate

Reklam uzantıları güncelleniyor

Taşıma işlemi kapsamında, bazı alanlar artık desteklenmiyor. Örneğin, başlangıç tarihi ve bitiş tarihi Snippet uzantılarından kullanımdan kaldırılmıştır. setStartDate numaralı çağrıların reklam uzantısı üzerinde hiçbir etkisi olmayacaktır. Ayrıca, bir uyarı mesajı kaydedilir. Hangi yöntemlerin kullanımdan kaldırıldığını anlamak için aşağıdaki tabloya bakın:

Sınıf Kullanımdan kaldırılan yöntemler
Açıklama metni Kullanımdan kaldırılmış yöntem yok
MobileApp setSchedules
PhoneNumber clearEndDate
clearStartDatesetEndDate
setStartDate
Fiyat clearEndDate
clearStartDatesetEndDate
setSchedules
setStartDate
Site bağlantısı Kullanımdan kaldırılmış yöntem yok
Snippet clearEndDate
clearStartDatesetEndDate
setSchedules
setStartDate

Reklam uzantıları oluşturma

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

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

Müşterinin uzantıları taşındıktan sonra tüm reklam uzantısı oluşturucular varsayılan olarak öğe tabanlı reklam uzantıları oluşturur. Feed tabanlı reklam uzantıları artık yayınlanmayacağından feed tabanlı reklam uzantısı oluşturma işlemi artık desteklenmeyecek.

Varsayılan davranışa bağlı kalmak yerine feed tabanlı bir uzantı oluşturmak isterseniz bunu build() yerine build(true) yöntemini çağırarak 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 bazı alanlar kullanımdan kaldırılmıştır. Örneğin, başlangıç tarihi ve bitiş tarihi Snippet uzantılarından kullanımdan kaldırılmıştır. withEndDate veya withStartDate için yapılan çağrıların uzantı üzerinde herhangi bir etkisi olmaz. Bunun yerine bir uyarı mesajı kaydedilir. Her bir sınıfta hangi yöntemlerin kullanımdan kaldırıldığını anlamak için 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