Типы объявлений

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

Создание

Скрипты могут создавать рекламу с помощью метода newAd() в экземплярах AdGroup . Это возвращает AdBuilderSpace , который создает конструкторы для поддерживаемых типов объявлений.

В следующем фрагменте показано, как создать развернутое текстовое объявление: 

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

Инспекция

Некоторая информация, связанная со всеми типами объявлений, доступна сразу же из Ad , например идентификатор объявления и статус одобрения. Кроме того, любую рекламу можно приостановить, включить или удалить.

Чтобы получить доступ к полям, специфичным для типа объявления, например к описанию расширенного текстового объявления, используйте метод asType() для создания AdViewSpace . Это обеспечивает доступ к расширенной версии Ad , которая предоставляет методы для конкретного типа.

Следующий фрагмент получает описание каждого развернутого текстового объявления:

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

Обратите внимание, что условие Type = EXPANDED_TEXT_AD гарантирует, что каждое объявление итератора является развернутым текстовым объявлением. Попытка просмотреть объявление неправильного типа приведет к ошибке, которая остановит выполнение вашего скрипта, поэтому важно просматривать поля, относящиеся к конкретному типу, только в том случае, если тип объявления известен.

В следующем фрагменте показано, как определить, имеет ли объявление правильный тип, с помощью метода Ad.isType() : 

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

Отчетность

Представление ad_group_ad также можно использовать для запроса полей объявлений определенного типа в дополнение к обычной статистике, например ad_group_ad.expanded_text_ad.headline_part1 . В следующем фрагменте показано, как получить статистику для всех развернутых текстовых объявлений, содержащих слово «Продажи со скидкой» в заголовке 1:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

Дополнительную информацию об отчетах в сценариях см. в руководстве по отчетам .