Videokampagnen

Mit Google Ads-Scripts können Sie Ihre Videokampagnen auf YouTube verwalten und Berichte dazu erstellen. Mit Scripts können Sie vorhandene Videokampagnen verwalten, Anzeigengruppen und Anzeigen erstellen und verwalten, das Targeting von Kampagnen einrichten und Berichte erstellen. Videokampagnen können jedoch nicht mit Scripts erstellt werden.

Videokampagnen und ‑anzeigengruppen abrufen

Videokampagnen sind über die videoCampaigns Sammlung eines AdsApp Objekts verfügbar. Sie können sie so abrufen, wie Sie sonst auch Kampagnen 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 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 videoAds() Methode von VideoAdGroup abrufen. Neue Videoanzeigen können Sie mit der newVideoAd() Methode von VideoAdGroup erstellen.

Videoanzeigenformate

Die unterstützten Videoanzeigenformate variieren je nach Art der Videokampagne. Damit Sie die richtige Art von Videokampagne auswählen, fügen Sie einen withCondition-Aufruf für AdvertisingChannelSubType hinzu.

Einige Videokampagnen haben Untertypen, die die Arten von Anzeigen einschränken, die in dieser Kampagne unterstützt werden. Konkret unterstützen VIDEO_ACTION-Kampagnen nur den Anzeigentyp VIDEO_RESPONSIVE und VIDEO_NON_SKIPPABLE-Kampagnen nur den Anzeigentyp NON_SKIPPABLE_INSTREAM_VIDEO_AD.

Die beste Möglichkeit, bestimmte Kampagnentypen zu bearbeiten, ist die Verwendung einer withCondition-Anweisung im Selector. Sie können den 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 einer withCondition-Anweisung 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 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 wiedergegeben, wenn ein Nutzer zuerst aktiv auf das Anzeigen-Thumbnail klickt. Bumper-Anzeigen sind maximal 6 Sekunden lang und können in Videos auf YouTube oder in Videos auf Websites von Partnern und in Apps im Displaynetzwerk ausgeliefert werden. Ausführliche Informationen zu den einzelnen Anzeigentypen finden Sie im Hilfeartikel Videoanzeigenformate.

Anzeigengruppe erstellen

Sie erstellen eine Videoanzeigengruppe mit der newVideoAdGroupBuilder() Methode 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:

  • VIDEO_BUMPER
  • VIDEO_EFFICIENT_REACH
  • VIDEO_NON_SKIPPABLE_IN_STREAM (nur für VIDEO_NON_SKIPPABLE-Kampagnen)
  • VIDEO_RESPONSIVE (nur für VIDEO_ACTION-Kampagnen)
  • VIDEO_TRUE_VIEW_IN_DISPLAY
  • VIDEO_TRUE_VIEW_IN_STREAM
  • YOUTUBE_AUDIO

Beispiel:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("VIDEO_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 Scripts 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 die Builder-Methode, die dem Anzeigengruppentyp entspricht (verkettet nach newVideoAd()), um eine neue Anzeige zu erstellen:

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 des relevanten Targeting für Videokampagnen. Das VideoCampaignTargeting steht für das Targeting auf Kontoebene für Videokampagnen im Allgemeinen. Es wird über AdsApp.videoCampaignTargeting() aufgerufen. Diese Einstellung kann nicht mit Scripts geändert, aber aufgerufen 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 Selectors und Builder für positive und negative Kriterien für alle Typen, die für diese Targeting-Ebene 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 Scripts verwalten.

Hier ein Beispiel für das Ausschließen 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 Geschlechtswert erstellt und die Anzeigengruppe wird auf alle ausgerichtet. Sie können demografische Merkmale ausschließen, indem Sie das vorhandene Targeting abrufen und die Methode exclude() dafür aufrufen. Sie können ausgeschlossene demografische Merkmale wieder einbeziehen, indem Sie das vorhandene Ausschluss-Targeting suchen und include() aufrufen.

Hier ein Beispiel für das Ausschließen 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();
}