Skrypty Google Ads pozwalają zarządzać filmami wideo w YouTube i generować raporty na ich temat . Możesz używać skryptów do zarządzania istniejącymi kampaniami wideo, tworzenia grup reklam i reklam oraz zarządzania nimi i generować raporty. Nie możesz jednak używać skryptów do tworzyć kampanie wideo.
Pobieram kampanie i grupy reklam wideo
Kampanie wideo są dostępne w
videoCampaigns
zbiór
AdsApp
. Ty
można je pobrać w taki sam sposób, w jaki pobiera się 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 wyświetlić jej grupy reklam w podobny 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ą
videoAds()
metoda
VideoAdGroup
Nowe reklamy wideo możesz utworzyć za pomocą
newVideoAd()
metoda VideoAdGroup
.
Formaty reklam wideo
Obsługiwane formaty reklam wideo różnią się w zależności od typu kampanii wideo. Aby zapewnić
wybierasz odpowiedni rodzaj kampanii wideo, dodaj połączenie withCondition
w dniu AdvertisingChannelSubType
.
Niektóre kampanie wideo mają podtypy, które ograniczają rodzaje reklam
obsługiwanych w ramach tej kampanii. Chodzi konkretnie o tylko kampanie VIDEO_ACTION
obsługują typ reklamy VIDEO_RESPONSIVE
i kampanie (VIDEO_NON_SKIPPABLE
)
obsługują tylko typ reklamy NON_SKIPPABLE_INSTREAM_VIDEO_AD
.
Najlepszym sposobem prowadzenia kampanii określonych typów jest stosowanie
klauzula withCondition
w selektorze. 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ą się wyświetlać przed innymi filmami, w ich trakcie lub po nich, co daje użytkownicy mogą pominąć reklamę po upływie określonego czasu. Reklamy wideo Discovery wyświetlają się: w sieci reklamowej i na różnych stronach YouTube. Będą one odtwarzane tylko wtedy, gdy użytkownik najpierw aktywnie kliknie miniaturę reklamy. Bumpery reklamowe mogą trwać maksymalnie 6 sekund i mogą się wyświetlać w filmach w YouTube, w witrynach i aplikacjach partnerów na w sieci reklamowej. Szczegółowe informacje na temat każdego z tych typów reklam znajdziesz w artykule Informacje formatów reklam wideo.
Utwórz grupę reklam
Tworzysz grupę reklam wideo w sekcji
newVideoAdGroupBuilder()
kampanii wideo. Musisz określić typ grupy reklam i reklamę
nazwa grupy podczas tworzenia grupy reklam. Grupa reklam musi być jedną z
następujące dane i nie można ich zmienić po utworzeniu grupy reklam:
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 zwykle muszą odwoływać się do zasobu wideo. Określa, który film
która zostanie odtworzona w przypadku reklamy. Nie możesz przesłać filmu za pomocą skryptów, ale możesz
połączyć w reklamach filmy przesłane wcześniej przez Ciebie do YouTube.
W tym celu należy utworzyć
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();
Utwórz reklamę
Aby utworzyć nową reklamę, użyj metody kreatora pasującej do typu grupy reklam
(ciąg znaków 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 trafnych ustawień kierowania.
VideoCampaignTargeting
reprezentuje wszelkie ustawienia kierowania w kampaniach wideo na poziomie konta.
i jest używany przy użyciu AdsApp.videoCampaignTargeting()
. Ten
nie można modyfikować za pomocą skryptów, ale można je wyświetlić.
Drugi typ kierowania pozwala określić kryteria kampanii wideo.
i grup reklam wideo. Możesz to zrobić za pomocą
videoTargeting()
w kampanii lub grupie reklam i zapewnia dostęp do:
selektory i narzędzia do tworzenia zarówno pozytywnych, jak i negatywnych kryteriów dla wszystkich typów
odpowiednich do danego poziomu kierowania.
AdsApp.videoTargeting()
pozwala też wyświetlać kryteria na poziomie konta i uwzględnia
inny zestaw kryteriów z listy AdsApp.videoCampaignTargeting()
. Polub
VideoCampaignTargeting
, nie możesz zarządzać tymi kryteriami za pomocą skryptów.
Oto przykład wykluczania określonego miejsca docelowego w kampanii:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
Kryteria dla danych demograficznych (wiek, płeć) działają trochę inaczej niż
innych typów kryteriów. Po utworzeniu nowej grupy reklam kryteria dla każdej z nich
wartości wieku i płci są tworzone automatycznie, a grupa reklam
są kierowane
na wszystkie z nich. Możesz wykluczyć grupę demograficzną, pobierając
i wywoływać w nim metodę exclude()
. Możesz też ponownie dodać parametr
wykluczoną grupę demograficzną, znajdując dotychczasowe kierowanie wykluczające i wywołując połączenia.
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();
}