Reklam Uzantıları

Google Ads komut dosyaları aşağıdaki reklam uzantılarını destekler:

• Mobil uygulamalar
• Telefon numaraları
• Açıklama metinleri
• Fiyatlar
• Snippet'ler
• Site Bağlantıları

Reklam uzantıları hakkında daha fazla bilgi edinmek için Yardım Merkezi'ni ziyaret edin.

Google Ads komut dosyaları, hesabınızdaki desteklenen reklam uzantılarına erişmenizi sağlar. Örneğin, aşağıdaki kod snippet'i site bağlantılarına erişir:

const sitelinkIterator = AdsApp.extensions().sitelinks().get();
for (const sitelink of sitelinkIterator) {
  // Do something with each sitelink
}

Diğer desteklenen reklam uzantılarını da benzer şekilde ilgili yineleyicilerini kullanarak alabilirsiniz.

içerik üretimi

Google Ads komut dosyaları, desteklenen reklam uzantılarını oluşturmanıza olanak tanır. Örneğin, aşağıdaki kod snippet'inde hesabınızda telefon numarası oluşturmak için telefon numarası oluşturucu kullanılmaktadır:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("6502530000")
  .withCallOnly(false)
  .build()
  .getResult();

build() arandığında hesapta telefon numarası oluşturulur ancak bu numara henüz hiçbir reklamla birlikte gösterilmez. Öncelikle kampanyaya veya reklam grubuna eklemeniz gerekir:

// Add a phone number to a campaign.
campaign.addPhoneNumber(newPhoneNumber);

// Add a phone number to an ad group.
adGroup.addPhoneNumber(newPhoneNumber);

Desteklenen diğer reklam uzantıları, ilgili oluşturucularıyla aynı şekilde oluşturulup kampanyalarla veya reklam gruplarıyla ilişkilendirilebilir.

İstatistikleri alma

Google Ads komut dosyaları, desteklenen reklam uzantılarının istatistiklerine hesap, kampanya veya reklam grubu düzeyinde erişmenize olanak tanır.

Örneğin, site bağlantısı istatistiklerini almak için:

// Account-level stats
// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
const sitelinkStats = sitelink.getStatsFor("LAST_30_DAYS");
console.log(sitelinkStats.getClicks());

// Campaign-level stats.
// Get a sitelink in a campaign.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
const campaignSitelinkStats = campaignSitelink.getStatsFor("LAST_30_DAYS");
console.log(campaignSitelinkStats.getClicks());

// Ad-group-level stats.
// Get a sitelink in an ad group.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
const adGroupSitelinkStats = adGroupSitelink.getStatsFor("LAST_30_DAYS");
console.log(adGroupSitelinkStats.getClicks());

Desteklenen diğer reklam uzantılarının istatistiklerine de benzer şekilde erişilebilir.

Reklam uzantılarını değiştirme

Mevcut desteklenen reklam uzantıları, Google Ads komut dosyalarıyla değiştirilebilir. Örneğin, aşağıdaki kod snippet'i mevcut bir site bağlantısını değiştirir:

// Get a sitelink in the account.
const sitelinkIterator = AdsApp.extensions().sitelinks().get();
const sitelink = sitelinkIterator.next();
console.log(sitelink.getLinkText()); // "original text"

// Get a sitelink from a campaign. Assume it's the same one as above.
const campaignSitelinkIterator = campaign.extensions().sitelinks().get();
const campaignSitelink = campaignSitelinkIterator.next();
console.log(campaignSitelink.getLinkText()); // "original text"

// Get a sitelink from an ad group. Assume it's the same one as above.
const adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
const adGroupSitelink = adGroupSitelinkIterator.next();
console.log(adGroupSitelink.getLinkText()); // "original text"

// Change the sitelink's link text. This change will affect all the campaigns
// and ad groups to which the sitelink belongs.
campaignSitelink.setLinkText("new link text");

// Same text!
console.log(campaignSitelink.getLinkText()); // "new link text"
console.log(adGroupSitelink.getLinkText()); // "new link text"
console.log(sitelink.getLinkText()); // "new link text"

Not: Bir Sitelink öğesini değiştirirseniz bu değişiklik, site bağlantısının ilişkilendirildiği tüm kampanyalarda ve reklam gruplarında yayınlanan reklamları etkiler. Bu kural, site bağlantısını doğrudan hesaptan, ilişkili bir kampanyanın CampaignSitelink'sından veya ilişkili bir reklam grubunun AdGroupSitelink'sından alıp almamanızdan bağımsız olarak geçerlidir. Yukarıdaki kod örneğinde bu davranış gösterilmektedir.

Aynı kavramlar, desteklenen diğer reklam uzantıları için de geçerlidir.

Reklam grubu düzeyindeki reklam uzantılarına erişme

Google Ads komut dosyaları, reklam grubu düzeyindeki reklam uzantılarına erişmenize olanak tanır. Aşağıdaki yöntem çağrısı, bir reklam grubuna açıkça eklenmiş telefon numaralarını döndürür. Reklam grubunun ait olduğu kampanyaya telefon numaraları eklenmişse aşağıdaki yöntem çağrısının, telefon numaraları söz konusu reklam grubundan yayınlanan reklamlarda görünmeye uygun olsa bile bu numaraları döndürmeyeceğini unutmayın.

// This will return phone numbers that have been explicitly added to this
// ad group.
const adGroupPhoneNumberIterator = adGroup.extensions().phoneNumbers().get();

Desteklenen diğer reklam uzantılarına da benzer şekilde reklam grubu düzeyinde erişilebilir.

Hesap düzeyinde reklam uzantılarına erişme

Google Ads komut dosyaları, hesap düzeyindeki reklam uzantılarına erişmenizi sağlar. Açıklama metinleri, mobil uygulamalar ve yorumlar hesap düzeyinde reklam uzantıları olarak eklenebilir ancak hesap düzeyinde site bağlantıları ve telefon numaraları kullanılamaz. Aşağıdaki yöntem çağrısı, hesabınıza açıkça eklenmiş açıklama metinlerini döndürür.

// This will return callouts that have been explicitly added to your account.
const accountCalloutIterator =
    AdsApp.currentAccount().extensions().callouts().get();

Hesap düzeyindeki mobil uygulamalara ve yorumlara da benzer şekilde erişilebilir.

Hesap düzeyinde reklam uzantıları eklemek, kampanya düzeyinde veya reklam grubu düzeyinde reklam uzantıları eklemeye benzer. Aşağıdaki örnekte, hesap düzeyinde bir açıklama metni uzantısının nasıl ekleneceği gösterilmektedir:

// Create a new callout in the account. Without adding the new callout as an ad
// group, campaign or account extension, it won't actually serve.
const calloutBuilder = AdsApp.extensions().newCalloutBuilder();
const newCallout = calloutBuilder.withText("Sample Text").build().getResult();

// Add the new callout as an account-level extension. This enables it to serve
// for all campaigns in the account.
AdsApp.currentAccount().addCallout(newCallout);

Hesap düzeyinde mobil uygulamalar ve yorumlar da benzer şekilde eklenebilir.

Kampanya, reklam grubu ve hesap reklamı uzantılarını kaldırma

Desteklenen reklam uzantıları, hesap düzeyinde kampanyalardan ve reklam gruplarından kaldırılabilir. Google Ads komut dosyaları, reklam uzantılarının bir hesaptan aynı anda kaldırılmasını desteklemez.

// Get a mobile app from a campaign.
const campaignMobileAppIterator = campaign.extensions().mobileApps().get();
const campaignMobileApp = campaignMobileAppIterator.next();

// Remove the mobile app.
campaign.removeMobileApp(campaignMobileApp);

// The mobile app still exists in the account and will be returned in the
// following iterator.
const mobileAppIterator = AdsApp.extensions().mobileApps().get();

Benzer şekilde, reklam grubu veya hesap düzeyindeki bir mobil uygulamayı kaldırmak için:

// Get a mobile app from an ad group.
const adGroupMobileAppIterator = adGroup.extensions().mobileApps().get();
const adGroupMobileApp = adGroupMobileAppIterator.next();

// Remove the mobile app.
adGroup.removeMobileApp(adGroupMobileApp);

// Get an account-level mobile app.
const accountMobileAppIterator =
    AdsApp.currentAccount().extensions().mobileApps().get();
const accountMobileApp = accountMobileAppIterator.next();

// Remove the mobile app.
// Note that this removes the mobile app from the account level, so it won't
// serve as an account-level extension, but it will still exist in the
// account. It can still be added to an AdGroup or Campaign, or again as an
// account-level extension in the future.
AdsApp.currentAccount().removeMobileApp(accountMobileApp);

Bir kampanyadan tüm mobil uygulamalar kaldırılırsa kampanyada artık mobil uygulama uzantısı olmaz. Tüm mobil uygulamaları kampanyanızdan kaldırmak için söz konusu kampanyanın mobil uygulamalar listesini almanız ve bunları tek tek kaldırmanız gerekir. Diğer desteklenen reklam uzantıları için de aynı prosedür geçerlidir.