Ekstensi Iklan

Skrip Google Ads mendukung ekstensi iklan berikut:

• Aplikasi seluler
• Nomor telepon
• Info
• Harga
• Cuplikan
• Sitelink

Untuk mempelajari ekstensi iklan lebih lanjut, buka pusat bantuan.

Perhatian: Ekstensi berbasis aset akan segera menggantikan ekstensi berbasis feed. Lihat panduan migrasi untuk mengetahui informasi selengkapnya.

Skrip Google Ads memungkinkan Anda mengakses ekstensi iklan yang didukung di akun Anda. Misalnya, cuplikan kode berikut mengakses sitelink:

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

Anda dapat mengambil ekstensi iklan lain yang didukung dengan cara yang sama menggunakan iteratornya masing-masing.

yang Dipicu oleh Tren

Skrip Google Ads memungkinkan Anda membuat ekstensi iklan yang didukung. Misalnya, cuplikan kode berikut menggunakan pembuat nomor telepon untuk membuat nomor telepon di akun Anda:

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

Saat build() dipanggil, nomor telepon akan dibuat di akun, tetapi belum akan ditampilkan bersama iklan apa pun. Anda harus menambahkannya terlebih dahulu ke kampanye atau grup iklan:

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

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

Ekstensi iklan lain yang didukung dapat dibuat dan dikaitkan ke kampanye atau grup iklan dengan cara yang sama dengan pembangun masing-masing.

Mendapatkan statistik

Skrip Google Ads memungkinkan Anda mengakses statistik untuk ekstensi iklan yang didukung di tingkat akun, kampanye, atau grup iklan.

Misalnya, untuk mendapatkan statistik sitelink:

// 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());

Statistik untuk ekstensi iklan lain yang didukung dapat diakses dengan cara yang sama.

Mengubah ekstensi iklan

Ekstensi iklan yang ada dan didukung dapat diubah dengan skrip Google Ads. Misalnya, cuplikan kode berikut akan mengubah sitelink yang ada:

// 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"

Catatan: Jika Anda mengubah Sitelink, tindakan ini akan memengaruhi penayangan iklan di semua kampanye dan grup iklan yang terkait dengan sitelink tersebut. Aturan ini berlaku baik saat Anda mengambil sitelink langsung dari akun, dari CampaignSitelink kampanye terkait, atau dari AdGroupSitelink grup iklan terkait. Contoh kode sebelumnya menunjukkan perilaku ini.

Konsep yang sama berlaku untuk ekstensi iklan lain yang didukung.

Mengakses ekstensi iklan tingkat grup iklan

Skrip Google Ads memungkinkan Anda mengakses ekstensi iklan tingkat grup iklan. Panggilan metode berikut akan menampilkan nomor telepon yang telah ditambahkan secara eksplisit ke grup iklan. Perhatikan bahwa jika nomor telepon telah ditambahkan ke kampanye tempat grup iklan berada, panggilan metode berikut tidak akan menampilkannya meskipun nomor telepon memenuhi syarat untuk muncul di iklan yang ditayangkan dari grup iklan tersebut.

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

Ekstensi iklan lainnya yang didukung dapat diakses di tingkat grup iklan dengan cara yang sama.

Mengakses ekstensi iklan tingkat akun

Skrip Google Ads memungkinkan Anda mengakses ekstensi iklan tingkat akun. Info, aplikasi seluler, dan ulasan dapat ditambahkan sebagai ekstensi iklan tingkat akun, tetapi sitelink dan nomor telepon tingkat akun tidak tersedia. Panggilan metode berikut akan menampilkan info yang telah ditambahkan secara eksplisit ke akun Anda.

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

Aplikasi seluler dan ulasan tingkat akun dapat diakses dengan cara yang serupa.

Menambahkan ekstensi iklan tingkat akun mirip dengan menambahkan ekstensi iklan tingkat kampanye atau tingkat grup iklan. Contoh berikut menunjukkan cara menambahkan ekstensi info tingkat akun:

// 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);

Aplikasi seluler dan ulasan tingkat akun dapat ditambahkan dengan cara yang serupa.

Menghapus ekstensi iklan kampanye, grup iklan, dan akun

Ekstensi iklan yang didukung dapat dihapus dari kampanye dan grup iklan di tingkat akun. Skrip Google Ads tidak mendukung penghapusan ekstensi iklan dari akun sekaligus.

// 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();

Demikian pula, untuk menghapus aplikasi seluler tingkat grup iklan atau tingkat akun:

// 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 will
// not 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);

Jika semua aplikasi seluler dihapus dari kampanye, kampanye tersebut tidak akan lagi memiliki ekstensi aplikasi seluler. Untuk menghapus semua aplikasi seluler dari kampanye, Anda perlu mengambil daftar aplikasi seluler untuk kampanye tersebut dan menghapusnya satu per satu. Prosedurnya sama untuk ekstensi iklan lain yang didukung.