Kampanie wideo

Skrypty Google Ads umożliwiają zarządzanie kampaniami wideo w YouTube i tworzenie 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 obiektu videoCampaignsAdsApp. Możesz je pobrać w taki sam sposób, jak zwykle pobierasz 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 uzyskać 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() obiektu 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 typ kampanii wideo, dodaj withConditionwezwanie do działaniaAdvertisingChannelSubType.

Niektóre kampanie wideo mają podtypy, które ograniczają rodzaje reklam obsługiwanych w danej kampanii. W kampaniach VIDEO_ACTION można używać tylko typu reklamy VIDEO_RESPONSIVE, a w kampaniach VIDEO_NON_SKIPPABLE – tylko typu reklamy NON_SKIPPABLE_INSTREAM_VIDEO_AD.

Najlepszym sposobem na działanie w przypadku określonych typów kampanii jest użycie w selektorze klauzuli withCondition. Możesz zaktualizować AdvertisingChannelSubType dla 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 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, a użytkownicy mają możliwość pominięcia ich po określonym czasie. Reklamy wideo Discovery wyświetlają się w sieci reklamowej oraz na różnych stronach YouTube i są odtwarzane tylko wtedy, gdy użytkownik aktywnie kliknie najpierw miniaturę reklamy. Bumpery reklamowe trwają maksymalnie 6 sekund i mogą wyświetlać się w filmach w YouTube oraz w witrynach partnerów wideo i 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ą metody newVideoAdGroupBuilder() 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 zwykle muszą odwoływać się do komponentu wideo. Określa to, który film będzie odtwarzany w reklamie. Nie możesz przesyłać filmów za pomocą skryptów, ale możesz połączyć istniejący film w YouTube, który został wcześniej przesłany, aby używać go w reklamach. W tym celu 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 kreatora pasującej do typu grupy reklam (połączonej 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 przypadku kampanii wideo dostępne są 2 rodzaje kierowania na odpowiednie treści. Symbol VideoCampaignTargeting oznacza dowolne kierowanie, które jest wykonywane na poziomie konta w przypadku kampanii wideo, i jest dostępne za pomocą symbolu AdsApp.videoCampaignTargeting(). Tego ustawienia nie można modyfikować za pomocą skryptów, ale można je wyświetlać.

Drugi typ kierowania umożliwia określanie kryteriów dla kampanii wideo i grup reklam wideo oddzielnie. Możesz uzyskać do niego dostęp za pomocą metody videoTargeting() w kampanii lub grupie reklam. Zapewnia ona dostęp do selektorów i konstruktorów zarówno pozytywnych, jak i negatywnych kryteriów wszystkich typów odpowiednich dla tego poziomu kierowania. Metoda AdsApp.videoTargeting() umożliwia też wyświetlanie kryteriów na poziomie konta i obejmuje inny zestaw kryteriów niż AdsApp.videoCampaignTargeting(). Podobnie jak w przypadku kryteriów 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 dotyczące danych demograficznych (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. Aby wykluczyć grupę demograficzną, pobierz istniejące kierowanie i wywołaj na nim metodę exclude(). Aby ponownie uwzględnić wykluczoną grupę demograficzną, znajdź istniejące kierowanie na wykluczenia i wywołaj metodę include().

Oto przykład wykluczania określonej płci z grupy reklam:

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