Kampanie wideo

Skrypty Google Ads umożliwiają zarządzanie kampaniami wideo w YouTube i generowanie raportów na ich temat. Za pomocą skryptów możesz zarządzać dotychczasowymi kampaniami wideo, tworzyć grupy reklam i reklamy oraz nimi zarządzać, konfigurować kierowanie w kampaniach i generować raporty. Nie możesz jednak używać skryptów do tworzenia kampanii wideo.

Pobieranie kampanii wideo i grup reklam

Kampanie wideo są dostępne w kolekcji videoCampaigns obiektu AdsApp. Możesz je pobrać tak samo jak zwykłe kampanie w skryptach:

const campaignName = "My first video campaign";

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

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

Po pobraniu kampanii możesz w podobny sposób pobrać jej grupy reklam:

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

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

Możesz też użyć metody AdsApp.videoAdGroups():

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

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

Tworzenie reklam wideo

Skrypty Google Ads umożliwiają pobieranie reklam wideo za pomocą metody videoAds() w VideoAdGroup. Możesz tworzyć nowe reklamy wideo za pomocą metody newVideoAd() w VideoAdGroup.

Formaty reklam wideo

Obsługiwane formaty reklam wideo różnią się w zależności od typu kampanii wideo. Aby mieć pewność, że wybierasz odpowiedni rodzaj kampanii wideo, dodaj wywołanie withCondition w AdvertisingChannelSubType.

Niektóre kampanie wideo mają podtypy, które ograniczają rodzaje reklam obsługiwanych w danej kampanii. W szczególności kampanie VIDEO_ACTION obsługują tylko typ reklamy VIDEO_RESPONSIVE, a kampanie VIDEO_NON_SKIPPABLE – tylko typ reklamy NON_SKIPPABLE_INSTREAM_VIDEO_AD.

Najlepszym sposobem na obsługę określonych typów kampanii jest użycie klauzuli withCondition w selektorze. Możesz zaktualizować AdvertisingChannelSubType dla interesującego Cię typu kampanii:

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

Kampanie wideo bez podtypu obsługują te formaty reklam wideo:

  • Reklama TrueView In-Stream
  • Reklama wideo TrueView Discovery
  • Bumper

Możesz wybrać te kampanie za pomocą withCondition:

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

Reklamy wideo In-Stream mogą wyświetlać się przed innymi filmami, w ich trakcie lub po nich, dając użytkownikom możliwość pominięcia reklamy po określonym czasie. Reklamy wideo Discovery wyświetlają się w sieci reklamowej i na różnych stronach YouTube. Odtwarzają się tylko wtedy, gdy użytkownik aktywnie kliknie najpierw miniaturę reklamy. Bumpery reklamowe trwają 6 sekund lub krócej i mogą wyświetlać się w filmach w YouTube, a także w witrynach partnerów wideo oraz w aplikacjach należących do sieci reklamowej. Szczegółowe informacje o każdym z tych typów reklam znajdziesz w artykule Formaty reklam wideo.

Tworzenie grupy reklam

Grupę reklam wideo tworzysz za pomocą newVideoAdGroupBuilder() metody w kampanii wideo. Podczas tworzenia grupy reklam musisz określić jej typ i nazwę. Typ grupy reklam musi być jednym z tych typów i nie można go zmienić po utworzeniu grupy reklam:

  • VIDEO_BUMPER
  • VIDEO_EFFICIENT_REACH
  • VIDEO_NON_SKIPPABLE_IN_STREAM (tylko w przypadku kampanii VIDEO_NON_SKIPPABLE)
  • VIDEO_RESPONSIVE (tylko w przypadku kampanii VIDEO_ACTION)
  • VIDEO_TRUE_VIEW_IN_DISPLAY
  • VIDEO_TRUE_VIEW_IN_STREAM
  • YOUTUBE_AUDIO

Przykład:

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

Tworzenie komponentu wideo

Reklamy wideo zazwyczaj muszą odwoływać się do komponentu wideo. Określa on, który film będzie odtwarzany w reklamie. Nie możesz przesyłać filmu za pomocą skryptów, ale możesz połączyć istniejący film na YouTube, który został wcześniej przesłany, aby używać go w reklamach. Aby to zrobić, utwórz Asset za pomocą 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();

Tworzenie reklamy

Aby utworzyć nową reklamę, użyj metody tworzenia pasującej do typu grupy reklam (połączonej z newVideoAd()):

Na przykład:

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();

Kierowanie wideo

W przypadku kampanii wideo dostępne są 2 różne typy kierowania. The VideoCampaignTargeting reprezentuje dowolne kierowanie, które jest wykonywane na poziomie konta w przypadku kampanii wideo, i jest dostępne za pomocą AdsApp.videoCampaignTargeting(). Nie można go modyfikować za pomocą skryptów, ale można je wyświetlić.

Drugi typ kierowania umożliwia określanie kryteriów dla kampanii wideo i grup reklam wideo osobno. Jest on dostępny za pomocą metody videoTargeting() w kampanii lub grupie reklam i zapewnia dostęp do selektorów i narzędzi do tworzenia zarówno kryteriów pozytywnych, jak i wykluczających dla wszystkich typów mających zastosowanie do tego poziomu kierowania. Metoda AdsApp.videoTargeting() służy też do wyświetlania kryteriów na poziomie konta i zawiera inny zestaw kryteriów niż AdsApp.videoCampaignTargeting(). Podobnie jak w przypadku VideoCampaignTargeting nie możesz zarządzać tymi kryteriami za pomocą skryptów.

Oto przykład wykluczania konkretnego miejsca docelowego w kampanii:

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

Kryteria demograficzne (wiek, płeć) działają nieco inaczej niż inne typy kryteriów. Gdy tworzona jest nowa grupa reklam, automatycznie tworzone są kryteria dla każdej możliwej wartości wieku i płci, a ta grupa reklam kieruje reklamy na wszystkie te kryteria. Możesz wykluczyć grupę demograficzną, pobierając dotychczasowe kierowanie i wywołując na nim metodę exclude(). Możesz też ponownie uwzględnić wykluczoną grupę demograficzną, znajdując dotychczasowe kierowanie wykluczające i wywołując metodę include().

Oto przykład wykluczania konkretnej płci z grupy reklam:

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