Медийные ресурсы объявлений

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

Загрузка изображений

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

Приведенный далее фрагмент кода показывает, как добавить изображение с внешнего URL.

var imageUrl = "http://www.example.com/example.png";
var imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
var mediaOperation = AdWordsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Кроме того, Blob-объект изображения можно загрузить с Google Диска.

var imageFileId = "IMAGE_FILE_ID";
var imageBlob = DriveApp.getFileById(imageFileId).getBlob();
var mediaOperation = AdWordsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Загрузка рекламных наборов

Рекламные наборы – это ZIP-архивы с ресурсами, которые можно использовать для создания объявлений HTML5. Подробнее о структуре файла читайте в документации по формату. Рекламные наборы загружаются с помощью класса MediaBundleBuilder, который получает данные по именам и файлам. Как и в случае изображений, данные передаются в виде объектов Blob.

Приведенный далее фрагмент кода показывает, как загрузить рекламный набор с внешнего URL.

var mediaBundleUrl = "http://www.example.com/example.zip";
var mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
var mediaOperation = AdWordsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

Создание запросов

Для медийных наборов каждого типа в скриптах AdWords можно создавать запросы с помощью MediaSelector. Используйте предикат withCondition(), чтобы фильтровать медийные ресурсы по имени, типу и другим полям. Например, приведенный далее фрагмент кода находит все изображения в аккаунте.

var mediaIterator = AdWordsApp.adMedia().Media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  var image = adIterator.next();
}

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

См. полные примеры кода для создания поддерживаемых объявлений с медийными ресурсами.

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

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