Kampanie wideo

Dzięki skryptom Google Ads możesz zarządzać kampaniami wideo w YouTube i tworzyć raporty o nich. Za pomocą skryptów możesz zarządzać dotychczasowymi kampaniami wideo, tworzyć grupy reklam i reklamy oraz nimi zarządzać, konfigurować kierowanie kampanii i wygenerować 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 ramach kolekcji obiektu videoCampaignsAdsApp. Możesz je pobrać tak samo jak w przypadku kampanii 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()VideoAdGroup. Nowe reklamy wideo możesz tworzyć za pomocą metody VideoAdGroup newVideoAd().

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 funkcji withCondition w funkcji AdvertisingChannelSubType.

Niektóre kampanie wideo mają podtypy, które ograniczają rodzaje reklam obsługiwanych w ramach tej 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 działanie w przypadku określonych typów kampanii jest użycie w selektorze klauzuli withCondition. Możesz zaktualizować AdvertisingChannelSubType w przypadku 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

Te kampanie możesz wybrać 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 mogą je pominąć po określonym czasie. Reklamy wideo Discovery wyświetlają się w sieci reklamowej i na różnych stronach w YouTube. Odtwarzają się tylko wtedy, gdy użytkownik aktywnie kliknie miniaturę reklamy. Bumpery reklamowe trwają 6 sekund lub krócej i mogą się wyświetlać w filmach w YouTube oraz w witrynach i aplikacjach partnerów 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() w kampanii wideo. Podczas tworzenia grupy reklam musisz podać jej typ i nazwę. Typ grupy reklam musi być jednym z tych:

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

Przykład:

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

Tworzenie komponentu wideo

Reklamy wideo muszą zazwyczaj odwoływać się do komponentu wideo. Określa, który film będzie odtwarzany w reklamie. Nie możesz przesłać filmu za pomocą skryptów, ale możesz połączyć z reklamą istniejący film w YouTube, który został już wcześniej przesłany. W tym celu utwórz element Asset za pomocą elementu 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 dopasowanej do typu grupy reklam (połączonej za pomocą 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 trafnego kierowania. Wartość VideoCampaignTargetingreprezentuje dowolne ustawienia kierowania stosowane na poziomie konta w przypadku kampanii wideo. Można się do niej dostać za pomocą parametru AdsApp.videoCampaignTargeting(). Nie można go modyfikować za pomocą skryptów, ale można go wyświetlić.

Drugi typ kierowania umożliwia określenie kryteriów dla kampanii wideo i grup reklam wideo osobno. Dostęp do niego uzyskujesz za pomocą metody videoTargeting() w kampanii lub grupie reklam. Daje ona dostęp do selektorów i elementów konstrukcyjnych zarówno dla pozytywnych, jak i ujemnych kryteriów we wszystkich typach kierowania dostępnych na danym poziomie kierowania. Metoda AdsApp.videoTargeting() służy też do wyświetlania kryteriów na poziomie konta i zawiera inny zestaw kryteriów niż metoda AdsApp.videoCampaignTargeting(). Podobnie jak w przypadku VideoCampaignTargeting, nie możesz zarządzać tymi kryteriami za pomocą skryptów.

Oto przykład wykluczenia 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 tworzysz nową grupę reklam, automatycznie tworzone są kryteria dla każdej możliwej wartości wieku i płci, a grupa reklam kieruje się na wszystkie z nich. Możesz wykluczyć grupę demograficzną, pobierając istniejące kierowanie i wywołując metodę exclude(). Możesz też ponownie uwzględnić wykluczoną grupę demograficzną, znajdując istniejące kierowanie na wykluczenia i wywołując funkcję include().

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

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