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 za pomocą odpowiednich iteratorów.

Tworzenie

Skrypty Google Ads umożliwiają tworzenie obsługiwanych rozszerzeń reklam za pomocą narzędzi do tworzenia. Na przykład ten fragment kodu używa narzędzia do tworzenia numeru telefonu, aby utworzyć numer telefonu na koncie:

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

Gdy wywołasz funkcję 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żna uzyskać w podobny sposób.

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 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 before.
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 before.
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 jest powiązany. 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. Poprzedni przykład kodu pokazuje to zachowanie.

Te same zasady obowiązują w przypadku innych obsługiwanych rozszerzeń reklam.

Uzyskiwanie dostępu do rozszerzeń reklam na poziomie grupy reklam

Skrypty Google Ads umożliwiają dostęp do rozszerzeń reklam na poziomie grupy reklam. To wywołanie metody zwróci numery telefonów, które zostały wyraźnie dodane do grupy reklam. Pamiętaj, że jeśli numery telefonów zostały dodane do kampanii, do której należy grupa reklam, 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();

Podobnie można uzyskać dostęp do innych obsługiwanych rozszerzeń reklam na poziomie grupy reklam.

Uzyskiwanie dostępu do rozszerzeń reklam na poziomie konta

Skrypty Google Ads umożliwiają dostęp do rozszerzeń reklam na poziomie konta. Objaśnienia, aplikacje mobilne i opinie można dodawać jako rozszerzenia reklam na poziomie konta, ale linki do podstron i numery telefonów na poziomie konta nie są dostępne. To 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();

Podobnie można uzyskać dostęp do aplikacji mobilnych i opinii na poziomie konta.

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śnienia 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);

Podobnie można dodawać aplikacje mobilne i opinie na poziomie konta.

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

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 wszystkie aplikacje mobilne zostaną usunięte z kampanii, kampania nie będzie już zawierać rozszerzenia aplikacji mobilnej. Aby usunąć wszystkie aplikacje mobilne z kampanii, musisz pobrać listę aplikacji mobilnych w tej kampanii i usunąć je pojedynczo. W przypadku innych obsługiwanych rozszerzeń reklam procedura jest taka sama.