Mit Google Ads-Scripts können Sie Ihre YouTube-basierten Videokampagnen verwalten und Berichte dazu erstellen. Mit Scripts können Sie vorhandene Videokampagnen verwalten, Anzeigengruppen und Anzeigen erstellen und verwalten, das Targeting für Kampagnen einrichten und Berichte erstellen. Sie können jedoch keine Skripts verwenden, um Videokampagnen zu erstellen.
Videokampagnen und ‑anzeigengruppen abrufen
Videokampagnen sind über die Sammlung videoCampaigns
eines AdsApp
-Objekts verfügbar. Sie können sie wie gewohnt abrufen:
const campaignName = "My first video campaign";
const campaignIterator = AdsApp.videoCampaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
for (const campaign of campaignIterator) {
...
}
Nachdem Sie eine Kampagne abgerufen haben, können Sie zum Abrufen der zugehörigen Anzeigengruppen ähnlich vorgehen:
const adGroupIterator = campaign.videoAdGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
Alternativ können Sie die AdsApp.videoAdGroups()
-Methode verwenden:
const adGroupIterator = AdsApp.videoAdGroups()
.withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
.get();
for (const adGroup of adGroupIterator) {
...
}
Videoanzeigen erstellen
Mit Google Ads-Scripts können Sie Ihre Videoanzeigen mit der Methode videoAds()
von VideoAdGroup
abrufen.
Sie können neue Videoanzeigen mit der Methode VideoAdGroup
newVideoAd()
erstellen.
Videoanzeigenformate
Die unterstützten Videoanzeigenformate variieren je nach Videokampagnentyp. Damit Sie den richtigen Videokampagnentyp auswählen, fügen Sie einen withCondition
-Aufruf in AdvertisingChannelSubType
ein.
Einige Videokampagnen haben Untertypen, die die Arten von Anzeigen einschränken, die in der Kampagne unterstützt werden. Konkret werden in VIDEO_ACTION
-Kampagnen nur VIDEO_RESPONSIVE
-Anzeigen und in VIDEO_NON_SKIPPABLE
-Kampagnen nur NON_SKIPPABLE_INSTREAM_VIDEO_AD
-Anzeigen unterstützt.
Die beste Methode, um bestimmte Kampagnentypen zu bearbeiten, ist die Verwendung einer withCondition
-Klausel in der Auswahl. Sie können die AdvertisingChannelSubType
für den gewünschten Kampagnentyp aktualisieren:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
.get();
In Videokampagnen ohne Untertyp werden die folgenden Videoanzeigenformate unterstützt:
- TrueView In-Stream
- TrueView Video Discovery
- Bumper
Sie können diese Kampagnen mit einem withCondition
auswählen:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = null")
.get();
In-Stream-Videoanzeigen können vor, während oder nach anderen Videos ausgeliefert werden. Nutzer haben nach einer bestimmten Zeit die Möglichkeit, sie zu überspringen. Video Discovery-Anzeigen werden im Displaynetzwerk und auf verschiedenen YouTube-Seiten präsentiert. Sie werden nur abgespielt, wenn ein Nutzer zuerst aktiv auf das Anzeigen-Thumbnail klickt. Bumper-Anzeigen sind höchstens 6 Sekunden lang und können in YouTube-Videos oder in Videos auf Websites und in Apps von Partnern im Displaynetzwerk ausgeliefert werden. Weitere Informationen zu Videoanzeigenformaten
Anzeigengruppe erstellen
Sie erstellen eine Videoanzeigengruppe über die Methode newVideoAdGroupBuilder()
einer Videokampagne. Beim Erstellen der Anzeigengruppe müssen Sie einen Anzeigengruppentyp und einen Anzeigengruppennamen angeben. Der Anzeigengruppentyp muss einer der folgenden sein und kann nach dem Erstellen der Anzeigengruppe nicht mehr geändert werden:
TRUE_VIEW_IN_STREAM
TRUE_VIEW_IN_DISPLAY
BUMPER
VIDEO_RESPONSIVE
(nur fürVIDEO_ACTION
-Kampagnen)NON_SKIPPABLE_INSTREAM_VIDEO_AD
(nur fürVIDEO_NON_SKIPPABLE
-Kampagnen)
Beispiel:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("TRUE_VIEW_IN_STREAM")
.withName("Video Ad Group")
.build()
.getResult();
Video-Asset erstellen
In Videoanzeigen muss in der Regel auf ein Video-Asset verwiesen werden. Damit wird festgelegt, welches Video für die Anzeige wiedergegeben wird. Sie können kein Video mithilfe von Skripts hochladen, aber ein vorhandenes YouTube-Video verknüpfen, das Sie zuvor hochgeladen haben, um es in Ihren Anzeigen zu verwenden.
Dazu erstellen Sie ein Asset
mit dem 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();
Anzeige erstellen
Verwenden Sie zum Erstellen einer neuen Anzeige die Builder-Methode, die dem Anzeigruppentyp entspricht (verkettet nach newVideoAd()
):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(nur fürVIDEO_ACTION
-Kampagnen)nonSkippableAdBuilder()
(nur fürVIDEO_NON_SKIPPABLE
-Kampagnen)
Beispiel:
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();
Video-Targeting
Es gibt zwei verschiedene Arten der relevanten Ausrichtung für Videokampagnen. Die VideoCampaignTargeting
steht für die Ausrichtung, die auf Kontoebene für Videokampagnen im Allgemeinen erfolgt. Sie wird über AdsApp.videoCampaignTargeting()
aufgerufen. Diese Einstellung kann nicht über Skripts geändert, aber angezeigt werden.
Beim anderen Targeting-Typ können Sie Kriterien für Videokampagnen und Videoanzeigengruppen individuell festlegen. Sie können mit der Methode videoTargeting()
auf die Kampagne oder Anzeigengruppe zugreifen. Damit erhalten Sie Zugriff auf Selektoren und Builder für positive und negative Kriterien für alle Typen, die für diese Ausrichtungsebene gelten. Die Methode AdsApp.videoTargeting()
ist auch verfügbar, um Kriterien auf Kontoebene aufzurufen. Sie umfasst eine andere Gruppe von Kriterien als AdsApp.videoCampaignTargeting()
. Wie bei VideoCampaignTargeting
können Sie diese Kriterien nicht mit Skripts verwalten.
Hier ein Beispiel für den Ausschluss eines bestimmten Placements in einer Kampagne:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
Kriterien für demografische Merkmale (Alter, Geschlecht) funktionieren etwas anders als die anderen Kriterientypen. Wenn eine neue Anzeigengruppe erstellt wird, werden automatisch Kriterien für jeden möglichen Alters- und Geschlechterwert erstellt und die Anzeigengruppe wird auf alle ausgerichtet. Sie können demografische Merkmale ausschließen, indem Sie die vorhandene Ausrichtung abrufen und die Methode exclude()
darauf aufrufen. Sie können ausgeschlossene demografische Merkmale wieder einbeziehen, indem Sie die vorhandene Ausschlussausrichtung suchen und include()
aufrufen.
Hier ein Beispiel für den Ausschluss eines bestimmten Geschlechts aus einer Anzeigengruppe:
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}