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

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

Подробнее о расширениях объявлений читайте в Справочном центре.

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

var sitelinkIterator = AdWordsApp.extensions().sitelinks().get();
while (sitelinkIterator.hasNext()) {
  var sitelink = sitelinkIterator.next();
}

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

Создание расширений объявлений

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

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

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

// Добавление номера телефона в кампанию.
campaign.addPhoneNumber(newPhoneNumber);

// Добавление номера телефона в группу объявлений.
adGroup.addPhoneNumber(newPhoneNumber);

Другие расширения можно создать таким же образом, используя соответствующие функции.

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

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

Пример получения статистики по дополнительным ссылкам:

// Статистика на уровне аккаунта
// Получение дополнительной ссылки в аккаунте.
var sitelinkIterator = AdWordsApp.extensions().sitelinks().get();
var sitelink = sitelinkIterator.next();
var sitelinkStats = sitelink.getStatsFor("LAST_30_DAYS");
Logger.log(sitelinkStats.getClicks());

// Статистика на уровне кампании
// Получение дополнительной ссылки в кампании.
var campaignSitelinkIterator = campaign.extensions().sitelinks().get();
var campaignSitelink = campaignSitelinkIterator.next();
var campaignSitelinkStats = campaignSitelink.getStatsFor("LAST_30_DAYS");
Logger.log(campaignSitelinkStats.getClicks());

// Статистика на уровне группы объявлений
// Получение дополнительной ссылки в группе объявлений.
var adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
var adGroupSitelink = adGroupSitelinkIterator.next();
var adGroupSitelinkStats = adGroupSitelink.getStatsFor("LAST_30_DAYS");
Logger.log(adGroupSitelinkStats.getClicks());

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

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

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

// Получение дополнительной ссылки на уровне аккаунта.
var sitelinkIterator = AdWordsApp.extensions().sitelinks().get();
var sitelink = sitelinkIterator.next();
Logger.log(sitelink.getLinkText()); // "исходный текст"

// Получение дополнительной ссылки в кампании. Допустим, ссылка та же.
var campaignSitelinkIterator = campaign.extensions().sitelinks().get();
var campaignSitelink = campaignSitelinkIterator.next();
Logger.log(campaignSitelink.getLinkText()); // "исходный текст"

// Получение дополнительной ссылки в группе объявлений. Допустим, ссылка та же.
var adGroupSitelinkIterator = adGroup.extensions().sitelinks().get();
var adGroupSitelink = adGroupSitelinkIterator.next();
Logger.log(adGroupSitelink.getLinkText()); // "исходный текст"

// Изменение текста дополнительной ссылки. Оно коснется всех кампаний и групп объявлений,
// где используется ссылка.
campaignSitelink.setLinkText("новый текст ссылки");

// Тот же текст!
Logger.log(campaignSitelink.getLinkText()); // "новый текст ссылки"
Logger.log(adGroupSitelink.getLinkText()); // "новый текст ссылки"
Logger.log(sitelink.getLinkText()); // "новый текст ссылки"

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

Для других расширений используются те же принципы.

Расширения объявлений на уровне группы объявлений

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

// Этот метод будет возвращать номера телефонов, которые используются только в указанной группе объявлений.
var adGroupPhoneNumberIterator = adGroup.extensions().phoneNumbers().get();

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

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

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

// Будут возвращены уточнения, явным образом добавленные в аккаунт.
var accountCalloutIterator =
    AdWordsApp.currentAccount().extensions().callouts().get();

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

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

// Создание нового уточнения в аккаунте. Без добавления нового уточнения
// на уровне группы объявлений, кампании или аккаунта оно не будет появляться.
var calloutBuilder = AdWordsApp.extensions().newCalloutBuilder();
var newCallout = calloutBuilder.withText("Sample Text").build().getResult();

// Добавление нового уточнения на уровне аккаунта. Это позволит
// показывать его во всех кампаниях аккаунта.
AdWordsApp.currentAccount().addCallout(newCallout);

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

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

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

// Получение мобильного приложения из кампании.
var campaignMobileAppIterator = campaign.extensions().mobileApps().get();
var campaignMobileApp = campaignMobileAppIterator.next();

// Удаление мобильного приложения.
campaign.removeMobileApp(campaignMobileApp);

// Мобильное приложение все ещё присутствует в аккаунте и будет возвращаться
// с помощью указанного ниже итератора.
var mobileAppIterator = AdWordsApp.extensions().mobileApps().get();

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

// Получение мобильного приложения из группы объявлений.
var adGroupMobileAppIterator = adGroup.extensions().mobileApps().get();
var adGroupMobileApp = adGroupMobileAppIterator.next();

// Удаление мобильного приложения.
adGroup.removeMobileApp(adGroupMobileApp);

// Получение мобильного приложения на уровне аккаунта.
var accountMobileAppIterator =
    AdWordsApp.currentAccount().extensions().mobileApps().get();
var accountMobileApp = accountMobileAppIterator.next();

// Удаление мобильного приложения.
// Мобильное приложение будет удалено на уровне аккаунта. Оно не будет
// появляться в виде расширения на уровне аккаунта, хоть и останется
// в аккаунте. Его можно будет добавить в группу объявлений, кампанию
// или в качестве расширения на уровне аккаунта.
AdWordsApp.currentAccount().removeMobileApp(accountMobileApp);

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

Скрипты и фиды AdWords

Скрипты AdWords можно использовать для получения расширений только в фиде по умолчанию. Элементы из пользовательских фидов не поддерживаются. Все расширения в интерфейсе AdWords создаются в фиде по умолчанию. Подробнее о пользовательских фидах читайте в документации по AdWords API.

Оставить отзыв о...

Текущей странице
Скрипты AdWords
Скрипты AdWords