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 przypadkuVIDEO_ACTION
kampanii)NON_SKIPPABLE_INSTREAM_VIDEO_AD
(tylko w przypadkuVIDEO_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()
):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(tylko w przypadkuVIDEO_ACTION
kampanii)nonSkippableAdBuilder()
(tylko w przypadkuVIDEO_NON_SKIPPABLE
kampanii)
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();
}