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

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

Создание

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

Рассмотрим фрагмент кода, демонстрирующий создание развернутого текстового объявления.

var 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, в которой доступны методы, относящиеся к типам.

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

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

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

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

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

Отчетность

Для запросов к полям объявлений определенных типов, например к полям развернутых текстовых объявлений, можно также использовать AD_PERFORMANCE_REPORT. Приведенный далее фрагмент кода показывает, как получить статистику по всем развернутым текстовым объявлениям со словосочетанием "Discount Sales" в первой части заголовка.

var report = AdWordsApp.report(
    "SELECT AdGroupId, Id, HeadlinePart1, HeadlinePart2, Clicks, Impressions, Cost " +
    "FROM   AD_PERFORMANCE_REPORT " +
    "WHERE HeadlinePart1 CONTAINS 'Discount Sales' " +
    "DURING LAST_7_DAYS");

var rows = report.rows();
while (rows.hasNext()) {
  var row = rows.next();
  var headlinePart1 = row["HeadlinePart1"];
  var headlinePart2 = row["HeadlinePart2"];
  ...
}

Подробнее читайте в руководстве по отчетам.

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

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