Rozszerzenia reklam

Skrypty Google Ads obsługują te rozszerzenia reklam:

• Aplikacje mobilne
• Numery telefonów
• Objaśnienia
• Ceny
• Fragmenty
• Linki do podstron

Więcej informacji o rozszerzeniach reklam znajdziesz w Centrum pomocy.

Uwaga: rozszerzenia oparte na komponentach wkrótce zastąpią rozszerzenia oparte na plikach danych. Więcej informacji znajdziesz w przewodniku po migracji.

Skrypty Google Ads umożliwiają dostęp do obsługiwanych rozszerzeń reklamy na koncie. Na przykład ten fragment kodu uzyskuje dostęp do linków do witryn:

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

Inne obsługiwane rozszerzenia reklam możesz pobierać w podobny sposób, korzystając z odpowiednich iteratorów.

na podstawie trendów

Skrypty Google Ads umożliwiają tworzenie obsługiwanych rozszerzeń reklam. Na przykład ten fragment kodu używa kreatora numeru telefonu do utworzenia numeru telefonu na Twoim koncie:

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

Gdy użytkownik zadzwoni pod numer build(), na koncie zostanie utworzony numer telefonu, ale nie będzie on widoczny w żadnych reklamach. Najpierw musisz go dodać do kampanii lub grupy reklam:

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

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

Inne obsługiwane rozszerzenia reklam możesz tworzyć i powiązywać z kampaniami lub grupami reklam w ten sam sposób za pomocą odpowiednich kreatorów.

Pobieranie statystyk

Scenariusze Google Ads umożliwiają dostęp do statystyk dotyczących obsługiwanych rozszerzeń reklamy na poziomie konta, kampanii lub grupy reklam.

Aby na przykład uzyskać statystyki dotyczące linków do podstron:

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

W podobny sposób można uzyskać dostęp do statystyk innych obsługiwanych rozszerzeń reklam.

Modyfikowanie rozszerzeń reklam

Istniejące obsługiwane rozszerzenia reklam można modyfikować za pomocą skryptów Google Ads. Na przykład ten fragment kodu zmodyfikuje dotychczasowy link do podstrony:

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

Uwaga: jeśli zmodyfikujesz Sitelink, wpłynie to na wyświetlanie reklam we wszystkich kampaniach i grupach reklam, z którymi powiązany jest ten link do podstrony. To reguła obowiązuje niezależnie od tego, czy link do podstrony został pobrany bezpośrednio z konta, z CampaignSitelink powiązanej kampanii lub z AdGroupSitelink powiązanej grupy reklam. Poprzedni przykład kodu pokazuje to zachowanie.

Te same zasady dotyczą innych obsługiwanych rozszerzeń reklam.

Dostęp do rozszerzeń reklam na poziomie grupy reklam

Skrypty Google Ads umożliwiają dostęp do rozszerzeń reklam na poziomie grupy reklam. Poniższe wywołanie metody zwróci numery telefonów, które zostały wyraźnie dodane do grupy reklam. Pamiętaj, że jeśli do kampanii, do której należy grupa reklam, dodano numery telefonów, wywołanie tej metody nie zwróci ich, nawet jeśli numery te mogą się wyświetlać w reklamach wyświetlanych z tej grupy reklam.

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

Inne obsługiwane rozszerzenia reklam są dostępne na poziomie grupy reklam w podobny sposób.

Dostęp do rozszerzeń reklam na poziomie konta

Skrypty Google Ads umożliwiają dostęp do rozszerzeń reklamy na poziomie konta. Objaśnienia, aplikacje mobilne i opinie można dodawać jako rozszerzenia reklamy na poziomie konta, ale linki do podstron i numery telefonów na tym poziomie są niedostępne. Poniższe wywołanie metody zwróci objaśnienia dodane bezpośrednio do Twojego konta.

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

Aplikacje mobilne i opinie na poziomie konta można przeglądać w podobny sposób.

Dodawanie rozszerzeń reklam na poziomie konta przebiega podobnie jak dodawanie rozszerzeń reklam na poziomie kampanii lub grupy reklam. Ten przykład pokazuje, jak dodać rozszerzenie objaśnień na poziomie konta:

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

Aplikacje mobilne i opinie na poziomie konta można dodawać w podobny sposób.

Usuwanie rozszerzeń reklam z kampanii, grup reklam i konta

Obsługiwane rozszerzenia reklam możesz usuwać z kampanii i grup reklam na poziomie konta. Scenariusze Google Ads nie obsługują usuwania rozszerzeń reklam z konta naraz.

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

Aby podobnie usunąć aplikację mobilną na poziomie grupy reklam lub konta:

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

Jeśli z kampanii usuniesz wszystkie aplikacje mobilne, kampania nie będzie już mieć rozszerzenia o aplikację mobilną. Aby usunąć z kampanii wszystkie aplikacje mobilne, musisz pobrać listę aplikacji mobilnych tej kampanii i usunąć je pojedynczo. Procedura jest taka sama w przypadku innych obsługiwanych rozszerzeń reklam.