Расширения объявлений

Скрипты Google Рекламы поддерживают следующие расширения объявлений:

• Мобильные приложения
• Номера телефонов
• Выноски
• Цены
• Фрагменты
• Дополнительные ссылки

Чтобы узнать больше о расширениях объявлений, посетите Справочный центр .

Внимание! Расширения на основе объектов скоро заменят расширения на основе каналов. Дополнительную информацию см. в руководстве по миграции .

Скрипты Google Рекламы позволяют получить доступ к поддерживаемым расширениям объявлений в вашем аккаунте. Например, следующий фрагмент кода обеспечивает доступ к дополнительным ссылкам:

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

Вы можете получить другие поддерживаемые расширения объявлений аналогичным образом, используя соответствующие итераторы.

Создание

Скрипты Google Рекламы позволяют создавать поддерживаемые расширения объявлений. Например, в следующем фрагменте кода используется построитель телефонных номеров для создания номера телефона в вашей учетной записи:

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

При вызове build() в учетной записи создается номер телефона, но он пока не будет отображаться рядом с рекламой. Сначала вам необходимо добавить его в кампанию или группу объявлений:

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

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

Другие поддерживаемые расширения объявлений можно создавать и связывать с кампаниями или группами объявлений таким же образом с помощью соответствующих конструкторов .

Получение статистики

Скрипты Google Рекламы позволяют получить доступ к статистике по поддерживаемым расширениям объявлений на уровне аккаунта, кампании или группы объявлений.

Например, чтобы получить статистику дополнительных ссылок:

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

Статистику по другим поддерживаемым расширениям объявлений можно получить аналогичным способом.

Изменение расширений объявлений

Существующие поддерживаемые расширения объявлений можно изменить с помощью скриптов Google Рекламы. Например, следующий фрагмент кода изменит существующую дополнительную ссылку:

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

Примечание. Если вы измените Sitelink , это повлияет на показ объявлений во всех кампаниях и группах объявлений, с которыми связана дополнительная ссылка. Это правило применяется независимо от того, получили ли вы дополнительную ссылку непосредственно из аккаунта, из CampaignSitelink связанной кампании или из AdGroupSitelink связанной группы объявлений. Предыдущий пример кода демонстрирует такое поведение.

Те же принципы применимы и к другим поддерживаемым расширениям объявлений.

Доступ к расширениям объявлений на уровне группы объявлений

Скрипты Google Рекламы позволяют получить доступ к расширениям объявлений на уровне группы объявлений. Следующий вызов метода вернет номера телефонов, которые были явно добавлены в группу объявлений. Обратите внимание: если номера телефонов были добавлены в кампанию, к которой принадлежит группа объявлений, следующий вызов метода не вернет их, даже если номера телефонов могут появляться в объявлениях, показываемых из этой группы объявлений.

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

Доступ к другим поддерживаемым расширениям объявлений можно получить на уровне группы объявлений аналогичным образом.

Доступ к расширениям объявлений на уровне аккаунта

Скрипты Google Рекламы позволяют получить доступ к расширениям объявлений на уровне аккаунта. Уточнения, мобильные приложения и отзывы можно добавлять в качестве расширений объявлений на уровне аккаунта, но дополнительные ссылки и номера телефонов на уровне аккаунта недоступны. Следующий вызов метода вернет уточнения, которые были явно добавлены в вашу учетную запись.

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

Доступ к мобильным приложениям и отзывам на уровне учетной записи можно получить аналогичным образом.

Добавление расширений объявлений на уровне аккаунта аналогично добавлению расширений объявлений на уровне кампании или группы объявлений. В следующем примере показано, как добавить уточнение на уровне аккаунта:

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

Аналогичным образом можно добавлять мобильные приложения и обзоры на уровне учетной записи.

Удаление расширений объявлений кампании, группы объявлений и аккаунта

Поддерживаемые расширения объявлений можно удалить из кампаний и групп объявлений на уровне аккаунта. Скрипты Google Рекламы не поддерживают одновременное удаление расширений объявлений из аккаунта.

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

Аналогично, чтобы удалить мобильное приложение на уровне группы объявлений или аккаунта:

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

Если из кампании будут удалены все мобильные приложения, в ней больше не будет расширения для мобильных приложений. Чтобы удалить все мобильные приложения из вашей кампании, вам необходимо получить список мобильных приложений для этой кампании и удалять их по одному. Процедура такая же, как и для других поддерживаемых расширений объявлений.