Videokampagnen

Mit Google Ads-Skripts können Sie Ihre YouTube-basierten Videokampagnen verwalten und Berichte dazu erstellen. Sie können Skripts verwenden, um bestehende Videokampagnen zu verwalten, Anzeigengruppen und Anzeigen zu erstellen und zu verwalten, die Ausrichtung für Kampagnen einzurichten und Berichte zu erstellen. Skripts können jedoch nicht zum Erstellen von Videokampagnen verwendet werden.

Videokampagnen und -anzeigengruppen abrufen

Videokampagnen sind über die videoCampaigns-Sammlung eines AdsApp-Objekts verfügbar. Sie können sie wie gewohnt in Skripts 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-Skripts können Sie Ihre Videoanzeigen über die Methode videoAds() von VideoAdGroup abrufen. Sie können neue Videoanzeigen mit der Methode newVideoAd() von VideoAdGroup erstellen.

Videoanzeigenformate

Welche Videoanzeigenformate unterstützt werden, hängt vom Typ der Videokampagne ab. Damit Sie die richtige Art von Videokampagne auswählen, sollten Sie einen withCondition-Anruf für AdvertisingChannelSubType hinzufügen.

Einige Videokampagnen haben Untertypen, mit denen die unterstützten Anzeigentypen eingeschränkt werden. VIDEO_ACTION-Kampagnen unterstützen nur den Anzeigentyp VIDEO_RESPONSIVE und VIDEO_NON_SKIPPABLE-Kampagnen nur den Anzeigentyp NON_SKIPPABLE_INSTREAM_VIDEO_AD.

Für bestimmte Kampagnentypen ist es am besten, eine withCondition-Klausel in der Auswahl zu verwenden. 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-Anzeigen
  • TrueView Video Discovery
  • Bumper

Sie können diese Kampagnen mithilfe von withCondition auswählen:

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

In-Stream-Videoanzeigen können vor, während oder nach anderen Videos wiedergegeben werden. Nutzer haben so 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 YouTube-Videos sowie in Videos auf Websites und in Apps von Partnern im Displaynetzwerk ausgeliefert werden. Weitere Informationen zu den einzelnen Anzeigentypen finden Sie unter Videoanzeigenformate.

Anzeigengruppe erstellen

Sie erstellen eine Videoanzeigengruppe mithilfe der 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ü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 sich in der Regel auf ein Video-Asset beziehen. Damit wird festgelegt, welches Video für die Anzeige abgespielt wird. Es ist nicht möglich, Videos mithilfe von Skripts hochzuladen. Sie haben aber die Möglichkeit, ein vorhandenes YouTube-Video zu verknüpfen, das Sie zuvor hochgeladen haben, um es in Ihren Anzeigen zu verwenden. Dazu erstellen Sie mit YouTubeVideoAssetBuilder ein Asset.

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 (verkettet nach newVideoAd()):

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 verschiedene Arten der relevanten Ausrichtung. Der VideoCampaignTargeting steht für die Ausrichtung auf Kontoebene für Videokampagnen im Allgemeinen. Der Zugriff erfolgt über AdsApp.videoCampaignTargeting(). Dieser kann nicht mithilfe von Skripts geändert, sondern nur eingesehen werden.

Bei dem anderen Ausrichtungstyp können Sie Kriterien für Videokampagnen und Videoanzeigengruppen einzeln angeben. Sie können mit der Methode videoTargeting() auf der Kampagne oder Anzeigengruppe darauf zugreifen. Sie ermöglicht den Zugriff auf Auswahl- und Erstellungstools für positive und negative Kriterien für alle Typen, die auf diese Targeting-Ebene anwendbar sind. Mit der Methode AdsApp.videoTargeting() lassen sich Kriterien auch auf Kontoebene aufrufen. Sie umfasst andere Kriterien als AdsApp.videoCampaignTargeting(). Wie bei VideoCampaignTargeting können Sie diese Kriterien nicht mit Skripts verwalten.

Hier sehen Sie 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. Beim Erstellen einer neuen Anzeigengruppe werden automatisch Kriterien für jeden möglichen Wert für Alter und Geschlecht erstellt, und die Anzeigengruppe wird dann auf alle Kriterien ausgerichtet. Sie können ein demografisches Merkmal ausschließen, indem Sie das vorhandene Targeting abrufen und dafür die Methode exclude() aufrufen. Sie können ein ausgeschlossenes demografisches Merkmal wieder einschließen, indem Sie das vorhandene ausschließende Targeting suchen und include() aufrufen.

Hier sehen Sie 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();
}