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

Scripts können mit der Methode newAd() Anzeigen in AdGroup-Instanzen erstellen. Dadurch wird ein AdBuilderSpace zurückgegeben, mit dem Tools zur Anzeigenerstellung 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();

Prüfung

Einige Informationen zu allen Anzeigentypen können sofort in einem Ad abgerufen werden, z. B. die ID und der Freigabestatus einer Anzeige. Außerdem können Anzeigen pausiert, aktiviert oder entfernt werden.

Wenn Sie auf spezifische Felder für den Anzeigentyp zugreifen möchten, z. B. auf die Beschreibung einer erweiterten Textanzeige, verwenden Sie die Methode asType(), um ein AdViewSpace zu erstellen. Dadurch erhalten Sie Zugriff auf eine erweiterte Version der Ad, die typspezifische Methoden bereitstellt.

Im 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();
}

Die Bedingung Type = EXPANDED_TEXT_AD sorgt dafür, dass jede Anzeige aus dem Iterator eine erweiterte Textanzeige ist. Wenn Sie versuchen, eine Anzeige mit einem falschen Anzeigentyp aufzurufen, führt dies zu einem Fehler, der die Ausführung Ihres Skripts stoppt. Daher ist es wichtig, typspezifische Felder nur zu sehen, wenn der Typ der Anzeige bekannt ist.

Im folgenden Snippet wird gezeigt, wie mithilfe der Methode Ad.isType() ermittelt wird, ob eine Anzeige den richtigen Typ hat:

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

Berichte

In der Ansicht ad_group_ad können Sie neben den üblichen Statistiken auch spezifische Anzeigenfelder abfragen, z. B. ad_group_ad.expanded_text_ad.headline_part1. 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 zu Berichten in Scripts finden Sie im Leitfaden zu Berichten.