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.

Skrypty Google Ads umożliwiają dostęp do obsługiwanych rozszerzeń reklam na 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
}

Podobnie możesz pobierać inne obsługiwane rozszerzenia reklam, 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 narzędzia do tworzenia numerów telefonów, aby utworzyć numer telefonu na Twoim koncie:

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

Gdy wywołasz build(), numer telefonu zostanie utworzony na koncie, ale nie będzie jeszcze wyświetlany obok żadnych reklam. Najpierw musisz dodać go 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 powiązywać z kampaniami lub grupami reklam w ten sam sposób za pomocą odpowiednich narzędzi do tworzenia.

Pobieranie statystyk

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

Aby na przykład 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());

Statystyki innych obsługiwanych rozszerzeń reklam możesz wyświetlić w podobny sposób.

Modyfikowanie rozszerzeń reklam

Za pomocą skryptów Google Ads można modyfikować dotychczasowe obsługiwane rozszerzenia reklam. Na przykład poniższy fragment kodu zmodyfikuje 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: jeśli zmodyfikujesz Sitelink, wpłynie to na reklamy wyświetlane we wszystkich kampaniach i grupach reklam, z którymi jest powiązany link do podstrony. Ta reguła obowiązuje niezależnie od tego, czy link do podstrony został pobrany bezpośrednio z konta, z CampaignSitelink powiązanej kampanii czy z AdGroupSitelink powiązanej grupy reklam. Powyższy przykład kodu pokazuje to zachowanie.

Te same zasady obowiązują w przypadku 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, to wywołanie metody nie zwróci ich, nawet jeśli numery telefonów kwalifikują się do wyświetlania 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ć 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 poziomie konta nie są dostępne. Poniższe wywołanie metody zwróci objaśnienia, które zostały wyraźnie dodane do Twojego konta.

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

Dostęp do aplikacji mobilnych i opinii na poziomie konta można uzyskać w podobny sposób.

Dodawanie rozszerzeń reklam na poziomie konta jest podobne do dodawania 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 na poziomie 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 z konta wszystkich rozszerzeń reklam 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();

Podobnie, 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 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);

Jeśli z kampanii zostaną usunięte wszystkie aplikacje mobilne, nie będzie ona już zawierać rozszerzenia o aplikację mobilną. Aby usunąć z kampanii wszystkie aplikacje mobilne, musisz pobrać listę aplikacji mobilnych w tej kampanii i usuwać je pojedynczo. W przypadku innych obsługiwanych rozszerzeń reklam procedura jest taka sama.