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

Mit Scripts können Anzeigen mit der Methode newAd() für AdGroup-Instanzen erstellt werden. Dadurch 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();

Prüfung

Einige Informationen, die mit allen Anzeigentypen verknüpft sind, sind sofort über eine Ad verfügbar, z. B. die ID und der Freigabestatus einer Anzeige. Außerdem kann jede Anzeige pausiert, aktiviert oder entfernt werden.

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

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

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 Typ aufzurufen, führt das zu einem Fehler, der die Ausführung des Skripts beendet. Daher ist es wichtig, typspezifische Felder nur aufzurufen, wenn der Typ einer Anzeige bekannt ist.

Das folgende Snippet zeigt, wie Sie mit der Methode Ad.isType() feststellen, ob eine Anzeige vom richtigen Typ ist:

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

Berichte

Mit der ad_group_ad-Ansicht können Sie neben regulären Statistiken auch typspezifische Anzeigenfelder wie ad_group_ad.expanded_text_ad.headline_part1 abfragen. 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 zum Erstellen von Berichten in Scripts finden Sie im Leitfaden zu Berichten.