Anzeigentypen

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.