Videokampagnen

Mit Google Ads-Scripts können Sie Ihre YouTube-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. Videokampagnen können jedoch nicht mithilfe von Scripts erstellt werden.

Videokampagnen und Anzeigengruppen abrufen

Videokampagnen sind über die videoCampaigns-Sammlung eines AdsApp-Objekts verfügbar. Sie können sie wie gewohnt in Scripts 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 auch die Methode AdsApp.videoAdGroups() 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 newVideoAd() von VideoAdGroup erstellen.

Videoanzeigenformate

Die unterstützten Videoanzeigenformate unterscheiden sich je nach Art der Videokampagne. Damit Sie die richtige Art von Videokampagne auswählen, fügen Sie withCondition einen Verweis auf AdvertisingChannelSubType hinzu.

Einige Videokampagnen haben Untertypen, die die Art der Anzeigen einschränken, die in dieser Kampagne unterstützt werden. Konkret wird bei VIDEO_ACTION-Kampagnen nur der Anzeigentyp VIDEO_RESPONSIVE und bei VIDEO_NON_SKIPPABLE-Kampagnen nur der Anzeigentyp NON_SKIPPABLE_INSTREAM_VIDEO_AD unterstützt.

Wenn Sie bestimmte Kampagnentypen auswählen möchten, sollten Sie in Ihrer Auswahl eine withCondition-Klausel verwenden. Sie können die AdvertisingChannelSubType für den gewünschten Kampagnentyp aktualisieren:

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
  .get();

Für 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 dann die Möglichkeit, sie nach einer bestimmten Zeit zu überspringen. Video Discovery-Anzeigen werden im Displaynetzwerk und auf verschiedenen YouTube-Seiten ausgeliefert. Sie werden nur abgespielt, wenn ein Nutzer zuerst aktiv auf das Thumbnail der Anzeige klickt. Bumper-Anzeigen haben eine Länge von maximal 6 Sekunden und können in YouTube-Videos sowie in Videos auf Partnerwebsites und in Apps im Displaynetzwerk ausgeliefert werden. Ausführliche Informationen zu den einzelnen Anzeigentypen finden Sie unter Videoanzeigenformate.

Anzeigengruppe erstellen

Sie erstellen eine Videoanzeigengruppe über die newVideoAdGroupBuilder()-Methode einer Videokampagne. Beim Erstellen einer Anzeigengruppe müssen Sie einen Anzeigengruppentyp und einen Anzeigengruppennamen angeben. Der Anzeigengruppentyp muss einer der folgenden Typen 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ür VIDEO_ACTION-Kampagnen)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (nur für VIDEO_NON_SKIPPABLE-Kampagnen)

Beispiel:

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

Video-Asset erstellen

Videoanzeigen müssen in der Regel auf ein Video-Asset verweisen. Damit wird festgelegt, welches Video für die Anzeige wiedergegeben wird. Sie können keine Videos mithilfe von Scripts hochladen. Sie können jedoch ein vorhandenes YouTube-Video verknüpfen, das Sie zuvor für die Verwendung in Ihren Anzeigen hochgeladen haben. Dazu erstellen Sie eine Asset mit dem Befehl 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 Anzeigengruppentyp entspricht (nach newVideoAd() angehängt):

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

Für Videokampagnen gibt es zwei Arten von relevantem Targeting. VideoCampaignTargeting steht für alle Ausrichtungen, die für Videokampagnen allgemein auf Kontoebene vorgenommen werden. Sie wird über AdsApp.videoCampaignTargeting() aufgerufen. Dieser Wert kann nicht über Scripts geändert, aber eingesehen werden.

Bei der anderen Art des Targetings können Sie Kriterien für Videokampagnen und Videoanzeigengruppen einzeln festlegen. Sie können mit der Methode videoTargeting() auf die Kampagne oder Anzeigengruppe zugreifen. Dort finden Sie Auswahltools und Tools zum Erstellen sowohl positiver als auch auszuschließender Kriterien für alle Typen, die für diese Ausrichtungsebene gelten. Mit der Methode AdsApp.videoTargeting() können Sie auch Kriterien auf Kontoebene aufrufen. Sie enthält eine andere Reihe von Kriterien als AdsApp.videoCampaignTargeting(). Wie bei VideoCampaignTargeting können Sie diese Kriterien nicht mit Scripts verwalten.

Hier ein Beispiel für den Ausschluss eines bestimmten Placements in einer Kampagne:

videoCampaign.videoTargeting().newPlacementBuilder()
    .withUrl("http://www.example.com")
    .exclude();

Demografische Kriterien (Alter, Geschlecht) funktionieren etwas anders als die anderen Kriterientypen. Wenn eine neue Anzeigengruppe erstellt wird, werden automatisch Kriterien für jeden möglichen Wert für Alter und Geschlecht erstellt. Die Anzeigengruppe wird dann auf alle diese Kriterien ausgerichtet. Sie können eine demografische Gruppe ausschließen, indem Sie das vorhandene Targeting abrufen und die Methode exclude() darauf aufrufen. Sie können eine ausgeschlossene demografische Gruppe wieder einschließen, indem Sie das vorhandene Ausschluss-Targeting 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();
}