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 wideo i grup reklam
Kampanie wideo są dostępne w kolekcji videoCampaigns obiektu AdsApp. Możesz je pobierać 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 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) {
...
}
Utwórz reklamy 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() zasobu 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 withCondition do AdvertisingChannelSubType.
Niektóre kampanie wideo mają podtypy, które ograniczają rodzaje reklam obsługiwanych w ramach danej kampanii. 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 wykonywanie działań na określonych typach kampanii jest użycie w selektorze klauzuli withCondition. 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 po określonym czasie. Reklamy wideo Discovery wyświetlają się w sieci reklamowej i na różnych stronach YouTube. Są odtwarzane tylko wtedy, gdy użytkownik kliknie miniaturę reklamy. Bumpery reklamowe trwają maksymalnie 6 sekund i mogą się wyświetlać w filmach na YouTube lub w filmach w witrynach i aplikacjach partnerów w sieci reklamowej. Szczegółowe informacje o każdym z tych typów reklam znajdziesz w artykule Formaty reklam wideo.
Utwórz grupę reklam.
Grupę reklam wideo tworzy się za pomocą metody newVideoAdGroupBuilder() kampanii wideo. Podczas tworzenia grupy reklam musisz określić jej typ i nazwę. Typ grupy reklam musi być jednym z podanych poniżej i nie można go zmienić po utworzeniu grupy reklam:
VIDEO_BUMPERVIDEO_EFFICIENT_REACHVIDEO_NON_SKIPPABLE_IN_STREAM(tylko w przypadku kampaniiVIDEO_NON_SKIPPABLE)VIDEO_RESPONSIVE(tylko w przypadku kampaniiVIDEO_ACTION)VIDEO_TRUE_VIEW_IN_DISPLAYVIDEO_TRUE_VIEW_IN_STREAMYOUTUBE_AUDIO
Przykład:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("VIDEO_TRUE_VIEW_IN_STREAM")
.withName("Video Ad Group")
.build()
.getResult();
Utwórz komponent wideo
Reklamy wideo zwykle muszą 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ć istniejący film na YouTube, który został wcześniej przesłany, aby użyć 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 odpowiadającej typowi grupy reklam (połączonej po newVideoAd()):
inStreamAdBuilder()videoDiscoveryAdBuilder()bumperAdBuilder()responsiveVideoAdBuilder()(tylko w przypadku kampaniiVIDEO_ACTION)nonSkippableAdBuilder()(tylko w przypadku kampaniiVIDEO_NON_SKIPPABLE)
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 rodzaje kierowania. VideoCampaignTargeting reprezentuje kierowanie na poziomie konta w przypadku kampanii wideo i jest dostępne za pomocą AdsApp.videoCampaignTargeting(). Nie można go zmienić za pomocą skryptów, ale można go wyświetlić.
Drugi typ kierowania pozwala określić kryteria dla kampanii wideo i grup reklam wideo osobno. Można uzyskać do niego dostęp za pomocą metody videoTargeting() w kampanii lub grupie reklam. Zapewnia on dostęp do selektorów i konstruktorów zarówno kryteriów pozytywnych, jak i negatywnych wszystkich typów, które można stosować na danym poziomie kierowania. Metoda AdsApp.videoTargeting() umożliwia też wyświetlanie 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 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 tworzona jest nowa grupa reklam, kryteria dla każdej możliwej wartości wieku i płci są tworzone automatycznie, a grupa reklam jest kierowana na wszystkie te wartości. Możesz wykluczyć grupę demograficzną, pobierając istniejące kierowanie i wywołując na nim metodę exclude(). Możesz też ponownie uwzględnić wykluczoną grupę demograficzną, znajdując istniejące kierowanie wykluczające i wywołując metodę 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();
}