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 clearStartDate setEndDate setStartDate |
Fiyat | clearEndDate clearStartDate setEndDate setSchedules setStartDate |
Site bağlantısı | Kullanımdan kaldırılmış yöntem yok |
Snippet | clearEndDate clearStartDate setEndDate 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 |