Эта страница переведена с помощью Cloud Translation API.

Видео кампании

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

Получение информации о видеокампаниях и группах объявлений.

Видеокампании доступны через коллекцию videoCampaigns объекта AdsApp . Вы можете получить к ним доступ так же, как и к обычным кампаниям в скриптах:

const campaignName = "My first video campaign";

const campaignIterator = AdsApp.videoCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

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

const adGroupIterator = campaign.videoAdGroups()
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

В качестве альтернативы можно использовать метод AdsApp.videoAdGroups() :

const adGroupIterator = AdsApp.videoAdGroups()
    .withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

Создавайте видеорекламу

Скрипты Google Ads позволяют получать доступ к вашим видеообъявлениям с помощью метода videoAds() класса VideoAdGroup . Вы можете создавать новые видеообъявления с помощью метода newVideoAd() класса VideoAdGroup .

Форматы видеорекламы

Поддерживаемые форматы видеорекламы различаются в зависимости от типа видеокампании. Чтобы убедиться, что вы выбираете правильный тип видеокампании, добавьте вызов withCondition в AdvertisingChannelSubType .

В некоторых видеокампаниях существуют подтипы, которые ограничивают типы рекламы, поддерживаемые в рамках данной кампании. В частности, кампании VIDEO_ACTION поддерживают только тип рекламы VIDEO_RESPONSIVE , а кампании VIDEO_NON_SKIPPABLE — только тип рекламы NON_SKIPPABLE_INSTREAM_VIDEO_AD .

Наилучший способ работы с определенными типами кампаний — использовать условие withCondition в селекторе. Вы можете обновить значение AdvertisingChannelSubType для интересующего вас типа кампании:

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
  .get();

Видеокампании без подтипа поддерживают следующие форматы видеорекламы:

TrueView в потоке
Поиск видео TrueView
Бампер

Вы можете выбрать эти кампании, используя условие withCondition :

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = null")
  .get();

Видеореклама, размещаемая непосредственно в потоке, может воспроизводиться до, во время или после других видеороликов, предоставляя пользователям возможность пропустить их через указанное время. Видеореклама, демонстрируемая в контекстно-медийной сети и на различных страницах YouTube, будет воспроизводиться только в том случае, если пользователь сначала активно кликнет на миниатюру объявления. Короткие рекламные ролики (бамперы) длятся 6 секунд или меньше и могут отображаться в видеороликах YouTube, а также в видеороликах на партнерских сайтах и в приложениях в контекстно-медийной сети. Подробную информацию о каждом из этих типов рекламы см. в разделе «О форматах видеорекламы» .

Создайте группу объявлений

Видеогруппа объявлений создается с помощью метода newVideoAdGroupBuilder() видеокампании. При создании группы объявлений необходимо указать тип группы объявлений и ее имя. Тип группы объявлений должен быть одним из следующих и не может быть изменен после создания группы объявлений:

VIDEO_BUMPER
VIDEO_EFFICIENT_REACH
VIDEO_NON_SKIPPABLE_IN_STREAM (только для кампаний VIDEO_NON_SKIPPABLE )
VIDEO_RESPONSIVE (только для кампаний VIDEO_ACTION )
VIDEO_TRUE_VIEW_IN_DISPLAY
VIDEO_TRUE_VIEW_IN_STREAM
YOUTUBE_AUDIO

Пример:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("VIDEO_TRUE_VIEW_IN_STREAM")
    .withName("Video Ad Group")
    .build()
    .getResult();

Создайте видеоматериал.

Видеореклама, как правило, должна ссылаться на видеофайл. Это определяет, какое видео будет воспроизводиться в рекламе. Вы не можете загрузить видео с помощью скриптов, но вы можете добавить ссылку на уже загруженное вами ранее видео с YouTube для использования в вашей рекламе. Для этого создайте файл Asset с помощью инструмента YouTubeVideoAssetBuilder .

const assetOperation = AdsApp.adAsset().newYouTubeVideoAssetBuilder()
   .withName("name")
   // This is the ID in the URL for the YouTube video.
   .withYouTubeVideoId(youTubeVideoId)
   .build();
const videoAsset = assetOperation.getResult();

Создайте объявление

Для создания нового объявления используйте метод конструктора, соответствующий типу группы объявлений (он находится после newVideoAd() ):

inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder() (только для кампаний VIDEO_ACTION )
nonSkippableAdBuilder() (только для кампаний VIDEO_NON_SKIPPABLE )

Например:

const videoAd = videoAdGroup.newVideoAd()
    .inStreamAdBuilder()
    .withAdName("Video Ad")
    .withFinalUrl("http://www.example.com/video-ad")
    // Specify the video asset created in the last step.
    .withVideo(video)
    .build()
    .getResult();

Целевой видеотаргетинг

Для видеокампаний существует два разных типа таргетинга. Параметр VideoCampaignTargeting представляет собой любой таргетинг, выполняемый на уровне аккаунта для видеокампаний в целом, и доступен с помощью AdsApp.videoCampaignTargeting() . Его нельзя изменить с помощью скриптов, но можно просмотреть.

Другой тип таргетинга позволяет задавать критерии для видеокампаний и групп видеообъявлений по отдельности. Доступ к нему осуществляется с помощью метода videoTargeting() кампании или группы объявлений, и он предоставляет доступ к селекторам и конструкторам как для положительных, так и для отрицательных критериев для всех типов, применимых к этому уровню таргетинга. Метод AdsApp.videoTargeting() также существует для просмотра критериев на уровне аккаунта и включает в себя другой набор критериев, чем AdsApp.videoCampaignTargeting() . Как и в случае с VideoCampaignTargeting , вы не можете управлять этими критериями с помощью скриптов.

Вот пример исключения определенного места размещения в рекламной кампании:

videoCampaign.videoTargeting().newPlacementBuilder()
    .withUrl("http://www.example.com")
    .exclude();

Критерии для демографических данных (возраст, пол) работают несколько иначе, чем другие типы критериев. При создании новой группы объявлений критерии для каждого возможного значения возраста и пола создаются автоматически, и эта группа объявлений нацелена на все эти значения. Вы можете исключить демографическую группу, получив существующие настройки таргетинга и вызвав метод exclude() , а также повторно включить исключенную демографическую группу, найдя существующие настройки таргетинга для исключения и вызвав метод include() .

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

const videoGenderIterator = videoAdGroup.videoTargeting()
    .genders()
    .withCondition('GenderType = "GENDER_MALE"')
    .get();
if (videoGenderIterator.hasNext()) {
  const videoGender = videoGenderIterator.next();
  videoGender.exclude();
}