In Google Ads werden zahlreiche Anzeigentypen unterstützt, etwa Text-, Bild- und mobile Anzeigen. In diesem Leitfaden wird beschrieben, wie Sie mithilfe von Google Ads-Skripts Anzeigen erstellen und abrufen sowie Berichte dazu generieren. Eine Übersicht der Anzeigentypen, die in Google Ads unterstützt werden, finden Sie im API-Leitfaden.
Erstellung
Skripts können Anzeigen mit der Methode newAd()
auf AdGroup
-Instanzen erstellen. Es wird ein AdBuilderSpace
zurückgegeben, mit dem Builder für unterstützte Anzeigentypen erstellt werden.
Mit dem folgenden Snippet wird eine erweiterte Textanzeige erstellt:
let adOperation = adGroup.newAd().expandedTextAdBuilder()
.withHeadlinePart1("First headline part")
.withHeadlinePart2("Second headline part")
.withDescription("Ad description")
.withFinalUrl("http://www.example.com")
.withPath1("path1") // optional
.withPath2("path2") // optional
.build();
Inspektion
Einige mit allen Anzeigentypen verknüpfte Informationen sind sofort aus einem Ad
verfügbar, z. B. die Anzeigen-ID und der Freigabestatus. Außerdem kann jede Anzeige pausiert, aktiviert oder entfernt werden.
Wenn Sie auf spezielle Felder für den Anzeigentyp zugreifen möchten, z. B. die Beschreibung einer erweiterten Textanzeige, erstellen Sie mit der Methode asType()
eine AdViewSpace
.
So erhalten Sie Zugriff auf eine erweiterte Version von Ad
, die typspezifische Methoden zur Verfügung stellt.
Mit dem folgenden Snippet wird die Beschreibung jeder erweiterten Textanzeige abgerufen:
const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
let ad = iterator.next();
let expandedTextAd = ad.asType().expandedTextAd();
let description = expandedTextAd.getDescription();
}
Mit der Bedingung Type = EXPANDED_TEXT_AD
wird sichergestellt, dass jede Anzeige des Listeners eine erweiterte Textanzeige ist. Wenn Sie versuchen, eine Anzeige mit einem falschen Typ aufzurufen, führt dies zu einem Fehler, der die Ausführung des Skripts unterbricht. Daher sollten Sie typspezifische Felder nur dann aufrufen, wenn der Typ einer Anzeige bekannt ist.
Mit dem folgenden Snippet wird mithilfe der Methode Ad.isType()
ermittelt, ob eine Anzeige den richtigen Typ hat:
if (ad.isType().expandedTextAd()) {
let expandedTextAd = ad.asType().expandedTextAd();
let headlinePart1 = expandedTextAd.getHeadlinePart1();
let headlinePart2 = expandedTextAd.getHeadlinePart2();
}
Berichterstellung
Die Ansicht ad_group_ad
kann zusätzlich zu normalen Statistiken wie ad_group_ad.expanded_text_ad.headline_part1
auch zum Abfragen typspezifischer Anzeigenfelder verwendet werden.
Mit dem folgenden Snippet werden die Statistiken für alle erweiterten Textanzeigen abgerufen, bei denen der erste Anzeigentitel den Text "Discount Sales" enthält:
const results = AdsApp.search(
"SELECT ad_group_ad.ad_group.id, " +
"ad_group_ad.id, " +
"ad_group_ad.expanded_text_ad.headline_part1, " +
"ad_group_ad.expanded_text_ad.headline_part2, " +
"metrics.clicks, " +
"metrics.impressions, " +
"metrics.cost" +
"FROM ad_group_ad " +
"WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
"AND segments.date DURING LAST_7_DAYS");
while (results.hasNext()) {
let row = results.next();
let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
...
}
Weitere Informationen zur Berichterstellung in Skripts finden Sie im Leitfaden zu Berichten.