Rozszerzenia reklam

Skrypty Google Ads obsługują te rozszerzenia reklam:

• aplikacje mobilne,
• Numery telefonów
• Objaśnienia
• Ceny
• Fragmenty wiadomości
• Linki do podstron

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

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

Skrypty Google Ads zapewniają dostęp do obsługiwanych rozszerzeń reklam na Twoim koncie. Na przykład ten fragment kodu uzyskuje dostęp do linków do podstron:

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

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

na podstawie trendów

Skrypty Google Ads pozwalają tworzyć obsługiwane rozszerzenia reklam. Na przykład ten fragment kodu korzysta z kreatora numerów telefonów, aby utworzyć numer telefonu na koncie:

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

Gdy użytkownik zadzwoni do firmy build(), numer telefonu zostanie utworzony na koncie, ale nie będzie jeszcze wyświetlany 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żna tworzyć i wiązać z kampaniami i grupami reklam tak samo, jak w przypadku ich kreatorów.

Pobieram statystyki

Skrypty Google Ads zapewniają dostęp do statystyk obsługiwanych rozszerzeń reklam na poziomie konta, kampanii lub grupy reklam.

Na przykład aby uzyskać statystyki 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 modyfikuje istniejący 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: zmiana Sitelink wpłynie na wyświetlanie reklam we wszystkich kampaniach i grupach reklam, z którymi jest powiązany ten link do podstrony. Ta reguła jest stosowana niezależnie od tego, czy link do podstrony został pobrany bezpośrednio z konta, z elementu CampaignSitelink powiązanej kampanii czy z AdGroupSitelink powiązanej grupy reklam. Poprzedni przykładowy kod ilustruje to zachowanie.

Te same pojęcia dotyczą innych obsługiwanych rozszerzeń reklam.

Dostęp do rozszerzeń reklam na poziomie grupy reklam

Skrypty Google Ads dają dostęp do rozszerzeń reklam na poziomie grupy reklam. Poniższe wywołanie metody zwróci numery telefonów, które zostały jawnie dodane do grupy reklam. Pamiętaj, że jeśli numery telefonów zostały dodane do kampanii, do której należy grupa reklam, poniższe wywołanie metody nie zwróci ich, nawet jeśli numery telefonów mogą być wyświetlane w reklamach z tej grupy reklam.

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

Dostęp do innych obsługiwanych rozszerzeń reklam można uzyskać w podobny sposób na poziomie grupy reklam.

Dostęp do rozszerzeń reklam na poziomie konta

Skrypty Google Ads dają dostęp do rozszerzeń reklam na poziomie konta. Objaśnienia, aplikacje mobilne i opinie można dodawać jako rozszerzenia reklam na poziomie konta, ale nie są dostępne linki do podstron ani numery telefonów na poziomie konta. Poniższe wywołanie metody zwróci objaśnienia, które zostały bezpośrednio dodane do konta.

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

W ten sam sposób można uzyskać dostęp do aplikacji mobilnych i opinii na poziomie konta.

Dodawanie rozszerzeń reklam na poziomie konta przypomina dodawanie rozszerzeń reklam na poziomie kampanii lub grupy reklam. Z przykładu poniżej dowiesz się, 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);

W ten sam sposób można dodawać opinie i aplikacje mobilne na poziomie konta.

Usuwanie rozszerzeń reklam z kampanii, grupy reklam i konta

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

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

Po usunięciu z kampanii wszystkich aplikacji mobilnych nie będzie ona już zawierać rozszerzenia aplikacji mobilnej. Aby usunąć z kampanii wszystkie aplikacje mobilne, musisz pobrać listę aplikacji mobilnych należących do danej kampanii i usunąć je pojedynczo. Procedura jest taka sama w przypadku innych obsługiwanych rozszerzeń reklam.