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 kampanii i generować raporty. Nie możesz jednak używać skryptów do tworzenia kampanii wideo.

Pobieranie kampanii i grup reklam wideo

Kampanie wideo są dostępne w kolekcji videoCampaigns obiektu AdsApp. Możesz je pobierać tak samo jak 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 pobierać jej grupy reklam w następujący sposób:

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() VideoAdGroup. Nowe reklamy wideo możesz tworzyć za pomocą metody newVideoAd() 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 na stronie AdvertisingChannelSubType.

Niektóre kampanie wideo mają podtypy, które ograniczają wyświetlanie w nich rodzajów reklam. 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 działania na konkretnych typach kampanii jest użycie w selektorze klauzuli withCondition. Możesz zaktualizować AdvertisingChannelSubType pod kątem wybranego 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, korzystając z withCondition:

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

Reklamy wideo In-Stream mogą być wyświetlane przed innymi filmami, w ich trakcie lub po nich. Użytkownicy mają możliwość pominięcia reklamy po określonym czasie. Reklamy wideo Discovery wyświetlają się w sieci reklamowej oraz na różnych stronach w YouTube. Są one odtwarzane tylko wtedy, gdy użytkownik kliknie najpierw miniaturę reklamy. Bumpery reklamowe trwają maksymalnie 6 sekund i mogą wyświetlać się w filmach w YouTube, w witrynach i aplikacjach partnerów w sieci reklamowej. Więcej informacji o każdym z tych typów reklam znajdziesz w artykule Formaty reklam wideo.

Tworzenie grupy reklam

Grupę reklam wideo możesz utworzyć za pomocą metody newVideoAdGroupBuilder() w kampanii wideo. Podczas tworzenia grupy reklam musisz podać jej typ i nazwę. Typ grupy reklam musi należeć do jednego z poniższych. Po utworzeniu grupy reklam nie można jej zmienić:

  • TRUE_VIEW_IN_STREAM
  • TRUE_VIEW_IN_DISPLAY
  • BUMPER
  • VIDEO_RESPONSIVE (tylko w przypadku VIDEO_ACTION kampanii)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (tylko w przypadku VIDEO_NON_SKIPPABLE kampanii)

Przykład:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("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, który film będzie odtwarzany w reklamie. Nie możesz przesyłać filmów, korzystając ze skryptów, ale możesz połączyć z reklamami istniejący film w YouTube, który został przez Ciebie przesłany wcześniej. Aby to zrobić, utwórz Asset z 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 kreatora pasującej do typu grupy reklam (zatytułowanej po newVideoAd()):

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 kampaniach wideo dostępne są 2 rodzaje odpowiedniego kierowania. Element VideoCampaignTargeting odpowiada rodzajowi kierowania w kampaniach wideo na poziomie konta, do którego można uzyskać dostęp za pomocą parametru AdsApp.videoCampaignTargeting(). Nie można tego zmienić za pomocą skryptów, ale można je wyświetlić.

Drugi typ kierowania pozwala określać kryteria dla poszczególnych kampanii wideo i grup reklam wideo. Jest ona dostępna za pomocą metody videoTargeting() w kampanii lub grupie reklam. Zapewnia dostęp do selektorów i kreatorów zarówno pozytywnych, jak i negatywnych kryteriów dla wszystkich typów kierowania na danym poziomie kierowania. Metoda AdsApp.videoTargeting() umożliwia też wyświetlanie kryteriów na poziomie konta i obejmuje inny zestaw kryteriów niż kryteria AdsApp.videoCampaignTargeting(). Tak jak w przypadku VideoCampaignTargeting, nie możesz zarządzać tymi kryteriami za pomocą skryptów.

Oto przykład wykluczenia określonego miejsca docelowego w kampanii:

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

Kryteria danych demograficznych (wiek, płeć) działają nieco inaczej niż pozostałe rodzaje kryteriów. Po utworzeniu nowej grupy reklam kryteria dla każdej możliwej wartości wieku i płci są tworzone automatycznie, a ta grupa reklam jest kierowana na wszystkie te wartości. Aby wykluczyć grupę demograficzną, pobierając istniejące ustawienia kierowania i wywołując w niej metodę exclude(), możesz też ponownie uwzględniać wykluczoną grupę demograficzną, odnajdując istniejące ustawienia kierowania wykluczającego i wywołując metodę include().

Oto przykład wykluczenia 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();
}